Configurar seu primeiro agente

De uma instalação nova a um agente de IA funcionando. As duas partes que os iniciantes mais deixam passar estão no topo: como o AgentsRoom se relaciona com os CLIs de IA, e como entrar.

Como funciona o AgentsRoom (leia isto primeiro)

O AgentsRoom é o cockpit. Os CLIs de IA (Claude, Codex, GitHub Copilot CLI, Cursor e outras 15 CLIs de agentes) são os motores. Você entra nos motores uma vez pelo próprio comando de cada um e depois o AgentsRoom os conduz visualmente. O AgentsRoom nunca armazena nem vê seus tokens, API keys ou sua senha do ChatGPT: eles ficam no armazenamento seguro de cada CLI, na 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 CLI de programação com IA instalado (Claude, Codex, GitHub Copilot CLI, Cursor ou qualquer uma das outras 15 CLIs de agentes que o AgentsRoom suporta)
curl -fsSL https://claude.ai/install.sh | bash
✓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

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

2. Entrar

Execute 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). Você deve ver uma mensagem de boas-vindas. Digite "olá" e pressione enter: se você obtiver uma resposta, você está pronto para usá-la dentro do AgentsRoom.

Codex (OpenAI / ChatGPT)Use sua conta ChatGPT

Funciona com

ChatGPT Plus, Pro, Team ou Enterprise, ou uma OpenAI API key.

1. Instalar

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

2. Entrar

Execute o codex uma vez em qualquer terminal. Uma janela do navegador se abre. Entre com sua conta ChatGPT, a mesma que você usa no chatgpt.com.

3. Verificar

Antigravity CLI (Google)Nível gratuito disponível

Funciona com

Uma conta Google (login no navegador). Há um nível gratuito generoso disponível.

1. Instalar

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

2. Entrar

Execute antigravity uma vez em qualquer terminal. Uma janela do navegador abre para login com o Google.

3. Verificar

OpenCodeTraga o seu próprio provedor

Funciona com

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

1. Instalar

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

2. Entrar

Execute opencode e use o comando /connect para adicionar uma chave de provedor ou uma assinatura do OpenCode Go.

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. Entrar

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

CursorSeu editor, no terminal

Funciona com

Uma conta Cursor. Seu plano atual cobre o CLI; o plano gratuito alcança menos modelos.

1. Instalar

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

2. Entrar

Execute cursor-agent login para entrar pelo navegador. A configuração fica em ~/.cursor.

3. Verificar

oh-my-piMais de 60 backends

Funciona com

O que você já paga: ele faz login na Anthropic, OpenAI, Google, xAI, Z.ai, DeepSeek e outros, ou aceita uma simples chave de API.

1. Instalar

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

2. Entrar

Execute omp uma vez e depois use /login para conectar um provedor. A configuração fica em ~/.omp.

3. Verificar

Kimi (Moonshot AI)Até 1M de contexto

Funciona com

Uma conta Kimi (login pelo navegador) ou uma chave de API da Open Platform da Moonshot AI.

1. Instalar

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

2. Entrar

Execute kimi uma vez em qualquer terminal e depois digite /login para entrar com sua conta Kimi. A configuração fica em ~/.kimi-code.

3. Verificar

FreebuffNenhuma chave necessária

Funciona com

Nenhuma. O serviço é gratuito e financiado por anúncios de texto exibidos entre os turnos.

1. Instalar

npm install -g freebuff

2. Entrar

Execute freebuff no seu projeto. Existe um comando freebuff login caso você queira vincular uma conta Codebuff.

3. Verificar

Pi (Earendil)Minimalista e extensível

Funciona com

O que você já paga: o Pi faz login na Anthropic, OpenAI, Google, GitHub Copilot e muitos outros provedores, ou aceita uma simples chave de API.

1. Instalar

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

2. Entrar

Execute pi uma vez e depois use /login para conectar um provedor. A configuração fica em ~/.pi/agent.

3. Verificar

DevinUm plano, vários modelos

Funciona com

Um plano Devin ou Windsurf, incluindo o gratuito. A mesma assinatura cobre Claude, GPT, Gemini e os modelos SWE da Cognition.

1. Instalar

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

2. Entrar

Execute devin auth login para entrar pelo navegador. A configuração fica em ~/.config/devin.

3. Verificar

Command CodeModelos abertos e proprietários à sua escolha

Funciona com

Uma conta Command Code ou uma chave de API COMMAND_CODE_API_KEY. O acesso aos modelos e os limites de uso dependem da sua conta no provedor.

1. Instalar

npm install -g command-code@latest

2. Entrar

Execute command-code login para entrar, ou defina COMMAND_CODE_API_KEY no seu ambiente. Depois, execute command-code no seu projeto.

3. Verificar

Mistral VibeModelos europeus

Funciona com

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

1. Instalar

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. Entrar

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

Muse Code (Meta)Muse Spark no seu terminal

Funciona com

Uma conta Meta com acesso ao Muse Code, ou uma chave de API META_API_KEY. A Meta define as condições de acesso e os limites de uso.

1. Instalar

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

2. Entrar

Execute muse login para entrar, ou defina META_API_KEY no seu ambiente. Depois, execute muse no seu projeto.

3. Verificar

AiderUtilizadores de energia

Funciona com

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

1. Instalar

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. Entrar

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

Amp (Sourcegraph)Modos, não modelos

Funciona com

Uma conta Amp (login pelo navegador) ou um token AMP_API_KEY.

1. Instalar

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

2. Entrar

Execute amp login uma vez em qualquer terminal para entrar. As configurações ficam em ~/.config/amp.

3. Verificar

MiniMax Code (MiniMax)Modelos da série M

Funciona com

Uma conta MiniMax (login no navegador) ou uma chave de API MiniMax.

1. Instalar

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

2. Entrar

Execute mcode login --region global (ou mcode login para uma conta da China continental) em um terminal. A configuração fica em ~/.minimax.

3. Verificar

ZCode (cliente da comunidade)Modelos GLM, não é da Z.ai

Funciona com

Um plano Z.ai ou BigModel, ou uma chave de API. Este cliente da comunidade não é publicado nem endossado pela Z.ai.

1. Instalar

npm install -g zcode-app-cli@latest

2. Entrar

Execute zcode uma vez em um terminal e digite /login para entrar com sua conta Z.ai ou BigModel. Requer Node.js 22.19 ou mais recente. A configuração fica em ~/.zcode.

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.

Veja-o trabalhar

O terminal mostra saída ao vivo: cada arquivo lido, cada edição. O status muda: trabalhando, depois concluído. Você recebe uma notificação desktop 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 hooks. 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 desktop 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, antigravity, 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.

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

O CLI não está instalado, ou o PATH do seu shell 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 iniciar.

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

Por design. O AgentsRoom é uma interface que funciona por cima dos CLIs e nunca lida diretamente com suas credenciais. O login é feito uma vez dentro do CLI (execute claude ou codex em um terminal) e depois o AgentsRoom usa essa sessão. É isso 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 limitam ou encerram sessões sem avisar.

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 o AgentsRoom ainda diz "command not found"

O AgentsRoom herda o seu PATH da sua shell de login, não do seu terminal interativo. Feche completamente o AgentsRoom, abra um novo terminal, verifique se o CLI pode ser chamado a partir de uma nova sessão de shell (which claude) e depois reabra o AgentsRoom.