# Como usar o AgentVera: primeiro projeto, agentes e grid

URL: https://agentvera.dev/pt/blog/getting-started-with-agentvera/ · Publicado: 2026-10-24

Como usar o AgentVera passo a passo: adicione o projeto, inicie agentes Claude Code ou Codex, organize o grid, acompanhe o status e faça login só para o Pro.

**Resumo:**

- Instale os CLIs de agentes que você quer, abra o AgentVera, adicione a pasta de um projeto e inicie agentes com “New agent”; cada um roda como o CLI real no próprio painel de terminal.
- Os agentes usam os logins que os CLIs já têm. Contas extras de Claude e Codex ficam em Settings → Accounts, e você escolhe uma por agente no diálogo “New agent”.
- Os recursos principais funcionam sem conta no AgentVera. Faça login só para recursos Pro e Team, como flows, aprovação automática e troca automática de contas.

**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](/pt/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](/pt/blog/how-to-use-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.

1. **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**.
2. **Agent name** e **Color:** um nome curto como “Backend” ou “Reviewer” deixa o grid mais fácil de ler.
3. **Runs on:** deixe em **This computer** por enquanto. Você também pode rodar um agente em um servidor SSH.
4. **Account:** o login que o agente usa. O padrão é o que já está neste computador. O campo mostra **Signed in** ou **Signed out**.
5. **Workspace:** a pasta principal ou uma das Git worktrees do projeto.
6. **Role and instructions:** opcional. No Claude, é adicionado ao system prompt; no Codex, entra como developer instructions.
7. 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](/pt/features/token-savings/) explica os perfis de contexto, e [Docker](/pt/features/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](/pt/blog/switch-claude-code-accounts/) 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](/pt/blog/git-worktree-parallel-agents/) explica a configuração, e [Como rodar vários agentes do Claude Code](/pt/blog/run-multiple-claude-code-agents/) 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](/pt/features/notifications-and-approvals/).

## 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](/pt/features/code-review/).
- **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](/pt/blog/undo-claude-code-changes/) 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](/pt/pricing/) 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:

1. Adicione um repositório que você conhece bem.
2. Inicie um agente Claude Code em uma worktree nova e peça uma mudança pequena e bem delimitada.
3. Inicie um segundo agente (Codex, ou outro Claude Code) na própria worktree, em uma tarefa sem relação.
4. Deixe o grid com duas colunas e mantenha os dois visíveis.
5. Enquanto eles trabalham, leia os diffs, responda às aprovações e coloque sua próxima mensagem na fila.
6. 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](/pt/blog/claude-code-usage-limits/) 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.

## Perguntas frequentes

**Preciso de uma conta no AgentVera para começar?** Não. Projetos, agentes, o grid, Git, MCP, Docker, SSH, revisão de código e economia de tokens estão no plano Free e não exigem conta. Você entra na sua conta AgentVera só para liberar recursos Pro ou Team.

**O AgentVera substitui o Claude Code ou o Codex?** Não. O AgentVera roda os CLIs reais. Cada agente é um processo do Claude Code, Codex, Gemini CLI, Copilot CLI ou outro CLI no próprio terminal, e usa o login e as configurações daquele CLI.

**E se a ferramenta que eu escolher mostrar Not installed?** O AgentVera não encontrou aquele CLI neste computador. Instale-o do jeito que o fabricante documenta, confira se o comando roda em um terminal comum e abra o diálogo New agent de novo.

**Quantos agentes posso rodar em um projeto?** O plano Free não tem limite de agentes. O grid mostra até 5 colunas por 4 linhas de painéis por projeto, e cada projeto lembra o próprio layout.

**Em quais sistemas o AgentVera roda?** macOS, Windows e Linux. Ele se atualiza sozinho a partir do agentvera.dev, e os agentes voltam para a conversa deles na próxima vez que você abre o app.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/