Para usar o AgentVera, instale os CLIs de agentes de código que você quer, adicione a pasta de um projeto, inicie um ou mais agentes em “New agent” e trabalhe com eles lado a lado no grid do projeto. Cada agente é o CLI real, como o Claude Code ou o Codex, rodando no próprio painel de terminal com o próprio login. O AgentVera acrescenta o que fica em volta: um grid por projeto, uma caixa de mensagem com fila, status à primeira vista, checkpoints por turno, revisão de código e gestão de contas.
Este guia leva você de uma janela vazia a alguns agentes trabalhando. Ele cobre o que instalar antes, como funciona o diálogo “New agent”, como organizar o grid, como funciona o login nos CLIs e no próprio AgentVera, e os hábitos que evitam que agentes em paralelo atrapalhem uns aos outros.
O que você precisa antes de começar
O AgentVera é um app desktop para macOS, Windows e Linux. Você pode baixá-lo na página de download. Ele não vem com um modelo próprio. Ele roda os CLIs de agentes que já estão no seu computador.
| Você precisa de | Por quê |
|---|---|
| Pelo menos um CLI de agente, como Claude Code ou Codex | O AgentVera inicia o CLI real para cada agente |
| Um login nesse CLI | Os agentes usam o login e o plano do próprio CLI |
| A pasta de um projeto, de preferência um repositório Git | Checkpoints, worktrees e revisão de código se apoiam no Git |
| Uma conta AgentVera (opcional) | Só para recursos Pro e Team |
Se você nunca usou o Claude Code, Como usar o Claude Code mostra como instalar e fazer login. O AgentVera suporta 18 CLIs de agentes, incluindo Claude Code, Codex, Gemini CLI e GitHub Copilot CLI, então você pode começar com o que já paga.
Passo 1: adicione seu primeiro projeto
Abra o AgentVera e clique em Add project folder na barra superior. Escolha a pasta de um repositório em que você trabalha. O projeto aparece na tela Projects home e na barra superior, e você pode pular entre projetos por ali ou com a command palette (⌘K, Ctrl K no Windows e no Linux).
Cada projeto tem duas visões:
- Workspace: o grid de painéis de agentes, onde você passa a maior parte do tempo.
- Details: informações sobre o projeto em volta dos agentes.
Se você só quer fazer uma pergunta rápida antes de configurar um projeto, a tela inicial tem um chat rápido. Esses chats rodam na pasta do próprio app e não mexem nos seus projetos.
Passo 2: inicie seu primeiro agente
Clique em New agent na barra lateral, ou pressione ⌘N. O diálogo diz o que precisa: escolha uma ferramenta, depois dê ao agente um nome e, se precisar, um papel.
- Tool: escolha o CLI, por exemplo Claude Code ou Codex. Uma ferramenta que o AgentVera não encontra neste computador aparece marcada como Not installed.
- Agent name e Color: um nome curto como “Backend” ou “Reviewer” deixa o grid mais fácil de ler.
- Runs on: deixe em This computer por enquanto. Você também pode rodar um agente em um servidor SSH.
- Account: o login que o agente usa. O padrão é o que já está neste computador. O campo mostra Signed in ou Signed out.
- Workspace: a pasta principal ou uma das Git worktrees do projeto.
- Role and instructions: opcional. No Claude, é adicionado ao system prompt; no Codex, entra como developer instructions.
- Clique em Start agent.
O diálogo tem mais opções, incluindo perfil de contexto, navegador, mapa do projeto, servidores MCP, container Docker, orçamento de tokens e caminhos próprios. Você pode deixar tudo no padrão na primeira vez e voltar depois. Economia de tokens explica os perfis de contexto, e Docker explica como rodar um agente em um container.
O agente abre em um painel. Esse painel é um terminal real rodando o CLI, então tudo o que o CLI faz em um terminal comum funciona aqui também, incluindo os slash commands. Embaixo dele há uma caixa de mensagem com histórico de prompts, rascunhos e uma fila (⌘Enter coloca uma mensagem na fila enquanto o agente ainda está ocupado).
Passo 3: faça login nos agentes
Os agentes não fazem login pelo AgentVera. Eles usam os logins dos próprios CLIs, então, se claude ou codex já funciona no seu terminal, a conta padrão está pronta. O AgentVera marca essa conta padrão como this computer.
Se uma conta estiver deslogada, o diálogo “New agent” avisa: “This account is signed out. Sign in from Settings → Accounts, or the agent will ask you to sign in on first launch.” (a conta está deslogada; faça login em Settings → Accounts, ou o agente vai pedir login na primeira execução). Você pode seguir qualquer um dos caminhos.
Para usar mais de uma conta Claude ou Codex, abra Settings → Accounts, clique em Add Claude account ou Add Codex account, dê um nome e escolha Add and sign in. Cada conta extra ganha a própria pasta de configuração, e você escolhe com qual conta um agente roda quando o cria. Como trocar de conta no Claude Code mostra isso em detalhes.
Passo 4: adicione mais agentes e organize o grid
Um agente já é útil. Dois ou três em paralelo é onde o AgentVera mostra seu valor. Crie um segundo agente do mesmo jeito e dê a cada um uma tarefa clara e separada.
O grid fica em Screen splitter (⌘⌥L). Escolha o número de colunas e linhas, de 1×1 até 5×4, ou um layout pronto como “Top 2 · Bottom 1”. Arraste os divisores para redimensionar os painéis e use Equalize pane sizes para igualá-los. Cada projeto lembra o próprio layout.
| Ação | Como |
|---|---|
| Trocar dois painéis de lugar | Arraste um painel sobre o outro |
| Maximizar um painel | Clique duas vezes no título, ou ⌘⇧Enter |
| Mover o foco entre agentes | ⌘⌥ + setas |
| Pular para um painel | ⌘1 a ⌘9 |
| Abrir a command palette | ⌘K |
| Abrir o screen splitter | ⌘⌥L |
No Windows e no Linux, use Ctrl no lugar de ⌘ e Alt no lugar de ⌥. Você pode mudar todos os atalhos em Settings. Um painel também pode abrir em um modal ou em uma janela separada, se você quiser um agente em uma segunda tela.
Quando vários agentes compartilham uma pasta, eles podem sobrescrever os arquivos uns dos outros. Apontar cada agente para a própria Git worktree no campo Workspace evita isso. Git worktrees para agentes em paralelo explica a configuração, e Como rodar vários agentes do Claude Code mostra como dividir o trabalho.
Passo 5: acompanhe o que cada agente está fazendo
Todo agente mostra um status: Working, Waiting for you, Needs approval, Idle, Asleep, Stopped ou Error. A barra de status faz a contagem, por exemplo “2 working” ou “3 agents need approval”, para você ver o que precisa de você sem abrir cada painel. Pressione ⇧⌘A para ir ao próximo agente esperando aprovação.
Quando você se afasta, notificações no desktop avisam quando um agente termina, falha ou espera aprovação. Você também pode recebê-las no celular. Veja notificações e aprovações.
Passo 6: confira o trabalho e desfaça um turno ruim
Dois recursos do Free ajudam você a confiar no que os agentes em paralelo produzem.
- Revisão de código: quando você a ativa nas configurações do projeto, um modelo Claude que você escolhe revisa o código de cada agente quando o turno dele termina. Os achados vêm com severidade e um link arquivo:linha, e podem, opcionalmente, voltar para o agente. Veja revisão de código.
- Checkpoints: no início de cada turno, o AgentVera tira um snapshot da pasta de trabalho do agente. O botão Turns no cabeçalho do painel lista os turnos e os arquivos que cada um mudou, e Roll back this turn devolve a pasta ao estado anterior. Como desfazer mudanças do Claude Code mostra isso passo a passo.
Passo 7: entre no AgentVera só quando precisar
Quase tudo o que este guia cobre está no plano Free, sem conta. Pro e Team acrescentam recursos como flows, turno da noite, aprovação automática e troca automática de contas. Para usá-los, escolha Sign in to AgentVera no app. Você pode entrar pelo navegador (login com Google e autenticação de dois fatores são tratados lá) ou com e-mail e senha. A página de preços lista o que cada plano inclui.
Uma primeira sessão que funciona
Se você não sabe o que testar primeiro, esta é uma configuração simples que mostra o valor rapidamente:
- Adicione um repositório que você conhece bem.
- Inicie um agente Claude Code em uma worktree nova e peça uma mudança pequena e bem delimitada.
- Inicie um segundo agente (Codex, ou outro Claude Code) na própria worktree, em uma tarefa sem relação.
- Deixe o grid com duas colunas e mantenha os dois visíveis.
- Enquanto eles trabalham, leia os diffs, responda às aprovações e coloque sua próxima mensagem na fila.
- Quando um turno der errado, desfaça-o em Turns em vez de discutir com o agente.
Dicas para a primeira semana
- Uma tarefa por agente. Dê aos agentes o nome da tarefa deles. Um papel claro em Role and instructions poupa você de se repetir.
- Uma worktree por agente. É o jeito mais fácil de impedir que agentes sobrescrevam o trabalho uns dos outros.
- Comece com um grid pequeno. Dois ou três agentes que você realmente lê valem mais do que oito que você só passa o olho.
- Use a palette. ⌘K encontra quase todas as ações, com o atalho ao lado.
- Fique de olho nos limites. A barra de status mostra o uso de 5 horas e semanal de cada conta. Limites de uso do Claude Code tem dicas para fazê-los durar.
- Troque o idioma se quiser. A interface está em inglês e turco, com temas claro e escuro, em Settings → Appearance.
Concluindo
Começar com o AgentVera leva poucos minutos. Você adiciona um projeto, inicia um agente com o CLI que já usa e adiciona um segundo quando tiver uma segunda tarefa. Todo o resto, como worktrees, checkpoints, revisão, contas extras e notificações no celular, se apoia nesse mesmo grid. Você pode adicionar cada coisa quando precisar.