iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more
O Claude Code roda no terminal e ajuda com tarefas de código e operações Git, mas as páginas oficiais da Anthropic que consultamos não descrevem um fluxo em que a própria ferramenta cria uma worktree para cada agente. Organizar agentes em paralelo com worktrees é possível como arranjo manual sobre o Git. O isolamento vem das worktrees e das branches do Git, e não de um recurso documentado do Claude Code.
O que a documentação oficial confirma
Três pontos são sustentados pelas fontes oficiais consultadas. Elas não trazem data editorial, por isso o que se afirma abaixo vale para o conteúdo que encontramos, sem garantia de que esteja na versão mais recente da ferramenta.
- Operação no terminal. A documentação de tarefas e fluxos de trabalho principais (versão em português da Anthropic) mostra o Claude Code operando diretamente no terminal, lendo e editando código e automatizando operações Git, como commits, pull requests e rebases.
- Modo não interativo. A mesma documentação descreve o modo
-p, útil em scripts, pipelines e GitHub Actions. Isso permite disparar execuções a partir de um script, mas não é, por si, um mecanismo de paralelismo. - Orientação sobre subagentes. A página de boas práticas de prompting (Anthropic) recomenda considerar subagentes quando as tarefas podem rodar em paralelo, exigem contexto isolado ou formam frentes independentes. É um princípio geral de delegação, e não uma instrução específica para Claude Code com Git worktrees.
O que não está estabelecido
A busca direcionada por documentação oficial que relacionasse worktrees a agentes paralelos não retornou resultados. A tabela separa o que foi confirmado do que não foi.
Free tools Windows power users keep installed
One-click scans. No signup required.
| Tema | Situação na documentação consultada |
|---|---|
| Claude Code opera no terminal e faz operações Git | Documentado (Anthropic, tarefas e fluxos de trabalho principais) |
Modo -p para scripts e pipelines |
Documentado (Anthropic, tarefas e fluxos de trabalho principais) |
| Subagentes para tarefas paralelas ou de contexto isolado | Orientação geral (Anthropic, boas práticas de prompting), não um procedimento de Claude Code |
| Claude Code cria ou gerencia worktrees | Not stated (nenhuma fonte oficial consultada descreve isso) |
| Uma sessão só enxerga a worktree em que foi aberta | Not stated (a referência da CLI não diz isso) |
| Resolução automática de conflitos entre agentes | Not stated (não há garantia documentada) |
Por que --add-dir não resolve o isolamento
A referência da CLI (Anthropic) lista --add-dir para adicionar diretórios de trabalho acessíveis à sessão, junto com controles de permissão e opções para continuar ou retomar conversas. Esse parâmetro amplia o que a sessão pode acessar. Ele não cria worktrees e não impede que duas sessões alterem os mesmos arquivos. Se você passar um diretório adicional a um agente, ele também poderá ler e alterar esse diretório, dentro das permissões que você concedeu.
Um arranjo manual com Git worktrees
Como não há um fluxo oficial do Claude Code para isso, o método abaixo é um desenho de trabalho do próprio usuário sobre o Git. Os comandos são de Git. Confirme a sintaxe com git help worktree na sua versão instalada antes de usar.
- Divida a tarefa em frentes independentes. Antes de iniciar, liste os arquivos que cada frente deve tocar. Se duas frentes precisarem do mesmo módulo, trate-as como uma só ou execute uma depois da outra.
- Crie uma branch e uma worktree por frente. Por exemplo:
git worktree add -b feature/tarefa-a ../projeto-tarefa-a main. Cada caminho vira um diretório de trabalho separado, com a própria branch checada. - Abra uma sessão do Claude Code em cada worktree. Entre no diretório da worktree e execute
claudeali. Evite--add-dirapontando para outra worktree, a menos que a tarefa realmente precise dela. - Restrinja cada prompt à sua frente. Diga quais arquivos podem ser alterados e quais não devem ser tocados. A documentação consultada não garante que o agente respeite essa separação sem instrução explícita.
- Revise cada branch antes de integrar. Use
git diff main...feature/tarefa-apara ver apenas o que a frente introduziu desde a base comum. - Integre no seu ritmo. Faça o merge ou o rebase na branch principal manualmente. Conflitos devem ser resolvidos por você, porque nenhuma fonte consultada descreve resolução automática.
- Remova as worktrees concluídas. Use
git worktree remove ../projeto-tarefa-ae, se restar algum registro órfão,git worktree prune.
Como reduzir a sobreposição entre agentes
O risco central não é a worktree em si, e sim duas frentes editarem o mesmo arquivo. A separação de diretórios evita que os agentes pisem no mesmo arquivo ao mesmo tempo, mas o conflito reaparece na integração. Algumas práticas diminuem esse custo:
- Escolha frentes com lista de arquivos disjunta, como um módulo de API e uma tela de interface.
- Evite atribuir a mesma alteração de configuração, de dependências ou de esquema de banco a mais de uma frente.
- Faça alterações compartilhadas, como tipos comuns ou utilitários, em uma etapa separada, antes de abrir as frentes paralelas.
- Integre as branches em ordem definida e rode os testes do projeto após cada integração.
Quando vale a pena e quando não vale
O arranjo faz mais sentido quando as frentes são grandes o bastante para justificar a sobrecarga de criar e limpar worktrees e de revisar várias branches. Para correções pequenas, uma única sessão costuma ser mais simples. Como o fluxo não é documentado pela Anthropic, trate-o como prática sua: meça o tempo de revisão e de integração no seu projeto antes de adotá-lo como padrão.
The Tool Desk
Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Em resumo, o Claude Code fornece o agente e o acesso ao terminal. As worktrees fornecem o isolamento de diretórios, e as branches fornecem a separação de histórico. A coordenação entre as duas partes é trabalho seu.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
