Um agente já ajuda. Mas é com três agentes tocando tarefas separadas enquanto você revisa o diff do primeiro que os agentes de terminal mostram de verdade a que vieram. E também é aí que tudo dá errado rápido: dois agentes editando o mesmo arquivo, servidores brigando pela mesma porta ou o limite de uso estourando no meio da tarde.
Este guia mostra um setup que evita esses problemas. Se você prefere que um agente divida e revise o trabalho por você, veja Monte uma equipe de agentes de IA para programar. Funciona com Claude Code, Codex, Gemini CLI e qualquer outra CLI de agente.
Resumindo
- Dê a cada agente a sua própria tarefa e, quando ele for mexer em código, a sua própria cópia de trabalho (um git worktree).
- Deixe todos os agentes de um projeto visíveis numa grade só, para perceber quando um deles precisa de você.
- Use um segundo agente como revisor, não como segundo autor do mesmo código.
- Fique de olho nos limites de uso, porque agentes em paralelo gastam em paralelo.
Passo 1: Divida o trabalho em tarefas independentes
Agentes em paralelo funcionam quando as tarefas não mexem nos mesmos arquivos. Boas divisões:
- Uma feature numa área e um bug fix em outra
- Implementar uma mudança e escrever testes para código que já existe
- Um agente programando e outro escrevendo documentação ou um plano de migração
- Pesquisa ou leitura de código, que não altera nada
Divisões ruins são dois agentes no mesmo componente, ou um agente refatorando um código que outro está estendendo. Se você não consegue descrever os arquivos de cada tarefa sem sobreposição, rode uma depois da outra.
Passo 2: Dê a cada agente que programa o seu próprio worktree
Dois agentes na mesma pasta dividem a mesma working tree. Quando os dois editam, você ganha mudanças pela metade, conflitos surpresa e diffs que não dá para saber de quem são. A solução é um git worktree por tarefa: um segundo checkout do mesmo repositório, em outra pasta, num branch próprio.
git worktree add ../atlas-auth -b feat/auth
git worktree add ../atlas-search -b feat/searchAí cada agente roda na sua pasta, e você faz o merge dos branches quando eles terminam. O Claude Code também faz isso num passo só com claude --worktree feature-auth. Nosso guia de git worktrees para Claude Code e Codex entra nos detalhes, incluindo dependências, arquivos .env e limpeza.
Agentes que só leem (revisão, pesquisa, perguntas sobre a documentação) podem dividir a pasta principal.
Passo 3: Coloque todos os agentes numa tela só
A falha mais comum com agentes em paralelo não é o código, é a atenção. Um agente pede permissão numa aba escondida e fica esperando vinte minutos.
No Vibe Console, cada projeto pode ter até 10 terminais, em abas ou numa grade de 1×2 a 3×3. Um layout que funciona bem para três agentes:
| Painel | Roda |
|---|---|
| 1 | Claude Code em ../atlas-auth |
| 2 | Codex em ../atlas-search |
| 3 | Claude Code na pasta principal, revisando |
| 4 | Servidor de desenvolvimento |
Cada terminal pode rodar um agente diferente: escolha um ao lado do botão Iniciar e aperte ⌘K. Para iniciar um agente dentro de um worktree, entre nele com cd antes; você pode arrastar um worktree do painel de controle de código-fonte para um terminal para colar o caminho. Renomeie os terminais (Renomear…) com o nome da tarefa, para a grade virar uma lista de tarefas.
Cada aba mostra um pontinho indicando se o agente está trabalhando ou parado. Quando um agente termina, ou para esperando você responder, o app toca um som e abre o notch naquela sessão, então dá para tirar o olho da tela. Veja notificações do Claude Code no Mac para os detalhes e uma alternativa grátis com hooks.
Passo 4: Use um segundo agente como revisor
Modelos diferentes pegam erros diferentes. Um padrão barato e eficiente:
- O Claude Code implementa uma mudança no worktree dele.
- Quando ele termina, inicie o Codex (ou outra sessão do Claude Code) na mesma pasta com um prompt de revisão salvo, por exemplo: “Revise o diff não commitado procurando bugs, testes faltando e problemas de segurança. Não edite arquivos; liste os achados com arquivo e linha.”
- Cole os achados de volta no primeiro agente.
Salve o prompt de revisão uma vez em Prompts salvos (⌘⇧S) e cole com um clique em qualquer terminal.
Passo 5: Fique de olho nos limites de uso
Os planos do Claude Code e do Codex medem o uso em janelas, incluindo uma janela móvel de 5 horas e um limite semanal. Três agentes gastam isso mais ou menos três vezes mais rápido, e bater no limite no meio de uma tarefa deixa o trabalho pela metade.
O Vibe Console mostra os anéis de cota do Claude Code e do Codex no notch e na barra de ferramentas do terminal, com o horário em que zeram, e avisa você em 80% e 100%. Nosso guia de limites de uso do Claude Code explica as janelas e como se planejar em volta delas.
Passo 6: Faça o merge e limpe tudo
Quando uma tarefa termina:
- Revise o diff do branch (controle de código-fonte, ⌘⇧G).
- Rode os testes naquele worktree.
- Faça o merge do branch e remova o worktree (Remover worktree no controle de código-fonte, ou
git worktree remove ../atlas-auth).
Quantos agentes é demais?
Para a maioria das pessoas, dois ou três agentes programando mais um revisor é o máximo que realmente ajuda. Passando disso, o gargalo vira a revisão, não os agentes. Só adicione mais agentes em paralelo para tarefas independentes, bem especificadas e com bons testes.
Perguntas frequentes
Dá para rodar Claude Code e Codex no mesmo projeto ao mesmo tempo?
Dá. Dê a cada um o seu próprio worktree se os dois forem mexer em código, ou deixe um deles só como revisor, sem editar nada.
Sessões paralelas do Claude Code compartilham contexto?
Não. Cada sessão tem a sua própria conversa. Compartilhe decisões por arquivos que os agentes leem, como CLAUDE.md, AGENTS.md ou notas do projeto.
Rodar agentes em paralelo custa mais caro?
Gasta os limites do seu plano mais rápido, porque cada agente consome uso de forma independente. O trabalho total é parecido; ele só acontece em menos tempo.
Bora testar? Baixe o Vibe Console grátis por 14 dias.