Como executar vários agentes Claude Code em paralelo
A forma mais segura de executar vários agentes Claude Code em paralelo é dar uma Git worktree para cada tarefa independente. O Claude Code consegue criar essas worktrees sozinho. O Agentastic adiciona a camada operacional: setup do repositório, estados visíveis, terminais nativos, contêineres, testes no navegador, revisão de diff e um caminho claro até o pull request.
Resumo rápido#
| Necessidade | Melhor ponto de partida |
|---|---|
| Duas sessões Claude isoladas sem outra interface | claude --worktree <nome> |
| Controle completo de branches e diretórios | git worktree add e um terminal por tarefa |
| Vários agentes, setup repetível, revisão ou provedores mistos | Workspaces do Agentastic |
| Isolamento de pacotes, processos e serviços | Modo contêiner do Agentastic |
A documentação oficial do Claude Code cobre --worktree, .worktreeinclude, isolamento de subagentes e limpeza. O guia de agentes em paralelo ajuda a escolher entre worktrees, subagentes, agent view e equipes coordenadas.
Por que vários terminais não bastam#
Dois terminais apontados para o mesmo repositório ainda compartilham um diretório de trabalho. As sessões podem sobrescrever arquivos não commitados, invalidar o build uma da outra, disputar o índice do Git ou abrir servidores na mesma porta.
Uma branch não cria isolamento físico. Uma worktree cria: cada tarefa recebe seus próprios arquivos, dependências locais, artefatos, arquivos ignorados e diff.
Opção 1: worktrees nativas do Claude Code#
claude --worktree corrigir-checkout
claude --worktree testes-cupons
claude --worktree documentar-reembolsosSe o checkout precisar de arquivos ignorados, use uma lista explícita em .worktreeinclude:
.env
.env.local
config/secrets.jsonEssa é uma ótima opção quando Claude Code é o único agente e você quer que o produto oficial administre a sessão.
Opção 2: worktrees manuais#
git fetch origin
git worktree add -b agent/fix-checkout \
../store-fix-checkout origin/main
git worktree add -b agent/coupon-tests \
../store-coupon-tests origin/main
cd ../store-fix-checkout && claude
cd ../store-coupon-tests && claudeÉ o caminho mais transparente, mas você administra setup, portas, processos, estado, revisão, merge e limpeza.
Opção 3: Claude Code em paralelo no Agentastic#
O Agentastic executa o CLI oficial já instalado e autenticado. Ele não substitui o Claude Code nem intermedeia chamadas ao modelo.
1. Verifique o CLI#
which claude
claude --version2. Crie uma tarefa delimitada#
Abra o repositório no Agentastic, entre no Agent Home, escolha a branch base, Claude Code e o modo Worktree.
Um bom prompt define resultado, restrições e verificação:
Corrija a regressão de arredondamento no checkout.
Não altere a API pública de dinheiro. Preserve o comportamento atual de USD e EUR.
Execute a suíte focada de checkout e explique a causa raiz ao terminar.3. Uma tarefa independente por workspace#
Por exemplo:
fix-checkout-roundingadd-zero-coupon-testsupdate-refund-docs
O Agentastic cria uma branch e worktree por tarefa, executa o setup e mantém sessão, terminal, navegador e diff associados ao mesmo workspace.
4. Automatize o setup#
Crie .agentastic/setup.sh:
#!/usr/bin/env bash
set -euo pipefail
if [ -f "$AGENTASTIC_MAIN_REPO_PATH/.env" ] && [ ! -f .env ]; then
cp "$AGENTASTIC_MAIN_REPO_PATH/.env" .env
fi
if [ -f package-lock.json ]; then
npm ci
elif [ -f pnpm-lock.yaml ]; then
pnpm install --frozen-lockfile
fiDepois rode chmod +x .agentastic/setup.sh. O script deve ser idempotente para poder ser executado novamente com segurança.
5. Monitore exceções, não cada token#
O navegador de Agentes mostra sessões trabalhando, aguardando você, concluídas ou com falha. Shift-Command-U abre o próximo agente que exige atenção.
6. Verifique cada resultado#
Para cada worktree:
- Leia a evidência dos testes.
- Inspecione todos os arquivos alterados.
- Execute a verificação importante por conta própria.
- Abra o servidor daquela worktree no navegador integrado.
- Use uma sessão nova como revisora quando o risco justificar.
O Agentastic pode enviar o mesmo diff para Claude, Codex, CodeRabbit, Greptile ou um revisor personalizado.
O que paralelizar#
Testes em módulos diferentes, bugs independentes, documentação, endpoints separados e tentativas concorrentes onde apenas uma será mantida funcionam bem.
Mantenha em sequência dois refactors do mesmo tipo central, uma migração e o código dependente dela, mudanças no mesmo arquivo gerado ou tarefas que compartilham um banco mutável.
O limite real é sua capacidade de revisão. Se os diffs prontos acumulam, mais agentes reduzem a produtividade.
Quando usar contêineres#
Worktrees isolam arquivos, não processos, portas, credenciais, pacotes globais ou serviços externos. Use o modo contêiner quando também precisar de limites de runtime, mounts ou rede.
Baixe o Agentastic para macOS ou leia Seu primeiro agente.