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) 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

✓macOS 14+ (Sonoma ou posterior)
✓
Pelo menos um código de IA CLI instalado (Claude, Codex, OpenCode, Gemini CLI ou Aider)
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

Gemini CLI (Google)Lista livre disponível

Funciona com

Uma conta Google (lista livre disponível) ou um Gemini API key.

1. Instalar

npm install -g @google/gemini-cli

2. Assine aqui

Corre com o Gemini uma vez. Uma janela do navegador abre para o Google iniciar sessão.

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

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 arquivo .dmg, abra-o e arraste AgentsRoom para sua pasta Aplicações. Inicie-o a partir do Spotlight ou da pasta Aplicações.

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 o CLI não é assinado. Abra um terminal regular (Terminal.app), execute o comando CLI sozinho (claude, codex, gemini, opencode), complete o login do navegador, então volte para AgentsRoom e inicie o agente novamente. AgentsRoom não tem sua própria tela de login: a autenticação vive no 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.