Como rodar múltiplos agentes de codificação de IA em paralelo com git worktrees

Uma das maiores mudanças no desenvolvimento assistido por IA ao longo de 2026 é que você não aponta mais um único agente para uma única tarefa. Ferramentas como Claude Code e Cursor agora incentivam rodar vários agentes em paralelo — um corrigindo um bug, outro escrevendo testes, um terceiro rascunhando uma funcionalidade. O porém: se todos eles editarem o mesmo diretório de trabalho, sobrescrevem as mudanças uns dos outros e corrompem o build.

A solução limpa é um recurso antigo do Git que se revela a primitiva perfeita para isso: os worktrees.

O que um worktree realmente é

Normalmente um repositório Git tem um único diretório de trabalho — a pasta onde você edita os arquivos. O git worktree permite que um repositório tenha vários diretórios de trabalho ao mesmo tempo, cada um com um branch diferente em checkout, todos compartilhando o mesmo histórico .git subjacente. Cada worktree é uma pasta real no disco, com seus próprios arquivos, então um agente trabalhando em um não consegue tocar nos arquivos de outro.

Pense nisso como dar a cada agente sua própria mesa no mesmo escritório, em vez de três pessoas brigando por um teclado.

O fluxo de trabalho central

De dentro do seu repositório, crie um worktree para cada tarefa em seu próprio branch:

# Create a new branch + folder for an auth bug fix
git worktree add ../myapp-auth-fix -b fix/auth-bug

# Another for a feature, in parallel
git worktree add ../myapp-search -b feat/search

# See everything you have checked out
git worktree list

Você agora tem duas pastas irmãs ao lado do seu repositório principal: myapp-auth-fix e myapp-search. Abra uma sessão de agente separada em cada uma — cd ../myapp-auth-fix e inicie o Claude Code ali, depois faça o mesmo em ../myapp-search em outra aba do terminal. Cada agente tem um checkout completo e independente. Eles rodam ao mesmo tempo, commitam em seus próprios branches e nunca colidem.

Quando uma tarefa termina, faça o merge de seu branch e remova o worktree para manter tudo organizado:

git checkout main
git merge fix/auth-bug
git worktree remove ../myapp-auth-fix

Um exemplo concreto

Digamos que você esteja construindo um pequeno app web e tenha três trabalhos independentes: corrigir um redirecionamento de login instável, adicionar paginação a uma lista e atualizar uma dependência lenta. Em vez de fazê-los um de cada vez:

git worktree add ../app-login   -b fix/login-redirect
git worktree add ../app-paging  -b feat/pagination
git worktree add ../app-deps    -b chore/upgrade-deps

Inicie um agente em cada pasta com um prompt focado. Enquanto o agente do login rastreia a lógica de redirecionamento, o agente da paginação já está escrevendo componentes, e o agente da dependência está rodando a atualização e a suíte de testes. Vinte minutos depois você revisa três branches separados e limpos e faz o merge dos que passam.

Dicas que mantêm a sanidade

• Mantenha as tarefas independentes. Os worktrees evitam conflitos de arquivo, mas se dois agentes editarem os mesmos arquivos em branches diferentes, você ainda vai bater em conflitos de merge no fim. Divida o trabalho por costuras naturais.
• Dê a cada worktree o mesmo contexto. Um CLAUDE.md (ou arquivo de regras equivalente) commitado no seu repositório viaja para cada worktree automaticamente, então cada agente herda suas convenções.
• Fique de olho nas pastas de dependências. node_modules, ambientes virtuais e caches de build não são compartilhados entre worktrees. Você pode precisar rodar npm install uma vez por worktree, ou usar um gerenciador de pacotes com um store global (pnpm, uv) para evitar baixar tudo de novo.
• Não paralelize demais. Na prática, de três a cinco agentes simultâneos é o ponto ideal. Além disso, o tempo que você gasta revisando e coordenando supera a velocidade que você ganha.

Integrações nativas de worktree vêm chegando às principais ferramentas desde o fim de 2025, e já existem lançadores dedicados que sobem sessões para você. Mas você não precisa de nenhum deles para começar — o git worktree add é embutido no Git, funciona hoje e é a forma mais confiável de deixar vários agentes de IA construírem para você ao mesmo tempo sem tropeçar uns nos outros.