Configura tu primer agente

De una instalación fresca a un agente de inteligencia artificial. Las dos partes más principiantes que faltan están en la parte superior: cómo AgentsRoom se relaciona con la AI CLIs, y cómo iniciar sesión.

Cómo funciona AgentsRoom (leer esto primero)

AgentsRoom es la cabina. Los motores son el AI CLIs (Claude Code, Codex, OpenCode, Gemini, Aider). Inicia sesión en los motores una vez a través de su propio comando, entonces AgentsRoom los conduce visualmente. AgentsRoom nunca almacena ni ve sus fichas, API key o ChatGPT contraseña: aquellos que permanecen dentro de cada CLI almacenamiento seguro propio en su 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

✓macOS 14+ (Sonoma o posterior)
✓
Al menos una codificación AI CLI instalada (Claude, Codex, OpenCode, Gemini CLI o Aider)
npm install -g @anthropic-ai/claude-code
✓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

Obras con

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

1. Instala

npm install -g @anthropic-ai/claude-code

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ías ver un aviso 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

Obras con

ChatGPT Además, Pro, Equipo o Empresa, o OpenAI API key.

1. Instala

npm install -g @openai/codex

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

OpenCodeTraiga a su propio proveedor

Obras con

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

1. Instala

npm install -g opencode-ai

2. Iniciar sesión

Ejecutar código abierto auth login y seguir los avisos para agregar una clave de proveedor.

3. Verificar

Gemini CLI (Google)Tier gratis disponible

Obras con

Una cuenta Google (gratuito disponible) o Gemini API key.

1. Instala

npm install -g @google/gemini-cli

2. Iniciar sesión

Corre gemini una vez. Una ventana del navegador se abre para el registro Google.

3. Verificar

AiderUsuarios de energía

Obras con

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

1. Instala

pip install aider-chat

2. Iniciar sesión

Sin comando de inicio de sesión. Establecer su API key como una variable de entorno en su perfil de concha, por ejemplo: exportar ANTHROPIC API KEY=sk-...

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

Descargue el archivo .dmg, abra y arrastre AgentsRoom a su carpeta Aplicaciones. Lance desde Spotlight o la carpeta Aplicaciones.

Tip: AgentsRoom auto-checks para actualizaciones. 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 mapa 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 papel (Fullstack es un buen comienzo), luego un proveedor (el motor que estableció en el paso 0), entonces un modelo (Sonnet es recomendado para Claude). Opcionalmente escriba un aviso inicial y haga clic en Lanzamiento. El terminal abre y dirige el CLI para usted.

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

Mira cómo funciona

La terminal muestra la salida en vivo: cada archivo leído, cada edición. Cambios de estado: pensamiento, codificación, hecho. Usted obtiene una notificación macOS 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 ganchos. 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.Proyectos de grupo 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 macOS para que pueda multitarea 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 el CLI no está firmado. Abra un terminal regular (Terminal.app), ejecute el comando CLI solo (claude, codex, gemini, opencode), complete el registro del navegador, luego vuelva a AgentsRoom y vuelva a lanzar el agente. AgentsRoom no tiene su propia pantalla de inicio de sesión: la auth vive en el CLI.

comando not found: claude (or codex, gemini, etc.)

El CLI no está instalado, o su shell PATH no lo ve. Reaccione el comando de instalación desde el paso 0 arriba. Si utiliza nvm, instale el CLI con la misma versión Nodo que utiliza día a día, de lo contrario el binario no estará en PATH cuando AgentsRoom lanza.

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

Por diseño. AgentsRoom es una UI en la parte superior de CLIs y nunca maneja sus credenciales directamente. El registro se realiza una vez dentro de la CLI (correr claude o codex en una terminal), entonces AgentsRoom utiliza esa sesión. Esto es lo que hace AgentsRoom más seguro que las herramientas que interceptan tus fichas.

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 o OpenAI a veces prospera o expira las sesiones en silencio.

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 "no encontrado"

AgentsRoom hereda su PATH de su shell de inicio de sesión, no de su terminal interactivo. Quit AgentsRoom completamente, abra una nueva terminal, verifique que el CLI se puede llamar desde una sesión de shell fresca (que claude), luego relanzar AgentsRoom.