Dá para rodar mais de uma sessão do Claude Code ao mesmo tempo, cada uma em um diretório de trabalho separado, usando git worktree, recurso do próprio Git que cria árvores de trabalho extras a partir do mesmo repositório. O que a documentação oficial da Anthropic consultada não traz é um procedimento específico do Claude Code para worktrees. As páginas oficiais tratam do uso no terminal, do modo não interativo, das opções da CLI e de uma orientação geral sobre subagentes. Este guia separa o que é documentado do que é um fluxo montado com comandos Git padrão.
O que a documentação oficial da Anthropic estabelece
- O Claude Code opera diretamente no terminal e auxilia na compreensão e edição de código e em operações Git, como commits, pull requests e rebases. Isso consta na página “Tarefas e fluxos de trabalho principais”, em português.
- O modo não interativo, com a opção
-p, é descrito como útil em scripts, pipelines e GitHub Actions (mesma página). - A referência da CLI (“CLI reference”) lista
--add-dirpara adicionar diretórios de trabalho acessíveis à sessão, além de controles de permissão e opções para continuar ou retomar sessões. - A página “Prompting best practices” orienta considerar subagentes quando tarefas podem ser executadas em paralelo, exigem contexto isolado ou representam frentes independentes. Trata-se de princípio geral de delegação da Anthropic, não de um recurso específico do Claude Code.
As páginas consultadas não trazem data editorial visível. Antes de usar as opções citadas em um script ou em um fluxo de equipe, confira a versão atual da documentação e a saída de claude --help na sua instalação.
As an Amazon Associate I earn from qualifying purchases.
O que essas fontes não estabelecem
--add-dirnão cria worktrees. A opção apenas dá acesso a um diretório adicional.- Não há base documentada para afirmar que sessões em paralelo compartilhem ou deixem de compartilhar estado, que cada diretório seja isolado por worktree ou que conflitos de edição sejam resolvidos automaticamente.
- Não há garantia documentada de que dois agentes não editem o mesmo arquivo.
- Não há descrição de permissões aplicadas por worktree. Os controles de permissão citados existem na CLI, mas seu escopo por diretório não é detalhado nas fontes consultadas.
O que é um Git worktree
Um repositório Git normal tem uma única árvore de trabalho, com uma branch checada por vez. O comando git worktree cria árvores de trabalho adicionais ligadas ao mesmo repositório. Histórico, objetos e remotes são compartilhados; os arquivos checados e a branch de cada árvore são independentes. Duas regras do Git importam aqui: a mesma branch não pode estar checada em duas worktrees ao mesmo tempo (sem forçar), e arquivos não rastreados ou ignorados, como .env e node_modules, não são copiados para a nova worktree. Confirme esses comportamentos na documentação do comando git-worktree na versão do Git que você usa.
Fluxo prático em cinco etapas
Este fluxo combina comandos Git padrão com a execução do Claude Code dentro de cada diretório. O Claude Code não cria nem integra as worktrees por conta própria.
1. Escolha tarefas com pouca sobreposição
Um bom par de tarefas toca áreas diferentes do projeto, por exemplo “adicionar testes ao módulo de pagamentos” e “ajustar o layout da página de perfil”. Tarefas como “melhorar o projeto” misturam arquivos e tornam a integração difícil.
2. Crie uma branch e uma worktree por tarefa
Execute os comandos a partir de uma branch principal atualizada, pois -b usa o HEAD atual como base:
git worktree add ../projeto-pagamentos-testes -b feat/testes-pagamentos
git worktree add ../projeto-perfil-layout -b feat/layout-perfilColocar as worktrees fora da pasta principal evita confundir os diretórios.
Free tools Windows power users keep installed
One-click scans. No signup required.
3. Abra uma sessão do Claude Code em cada worktree
Entre em cada diretório e inicie a CLI ali:
cd ../projeto-pagamentos-testes
claudePara tarefas não interativas, a opção -p aceita um prompt direto. Se uma sessão precisar ler outra worktree, use --add-dir com o caminho, por exemplo claude --add-dir ../projeto-perfil-layout. Isso amplia o que a sessão pode acessar, então use apenas quando necessário e revise o que ela altera.
4. Revise cada branch separadamente
Antes de integrar, veja as mudanças de cada tarefa e rode os testes dentro da própria worktree:
git -C ../projeto-pagamentos-testes status
git -C ../projeto-pagamentos-testes diff main...HEADSe a branch main tiver avançado, faça merge ou rebase dela na branch da tarefa antes da integração.
5. Integre pelo fluxo normal e remova as worktrees
A integração acontece pelo merge ou pull request do seu editor ou da sua plataforma de hospedagem, não por um recurso automático do Claude Code. Depois, remova a worktree e confira a lista:
Outdated Drivers Are Slowing You Down
One free scan finds every outdated or missing driver and matches the right update for your exact hardware.Free scan · exact hardware matchPC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11git worktree remove ../projeto-pagamentos-testes
git worktree listSe você apagou a pasta manualmente, git worktree prune limpa as referências órfãs.
Como reduzir a chance de agentes alterarem os mesmos arquivos
São práticas de organização, não garantias da ferramenta:
- Divida o trabalho por módulo ou pasta, com um dono para cada área.
- Identifique arquivos compartilhados, como lockfiles, configurações de build, tipos globais e tabelas de rotas. Atribua-os a apenas uma tarefa ou faça-os manualmente depois.
- Use uma branch e uma worktree por sessão. Não abra duas sessões na mesma worktree.
- Peça a cada sessão, antes de editar, a lista de arquivos que pretende alterar, e interrompa se houver sobreposição com outra tarefa.
- Rode os testes em cada worktree separadamente e, depois, na branch integrada.
Subagentes, worktrees ou sessão única
As três abordagens têm trade-offs diferentes. A tabela resume o que as fontes e o comportamento do Git permitem afirmar; onde não há base, o texto diz isso.
Quick Recap
| Critério | Subagentes (orientação geral da Anthropic) | Sessões em worktrees separadas (Git) | Sessão única, em sequência |
|---|---|---|---|
| Isolamento de arquivos | Não estabelecido nas fontes consultadas para o Claude Code | Por diretório e branch, conforme o comportamento do Git | Não há isolamento; um único diretório |
| Sobreposição entre tarefas | Indicado para frentes independentes, segundo a orientação geral | Reduzida se as tarefas forem separadas; conflitos aparecem na integração | Não se aplica; tarefas ocorrem uma após a outra |
| Revisão e integração | Não detalhada nas fontes consultadas | Uma branch por tarefa, integrada pelo fluxo normal | Uma sequência de alterações |
| Custo operacional | Não estabelecido nas fontes consultadas | Criar e remover worktrees; reinstalar dependências em cada uma | Mínimo, mas mais lento para tarefas longas |
| Controles de permissão | Não detalhados nas fontes consultadas | Por sessão, pelas opções da CLI; escopo por worktree não documentado | Uma configuração para todo o trabalho |
Quando não vale a pena
- Tarefas pequenas, em que o custo de criar e limpar worktrees supera o ganho de tempo.
- Refatorações amplas ou mudanças que atravessam o projeto inteiro.
- Projetos que dependem de portas fixas, bancos de dados locais ou serviços únicos, pois duas sessões podem competir pelo mesmo recurso.
- Trabalhos cujas dependências precisam ser instaladas e configuradas manualmente em cada worktree.
“
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.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
