Posso rodar duas sessões do Claude Code na mesma pasta?

Sim, o Claude Code vai iniciar, mas as duas sessões editam os mesmos arquivos e veem as mudanças pela metade uma da outra. Dê a cada sessão a própria git worktree, ou pelo menos uma fronteira rígida de pastas.

Vários agentes do Claude Code compartilham um único limite de uso?

Sim. Toda sessão logada na mesma conta consome dos mesmos limites de 5 horas e semanal, então quatro agentes os esgotam cerca de quatro vezes mais rápido.

Quantos agentes do Claude Code posso rodar ao mesmo tempo?

Não há um teto fixo no próprio Claude Code. Na prática, de dois a quatro é o que uma pessoa consegue acompanhar; os limites e o tempo de revisão são o teto real.

Como faço merge do trabalho de agentes do Claude Code em paralelo?

Trate cada worktree como uma branch normal: rode os testes nela, faça push e abra um pull request, ou faça o merge localmente. Faça merge de uma branch por vez e rode os testes de novo depois de cada uma.

Como rodar vários agentes do Claude Code em paralelo

Uma sessão do Claude Code trabalha em uma tarefa passo a passo. Enquanto ela lê arquivos e roda testes, você espera. Rodar vários agentes do Claude Code em paralelo transforma esse tempo de espera em trabalho: um agente constrói a API, outro escreve os testes, um terceiro corrige um bug que não tem nada a ver com nenhum dos dois.

Este post vai do setup mais simples ao mais confortável: terminais comuns, tmux, git worktrees, as sessões paralelas do próprio Claude Code e, por fim, o AgentVera. Cada etapa acrescenta algo que faltava na anterior. No final, há uma lista das armadilhas que costumam pegar: conflitos de merge, limites e tokens.

Dá para rodar mais de um agente do Claude Code ao mesmo tempo?

Sim. O Claude Code é uma CLI; toda vez que você roda claude, inicia uma sessão independente, com a própria conversa e o próprio contexto. Nada impede você de iniciar cinco. O que pode dar errado não é iniciá-las, mas coordená-las: duas sessões na mesma pasta vão editar o mesmo arquivo sem cerimônia, e todas as sessões logadas em uma conta compartilham os limites dela.

Então a pergunta real é como mantê-las separadas e como acompanhá-las.

Opção 1: janelas de terminal separadas

O setup mais rápido é uma aba de terminal por agente:

# tab 1
cd ~/code/acme-web && claude
# tab 2
cd ~/code/acme-web && claude

Funciona para tarefas pequenas e bem separadas. Diga a cada agente, na primeira mensagem, quais pastas ele pode tocar (“só src/api/”, “só tests/”).

As desvantagens aparecem rápido: você não consegue ver qual aba está esperando aprovação, as duas sessões compartilham uma única cópia de trabalho e, quando um agente roda git checkout, o outro de repente está em outra branch.

Opção 2: tmux

O tmux mantém as sessões vivas quando você fecha o terminal e permite ver vários painéis ao mesmo tempo:

tmux new-session -d -s agents -c ~/code/acme-web
tmux split-window -h -t agents -c ~/code/acme-web
tmux send-keys -t agents:0.0 'claude' Enter
tmux send-keys -t agents:0.1 'claude' Enter
tmux attach -t agents

Agora os dois agentes ficam visíveis lado a lado e sobrevivem à tampa do notebook fechada (desde que a máquina continue ligada). O tmux resolve a visibilidade, não o isolamento: os dois painéis ainda editam a mesma pasta.

Opção 3: uma git worktree por agente

As git worktrees são a resposta padrão para “dois agentes, um repositório”. Uma worktree é uma segunda pasta de trabalho na própria branch, compartilhando o mesmo histórico .git:

cd ~/code/acme-web
git worktree add ../acme-web-api -b feat/api
git worktree add ../acme-web-tests -b feat/tests

cd ../acme-web-api && claude     # agent 1
cd ../acme-web-tests && claude   # agent 2

Agora cada agente tem os próprios arquivos e a própria branch. O git checkout ou o arquivo pela metade de um agente não afeta o outro. Quando um agente termina, a branch dele recebe merge como qualquer branch de feature.

Algumas notas práticas:

Instale as dependências em cada worktree. node_modules, virtualenvs e saídas de build não são compartilhados. Rode pnpm install (ou equivalente) em cada pasta nova.
Copie a configuração local. Arquivos .env costumam ser ignorados pelo git, então não aparecem em uma worktree nova.
As portas colidem. Dois servidores de desenvolvimento na porta 3000 não sobem; dê a cada worktree a sua própria porta.
Faça a limpeza. git worktree remove ../acme-web-api quando a branch receber merge, e git worktree prune para pastas que você apagou na mão.

Os detalhes estão em git worktrees para agentes paralelos.

Opção 4: as sessões paralelas do próprio Claude Code

O app desktop do Claude Code, da Anthropic, consegue rodar sessões paralelas do Claude, cada uma na própria worktree, sem você digitar os comandos do git. Se você só usa o Claude e quer a ferramenta oficial, esta é uma parada razoável. Ela cobre o isolamento e uma visão geral básica.

O que ela não tenta fazer: rodar outras CLIs, como Codex ou Gemini CLI, ao lado do Claude, passar a saída de um agente para outro automaticamente ou mover um agente para outra conta quando um limite acaba. É aí que entra um app dedicado a vários agentes. Para uma comparação das opções, veja as melhores ferramentas para rodar vários agentes de código com IA em paralelo.

Opção 5: AgentVera

O AgentVera abre o comando claude da sua máquina em terminais reais e organiza os agentes em uma grade por projeto. Ele usa o próprio login do Claude Code, então o seu plano Pro ou Max funciona como está. Veja como os problemas anteriores se relacionam com os recursos dele:

Problema	No AgentVera
Não dá para ver qual agente precisa de você	Grade de 1×1 a 5×4; cada painel mostra o status e o tamanho do contexto ao vivo; agentes esperando aprovação são listados na barra de status
Agentes editam os mesmos arquivos	Painel de worktrees: crie uma worktree a partir de uma branch e inicie um agente direto nela
Dois agentes tocam um mesmo arquivo mesmo assim	Um aviso de conflito de arquivos: quando dois agentes editam o mesmo arquivo na mesma pasta, tanto o agente quanto você são avisados; nada é bloqueado
A saída precisa ser copiada na mão	Flows enviam a resposta de um agente para outro por meio de um template
O limite acaba no meio da tarefa	A troca de contas move o agente para a próxima conta do Claude e copia a conversa
O contexto cresce a cada turno	`/compact` automático em um limiar que você define, mais perfis de contexto

Passo a passo

Adicione a pasta do projeto. Escolha-a na tela de projetos. Um repositório Git é recomendado.
Crie worktrees. No painel direito, abra a lista de worktrees e crie uma por tarefa a partir de uma nova branch, por exemplo feat/api e feat/tests.
Abra os agentes. Em “New agent”, escolha Claude Code, selecione a worktree e dê ao agente um nome, um modelo, um esforço e um papel curto:
```
Work only under src/api/. Don't change tests.
Run pnpm test api after each change.
Finish with a bullet list of what you changed.
```
Organize a grade. Um layout 2×2 comporta dois agentes Claude, um revisor Codex e um terminal rodando o servidor de desenvolvimento.
Conecte-os se precisar. Um flow pode enviar o resumo final do agente da API para o agente de testes quando o turno dele termina. Um limite de turnos impede que dois agentes entrem em loop.
Revise e faça o merge. A revisão automática de código confere cada turno concluído. O painel Git mostra as mudanças de cada worktree e quanto ela está à frente da main; faça merge de uma branch por vez.

A grade, as worktrees e a revisão de código estão no plano gratuito. Flows e troca de contas estão no Pro.

Armadilhas e como evitá-las

Conflitos de merge

As worktrees impedem que os agentes sobrescrevam o trabalho um do outro enquanto trabalham; elas não impedem conflitos na hora do merge. Dois agentes que editam src/routes.ts em branches diferentes ainda vão entrar em conflito no final.

Divida as tarefas por pasta ou módulo, não só por branch.
Deixe os arquivos compartilhados (tabelas de rotas, schemas, lockfiles) com um único agente.
Faça merge primeiro da branch menor, depois faça rebase da outra worktree na main e deixe o agente dela resolver o conflito: git rebase main dentro dessa worktree, depois peça ao agente para resolver e rodar os testes de novo.

Limites de uso

Todas as sessões de uma conta compartilham os mesmos limites de 5 horas e semanal. Quatro agentes não ganham quatro vezes a cota; eles chegam ao limite quatro vezes mais rápido. Confira o /usage no Claude Code com frequência e planeje as sessões paralelas pesadas para o início de uma janela de limite. Se você legitimamente tem mais de uma conta (por exemplo, pessoal e do trabalho) e os termos do provedor permitem, a troca de contas mantém a tarefa andando quando uma acaba. Leia mais em limites de uso do Claude Code.

Uso de tokens

Cada agente carrega o próprio contexto: system prompt, definições de ferramentas, CLAUDE.md, servidores MCP e todo arquivo que leu. Essa base é relida a cada turno, por agente.

Dê aos agentes tarefas estreitas e concretas para que leiam menos arquivos.
Rode /compact antes que uma conversa longa fique cara, ou deixe-o rodar automaticamente em um limiar.
Desligue os servidores MCP de que um agente não precisa.
Ao passar saídas entre agentes, envie o resumo, não a transcrição inteira.

Os números medidos estão em como reduzir o uso de tokens do Claude Code.

Aprovações que travam

Um agente esperando permissão para enquanto os outros seguem. Com cinco painéis, é fácil deixar um passar. Fique de olho no status, use notificações ou permita ações seguras (ler arquivos, rodar testes) nas configurações de permissão do Claude Code para que os agentes perguntem menos.

Agentes demais, cedo demais

O gargalo passa dos agentes para você. Revisar quatro branches leva mais tempo que revisar uma. Comece com dois agentes em tarefas claramente separadas e adicione um terceiro quando isso estiver funcionando.

Um checklist mínimo

Uma worktree por agente que possa tocar código compartilhado
Dependências instaladas e .env copiado em cada worktree
O papel de cada agente nomeia as pastas e o objetivo dele
Portas separadas para os servidores de desenvolvimento
Um plano de merge: qual branch primeiro, quem resolve os conflitos
Um olho no /usage e no tamanho do contexto

Conclusão

Rodar vários agentes do Claude Code em paralelo é, acima de tudo, uma questão de isolamento e atenção. As worktrees dão a cada agente os próprios arquivos; o tmux ou uma grade deixa você ver todos; papéis curtos e um plano de merge mantêm o resultado revisável. Terminais comuns e worktrees bastam para começar. Quando quiser uma grade, flows entre agentes e ajuda com os limites, baixe o AgentVera de graça e abra os seus dois primeiros agentes do Claude Code. Para o método geral, veja agentes de código em paralelo.