Configurar seu primeiro agente

De uma instalação recente a um agente de IA funcional. As duas partes mais iniciantes perder estão no topo: como AgentsRoom se relaciona com o AI CLIs, e como entrar.

Como funciona o AgentsRoom (leia isto primeiro)

AgentsRoom é o cockpit. O AI CLIs (Código Claude, Codex, OpenCode, Gemini, Aider, Grok Build, Mistral Vibe) são os motores. Você iniciar sessão para os motores uma vez através de seu próprio comando, em seguida, AgentsRoom conduz visualmente. AgentsRoom nunca armazena ou vê seus tokens, API keys ou ChatGPT senha: aqueles ficam dentro de cada CLI próprio armazenamento seguro em sua máquina.

Não há nenhum botão "Login para ChatGPT" ou "Login para Anthropic" dentro do AgentsRoom por design. O login vive no CLI que você instala no passo 0 abaixo.

Antes de começar

✓Windows 10+, macOS 14+ (Sonoma) ou uma distribuição Linux de 64 bits moderna
✓
Pelo menos um código de IA CLI instalado (Claude, Codex, OpenCode, Gemini CLI, Aider, Grok Build ou Mistral Vibe)
npm install -g @anthropic-ai/claude-code
✓Uma assinatura ativa ou API key para seu provedor escolhido

Passo 0: instalar e iniciar sessão no seu motor de IA

Escolha um provedor para iniciar (você pode adicionar mais tarde). Para cada um: instalar o CLI, executá-lo uma vez para iniciar sessão, verificar se funciona. Em seguida, salte para o passo 1.

Clique em um provedor para expandir suas etapas de configuração.

Claude (Anthropic)Recomendado para usuários pela primeira vez

Funciona com

Claude Pro, Claude Max, ou Anthropic API key.

1. Instalar

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

2. Assine aqui

Executar Claude uma vez em qualquer terminal. Uma janela do navegador abre para entrar com sua conta Anthropic.

3. Verificar

Execute o comando de instalação acima e, em seguida, execute o nome do CLI sozinho em seu terminal (por exemplo, digite "claude" e pressione enter). Devias ver um aviso de boas-vindas. Digite "olá" e pressione enter: se você obter uma resposta, você está pronto para usá-la dentro do AgentsRoom.

Codex (OpenAI / ChatGPT)Use sua conta ChatGPT

Funciona com

ChatGPT Além disso, Pro, Equipe ou Enterprise, ou um OpenAI API key.

1. Instalar

npm install -g @openai/codex

2. Assine aqui

Executar códice uma vez em qualquer terminal. Abre- se uma janela do navegador. Entre com sua conta ChatGPT, a mesma que você usa no chatgpt.com.

3. Verificar

OpenCodeTraga o seu próprio provedor

Funciona com

Qualquer provedor que você configurar: Anthropic, OpenAI, OpenRouter, e muito mais.

1. Instalar

npm install -g opencode-ai

2. Assine aqui

Execute o login de autenticação do código aberto e siga as instruções para adicionar uma chave de provedor.

3. Verificar

AiderUtilizadores de energia

Funciona com

Qualquer provedor via API key (Anthropic, OpenAI, DeepSeek e muito mais).

1. Instalar

pip install aider-chat

2. Assine aqui

Sem comando de login. Define o seu API key como uma variável de ambiente no seu perfil de shell, por exemplo: export ANTHROPIC API KEY=sk-...

3. Verificar

Grok Build (xAI)Contexto 256K

Funciona com

Uma conta xAI (login no navegador) ou uma Grok API key para uso headless.

1. Instalar

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

2. Assine aqui

Execute grok uma vez em qualquer terminal. Uma janela do navegador abre para login na xAI. Para uso headless, defina a variável de ambiente GROK_CODE_XAI_API_KEY em vez disso.

3. Verificar

Mistral VibeModelos europeus

Funciona com

Uma conta Mistral (Pro ou Team) ou uma chave de API Mistral.

1. Instalar

uv tool install mistral-vibe

2. Assine aqui

Execute vibe --setup uma vez para salvar sua chave de API Mistral, depois execute vibe para começar. A configuração fica em ~/.vibe/config.toml.

3. Verificar

Preso neste passo? Veja a seção de solução de problemas na parte inferior desta página.

Baixe e instale o AgentsRoom

Baixe o instalador para o seu sistema operacional: o .dmg no macOS, o .exe no Windows ou o AppImage no Linux. Abra-o, siga as etapas de instalação e, em seguida, inicie o AgentsRoom.

Tip: AgentsRoom verifica automaticamente as atualizações. Você será notificado quando uma nova versão estiver disponível.

Crie seu primeiro projeto

Clique no botão + na barra lateral. Selecione qualquer pasta em sua máquina. É aqui que os agentes da IA vão trabalhar. Nomeie o seu projeto e atribua-o a uma zona.

Tip: Cada projecto mapeia para uma pasta real. Os agentes executam o CLI do seu provedor escolhido nesse diretório, assim como você faria em seu terminal.

Adicionar o seu primeiro agente

Dentro do seu projeto, clique em Adicionar agente. Escolha uma função (Fullstack é um bom começo), então um provedor (o motor que você configurar no passo 0), então um modelo (Sonnet é recomendado para Claude). Opcionalmente escreva um prompt inicial e clique em Iniciar. O terminal abre e executa o CLI para você.

Tip: Se o terminal parecer vazio ou mostrar uma tela de login, o CLI do passo 0 ainda não está conectado. Abra um terminal regular, execute claude ou codex (ou o comando do seu provedor) uma vez, complete o login e depois volte.

Vê se funciona

O terminal mostra saída ao vivo: cada arquivo lido, cada edição. Mudanças de status: pensamento, codificação, feito. Você recebe uma notificação macOS quando termina.

Tip: Pode lançar vários agentes de uma vez. Cada um tem seu próprio terminal e funciona independentemente.

Personalizar a sua configuração

Editar CLAUDE.md diretamente do AgentsRoom para dar aos agentes um melhor contexto. Mudar modelos, ajustar permissões, configurar ganchos. Adicione mais agentes com diferentes papéis ou provedores.

Tip: Opus para arquitetura. Sonnet para dev. Haiku para tarefas rápidas como testes.

Dicas e truques

1.Use Opus para decisões de arquitetura, Sonnet para codificação diária, Haiku para tarefas rápidas

2.Agrupar projetos por zona (trabalho, pessoal, projetos laterais) para melhor organização

3.Editar o CLAUDE.md do AgentsRoom para dar aos agentes um melhor contexto de projeto

4.Activar as notificações do macOS para que possa fazer várias tarefas enquanto os agentes trabalham

5.Comece com um agente por projeto, adicione mais conforme você ficar confortável

Resolução de Problemas

Meu terminal de agente parece vazio ou preso

Na maioria das vezes, a CLI não está conectada. Abra o seu terminal (Terminal no macOS, PowerShell ou Windows Terminal no Windows, seu emulador de terminal no Linux), execute o comando da CLI sozinho (claude, codex, gemini, opencode), conclua o login no navegador e, em seguida, volte ao AgentsRoom e inicie o agente novamente. O AgentsRoom não tem uma tela de login própria: a autenticação fica na CLI.

comando não encontrado: claude (ou codex, gemini, etc.)

O CLI não está instalado, ou seu shell PATH não o vê. Execute novamente o comando de instalação do passo 0 acima. Se você usar nvm, instale o CLI com a mesma versão Node que você usa no dia-a-dia, caso contrário, o binário não estará no PATH quando o AgentsRoom lançar.

Eu não vejo um botão para fazer login em ChatGPT ou Claude dentro de AgentsRoom

Por projecto. AgentsRoom é um UI em cima do CLIs e nunca lida com suas credenciais diretamente. O login é feito uma vez dentro do CLI (run claude ou codex em um terminal), então AgentsRoom usa essa sessão. Isto é o que torna o AgentsRoom mais seguro do que as ferramentas que interceptam seus tokens.

Agente preso ao "pensar"

Verifique se sua assinatura ou API key está ativa para o provedor selecionado. Tente executar o CLI diretamente em seu terminal para ver a mensagem de erro real: Claude ou OpenAI às vezes aceleram ou expiram sessões silenciosamente.

Nenhum projeto na barra lateral

Certifique-se de selecionar uma pasta válida ao criar o projeto. A pasta deve existir no disco. Reiniciar AgentsRoom se um projeto foi adicionado, mas ainda não foi visível.

Eu instalei o CLI mas AgentsRoom ainda diz "comando não encontrado"

AgentsRoom herda o seu PATH da sua shell de login, não do seu terminal interativo. Sair completamente do AgentsRoom, abrir um novo terminal, verificar se o CLI é chamado de uma sessão de shell fresca (que claude), em seguida, reiniciar o AgentsRoom.