Configura tu primer agente

De una instalación nueva a un agente de IA que funciona. Las dos partes que más se les escapan a los principiantes están arriba: cómo se relaciona AgentsRoom con los CLI de IA, y cómo iniciar sesión.

Cómo funciona AgentsRoom (leer esto primero)

AgentsRoom es la cabina. Los motores son los CLI de IA (Claude, Codex, GitHub Copilot CLI, Cursor y otros 15 CLI de agente). Inicias sesión en los motores una sola vez con su propio comando y luego AgentsRoom los maneja visualmente. AgentsRoom nunca almacena ni ve tus tokens, API keys o tu contraseña de ChatGPT: se quedan en el almacenamiento seguro propio de cada CLI, en tu máquina.

No hay ningún botón "Log in to ChatGPT" o "Log in to Anthropic" dentro de AgentsRoom por diseño. El login vive en el CLI que instalas en el paso 0 abajo.

Antes de empezar

✓Windows 10+, macOS 14+ (Sonoma) o una distribución de Linux moderna de 64 bits
✓
Al menos un CLI de programación con IA instalado (Claude, Codex, GitHub Copilot CLI, Cursor o cualquiera de los otros 15 CLI de agente que AgentsRoom soporta)
curl -fsSL https://claude.ai/install.sh | bash
✓Una suscripción activa o API key para su proveedor elegido

Paso 0: instalar y iniciar sesión en su motor AI

Elija un proveedor para comenzar (puede agregar más tarde). Para cada uno: instalar el CLI, ejecutarlo una vez para iniciar sesión, verificar que funciona. Luego salta al paso 1.

Haga clic en un proveedor para ampliar sus pasos de configuración.

Claude (Anthropic)Recomendado para usuarios de primera hora

Funciona con

Claude Pro, Claude Max, o un Anthropic API key.

1. Instala

curl -fsSL https://claude.ai/install.sh | bash

2. Iniciar sesión

Corre claude una vez en cualquier terminal. Una ventana del navegador se abre para iniciar sesión con su cuenta Anthropic.

3. Verificar

Ejecute el comando de instalación arriba, luego ejecute el nombre de CLI solo en su terminal (por ejemplo, "claude" y pulse enter). Debería ver un mensaje de bienvenida. Escriba "hola" y pulse enter: si obtiene una respuesta, está listo para usarlo dentro de AgentsRoom.

Codex (OpenAI / ChatGPT)Utilice su cuenta ChatGPT

Funciona con

ChatGPT Plus, Pro, Team o Enterprise, o una OpenAI API key.

1. Instala

curl -fsSL https://chatgpt.com/codex/install.sh | sh

2. Iniciar sesión

Ejecutar codex una vez en cualquier terminal. Se abre una ventana del navegador. Inicia sesión con tu cuenta ChatGPT, la misma que utilizas en chatgpt.com.

3. Verificar

Antigravity CLI (Google)Nivel gratuito disponible

Funciona con

Una cuenta de Google (inicio de sesión en el navegador). Hay disponible un nivel gratuito generoso.

1. Instala

curl -fsSL https://antigravity.google/cli/install.sh | bash

2. Iniciar sesión

Ejecuta antigravity una vez en cualquier terminal. Se abre una ventana del navegador para iniciar sesión con Google.

3. Verificar

OpenCodeTraiga a su propio proveedor

Funciona con

Cualquier proveedor que configura: Anthropic, OpenAI, OpenRouter y más.

1. Instala

curl -fsSL https://opencode.ai/v2/install | bash

2. Iniciar sesión

Ejecute opencode y luego use su comando /connect para añadir una clave de proveedor o una suscripción a OpenCode Go.

3. Verificar

Grok Build (xAI)Contexto de 256K

Funciona con

Una cuenta de xAI (inicio de sesión en el navegador) o una clave Grok API para uso headless.

1. Instala

curl -fsSL https://x.ai/cli/install.sh | bash

2. Iniciar sesión

Ejecuta grok una vez en cualquier terminal. Se abre una ventana del navegador para iniciar sesión en xAI. Para uso headless, define en su lugar la variable de entorno GROK_CODE_XAI_API_KEY.

3. Verificar

CursorTu editor, en el terminal

Funciona con

Una cuenta de Cursor. Tu plan actual cubre la CLI; el plan gratuito llega a menos modelos.

1. Instala

curl https://cursor.com/install -fsS | bash

2. Iniciar sesión

Ejecuta cursor-agent login para iniciar sesión desde el navegador. La configuración está en ~/.cursor.

3. Verificar

oh-my-piMás de 60 backends

Funciona con

Lo que ya pagas: inicia sesión en Anthropic, OpenAI, Google, xAI, Z.ai, DeepSeek y más, o acepta una simple clave API.

1. Instala

curl -fsSL https://omp.sh/install | sh

2. Iniciar sesión

Ejecuta omp una vez y luego usa /login para conectar un proveedor. La configuración está en ~/.omp.

3. Verificar

Kimi (Moonshot AI)Hasta 1M de contexto

Funciona con

Una cuenta de Kimi (inicio de sesión en el navegador) o una clave API de la Open Platform de Moonshot AI.

1. Instala

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

2. Iniciar sesión

Ejecuta kimi una vez en cualquier terminal y luego escribe /login para iniciar sesión con tu cuenta de Kimi. La configuración está en ~/.kimi-code.

3. Verificar

FreebuffSin clave necesaria

Funciona con

Ninguna. El servicio es gratuito y se financia con anuncios de texto mostrados entre turnos.

1. Instala

npm install -g freebuff

2. Iniciar sesión

Ejecuta freebuff en tu proyecto. Existe un comando freebuff login si quieres vincular una cuenta de Codebuff.

3. Verificar

Pi (Earendil)Minimalista y extensible

Funciona con

Lo que ya pagas: Pi inicia sesión en Anthropic, OpenAI, Google, GitHub Copilot y muchos otros proveedores, o acepta una simple clave API.

1. Instala

curl -fsSL https://pi.dev/install.sh | sh

2. Iniciar sesión

Ejecuta pi una vez y luego usa /login para conectar un proveedor. La configuración está en ~/.pi/agent.

3. Verificar

DevinUn plan, muchos modelos

Funciona con

Un plan de Devin o Windsurf, incluido el gratuito. La misma suscripción cubre Claude, GPT, Gemini y los modelos SWE de Cognition.

1. Instala

curl -fsSL https://cli.devin.ai/install.sh | bash

2. Iniciar sesión

Ejecuta devin auth login para iniciar sesión desde el navegador. La configuración está en ~/.config/devin.

3. Verificar

Command CodeElige entre modelos abiertos y propietarios

Funciona con

Una cuenta de Command Code o una clave API en COMMAND_CODE_API_KEY. El acceso a los modelos y los límites de uso dependen de tu cuenta del proveedor.

1. Instala

npm install -g command-code@latest

2. Iniciar sesión

Ejecuta command-code login para iniciar sesión, o configura COMMAND_CODE_API_KEY en tu entorno. Después, ejecuta command-code en tu proyecto.

3. Verificar

Mistral VibeModelos europeos

Funciona con

Una cuenta de Mistral (Pro o Team) o una clave API de Mistral.

1. Instala

command -v uv >/dev/null 2>&1 || curl -LsSf https://astral.sh/uv/install.sh | sh; . "$HOME/.local/bin/env" 2>/dev/null; uv tool install --python 3.12 mistral-vibe

2. Iniciar sesión

Ejecuta vibe --setup una vez para guardar tu clave API de Mistral, luego ejecuta vibe para empezar. La configuración se encuentra en ~/.vibe/config.toml.

3. Verificar

Muse Code (Meta)Muse Spark en tu terminal

Funciona con

Una cuenta de Meta con acceso a Muse Code, o una clave API en META_API_KEY. Meta establece el acceso y los límites de uso.

1. Instala

curl -fsSL https://dev.meta.ai/install.sh | sh

2. Iniciar sesión

Ejecuta muse login para iniciar sesión, o configura META_API_KEY en tu entorno. Después, ejecuta muse en tu proyecto.

3. Verificar

AiderUsuarios de energía

Funciona con

Cualquier proveedor a través de API key (Anthropic, OpenAI, DeepSeek y más).

1. Instala

command -v uv >/dev/null 2>&1 || curl -LsSf https://astral.sh/uv/install.sh | sh; . "$HOME/.local/bin/env" 2>/dev/null; uv tool install --python 3.12 aider-chat

2. Iniciar sesión

Sin comando de inicio de sesión. Define tu API key como variable de entorno en el perfil de tu shell, por ejemplo: export ANTHROPIC_API_KEY=sk-...

3. Verificar

Amp (Sourcegraph)Modos, no modelos

Funciona con

Una cuenta de Amp (inicio de sesión en el navegador) o un token AMP_API_KEY.

1. Instala

curl -fsSL https://ampcode.com/install.sh | bash

2. Iniciar sesión

Ejecuta amp login una vez en cualquier terminal para iniciar sesión. Los ajustes están en ~/.config/amp.

3. Verificar

MiniMax Code (MiniMax)Modelos de la serie M

Funciona con

Una cuenta de MiniMax (inicio de sesión en el navegador) o una clave API de MiniMax.

1. Instala

curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

2. Iniciar sesión

Ejecuta mcode login --region global (o mcode login para una cuenta de China continental) en un terminal. La configuración está en ~/.minimax.

3. Verificar

ZCode (cliente comunitario)Modelos GLM, no es de Z.ai

Funciona con

Un plan de Z.ai o BigModel, o una clave API. Este cliente comunitario no está publicado ni respaldado por Z.ai.

1. Instala

npm install -g zcode-app-cli@latest

2. Iniciar sesión

Ejecuta zcode una vez en un terminal y escribe /login para iniciar sesión con tu cuenta de Z.ai o BigModel. Requiere Node.js 22.19 o posterior. La configuración está en ~/.zcode.

3. Verificar

¿Atascado en este paso? Vea la sección de solución de problemas en la parte inferior de esta página.

Descargar e instalar AgentsRoom

Descarga el instalador para tu sistema operativo: el .dmg en macOS, el .exe en Windows o el AppImage en Linux. Ábrelo, sigue los pasos de instalación y luego inicia AgentsRoom.

Tip: AgentsRoom busca actualizaciones automáticamente. Se le notificará cuando esté disponible una nueva versión.

Crea tu primer proyecto

Haga clic en el botón + en la barra lateral. Seleccione cualquier carpeta en su máquina. Aquí es donde sus agentes de IA trabajarán. Nombre su proyecto y asignarlo a una zona.

Tip: Cada proyecto corresponde a una carpeta real. Los agentes ejecutan el CLI de su proveedor elegido en ese directorio, al igual que lo haría en su terminal.

Añade tu primer agente

Dentro de su proyecto, haga clic en Agregar agente. Elija un rol (Fullstack es un buen comienzo), luego un proveedor (el motor que configuró en el paso 0) y después un modelo (Sonnet es el recomendado para Claude). Si quiere, escriba un prompt inicial y haga clic en Lanzar. La terminal se abre y ejecuta el CLI por usted.

Tip: Si el terminal se ve vacío o muestra una pantalla de inicio de sesión, el CLI del paso 0 todavía no tiene la sesión iniciada. Abra un terminal regular, ejecute claude o codex (o el comando de su proveedor) una vez, complete el inicio de sesión, luego vuelva.

Míralo trabajar

La terminal muestra la salida en vivo: cada archivo leído, cada edición. El estado cambia: trabajando, luego listo. Usted obtiene una notificación de escritorio cuando termina.

Tip: Puede lanzar múltiples agentes a la vez. Cada uno obtiene su propio terminal y funciona independientemente.

Personalice su configuración

Editar CLAUDE.md directamente desde AgentsRoom para dar a los agentes mejor contexto. Cambiar modelos, ajustar permisos, configurar hooks. Añadir más agentes con diferentes roles o proveedores.

Tip: Opus para arquitectura. Sonnet para dev. Haiku para tareas rápidas como pruebas.

Consejos y trucos

1.Utilice Opus para decisiones de arquitectura, Sonnet para codificación diaria, Haiku para tareas rápidas

2.Agrupe los proyectos por zona (Trabajo, Personal, Proyectos paralelos) para una mejor organización

3.Editar CLAUDE.md de AgentsRoom para dar a los agentes mejor contexto de proyecto

4.Activar las notificaciones de escritorio para poder hacer otras cosas mientras los agentes trabajan

5.Comience con un agente por proyecto, agregue más a medida que se sienta cómodo

Solución de problemas

Mi terminal de agente se ve vacía o atascada

La mayoría de las veces la CLI no tiene la sesión iniciada. Abre tu terminal (Terminal en macOS, PowerShell o Windows Terminal en Windows, tu emulador de terminal en Linux), ejecuta el comando de la CLI por sí solo (claude, codex, antigravity, opencode), completa el inicio de sesión en el navegador y luego vuelve a AgentsRoom para iniciar el agente de nuevo. AgentsRoom no tiene su propia pantalla de inicio de sesión: la autenticación reside en la CLI.

command not found: claude (o codex, antigravity, etc.)

El CLI no está instalado, o el PATH de tu shell no lo ve. Vuelva a ejecutar el comando de instalación del paso 0 de arriba. Si utiliza nvm, instale el CLI con la misma versión de Node que utiliza a diario; de lo contrario, el binario no estará en el PATH cuando AgentsRoom se inicie.

No veo un botón para iniciar sesión en ChatGPT o Claude dentro de AgentsRoom

Por diseño. AgentsRoom es una interfaz que funciona por encima de los CLI y nunca maneja sus credenciales directamente. El inicio de sesión se hace una vez dentro del CLI (ejecute claude o codex en una terminal) y luego AgentsRoom usa esa sesión. Esto es lo que hace que AgentsRoom sea más seguro que las herramientas que interceptan tus tokens.

Agente atrapado en "pensar"

Comprueba que tu suscripción o API key está activa para el proveedor seleccionado. Trate de ejecutar el CLI directamente en su terminal para ver el mensaje de error real: Claude u OpenAI a veces limitan o hacen expirar las sesiones sin avisar.

No hay proyectos en la barra lateral

Asegúrese de seleccionar una carpeta válida al crear el proyecto. La carpeta debe existir en el disco. Reinicie AgentsRoom si se agregó un proyecto pero aún no visible.

Instalé el CLI pero AgentsRoom todavía dice "command not found"

AgentsRoom hereda su PATH de su shell de inicio de sesión, no de su terminal interactiva. Cierre AgentsRoom por completo, abra una nueva terminal, verifique que el CLI se puede llamar desde una sesión de shell nueva (which claude) y luego vuelva a abrir AgentsRoom.