Claude Code em paralelo

Três agentes, três worktrees

Como eu rodo várias sessões no mesmo repositório sem um pisar no código do outro.

O problema

Agentes no mesmo diretório brigam

Um formata, outro refatora, um checkout troca a branch. Paralelismo vira conflito em tempo real.

A ferramenta

git worktree

Um diretório de trabalho extra, com branch própria, compartilhando o mesmo .git e histórico. Não é clone.

No Claude Code

claude --worktree nome

Cria .claude/worktrees/nome numa branch worktree-nome e abre a sessão isolada lá dentro.

Isolamento de verdade

Regra, não pedido

Dentro do worktree, o Claude Code bloqueia edição e git apontando para o checkout principal.

Pegadinha nº 1

Cadê o .env?

Worktree é checkout novo. Liste os arquivos ignorados que devem ir junto no .worktreeinclude.

Meu fluxo

Uma manhã, três terminais

Feature que eu acompanho, bug com teste e uma tarefa mecânica rodando sozinha. Atenção só onde vale.

Escala

Subagentes isolados

isolation: worktree no frontmatter do subagente. O /batch divide uma mudança grande entre 5 e 30 deles.

Onde quebra

Isolar não é independer

Mesmos arquivos, mesmo banco local e revisão demais: o conflito só muda de lugar.

Quando eu não paralelizo

Um agente só, às vezes

Tarefa exploratória, bug urgente de produção e mudança de arquitetura que atravessa o projeto.

Artigo completo

Comandos, prompt e limpeza

O fluxo inteiro, com exemplos e fontes oficiais. E mais IA na prática no Labs de IA.

Ler o artigo