learnaiwithrafa
ClaudeWorkflows

Agentes Claude em paralelo: isolar é de graça, revisar não

O Claude Code agora isola cada sessão paralela num `git worktree` próprio, automaticamente, e o Cowork divide tarefas grandes em partes que rodam juntas. Lançar agentes deixou de ser o problema — aqui vai o setup, mais a regra de revisão que impede três agentes de virarem três bagunças.

4 min de leitura3 fontes
  • #claude-code
  • #parallel-agents
  • #worktrees
  • #cowork

A parte difícil de rodar agentes Claude em paralelo sempre foi a que ninguém mostra no print: dois agentes editando a mesma pasta e sobrescrevendo o trabalho um do outro em silêncio. Esse problema agora vem resolvido de fábrica — no app desktop do Claude Code, cada sessão nova ganha automaticamente o próprio git worktree, um diretório de trabalho separado na própria branch. O que não está resolvido, e nenhuma ferramenta vai resolver, é que cada agente a mais gera mais um diff que você precisa ler. O lançamento é paralelo; a revisão continua sendo serial. Planeje em cima disso.

O setup no desktop, em quatro movimentos

  1. Crie sessões com Cmd+N (Ctrl+N no Windows). Cada sessão carrega o próprio histórico de conversa, o próprio contexto e — num repositório git — o próprio worktree, então as edições nunca colidem.
  2. Divida a tela. Segure Cmd (macOS) ou Ctrl (Windows) e clique numa sessão da barra lateral pra abri-la num segundo painel. Cmd+\ fecha o painel em foco; Ctrl+Tab alterna entre as sessões.
  3. Deixe a barra lateral legível. Use os controles do topo pra agrupar as sessões por projeto e renomeie cada sessão (clicando no título dela na barra de ferramentas) com o nome da tarefa — não "sessão 3".
  4. Pare de ficar conferindo. O app dispara uma notificação do sistema quando uma sessão termina e você não está olhando pra ela. Se você ainda troca de aba a cada minuto, está pagando o custo antigo por um recurso novo.

O que o isolamento por worktree te dá de verdade

Os worktrees ficam em .claude/worktrees/ dentro do projeto (adicione esse caminho ao .gitignore). Cada um é um checkout novo na própria branch — a CLI nomeia como worktree-<nome> — o que significa que arquivos ignorados pelo git, como o .env, não vêm junto, e o projeto pode nem subir dentro da sessão nova. Resolva isso uma vez só: crie um arquivo .worktreeinclude na raiz do projeto listando os arquivos ignorados que devem ser copiados pra cada worktree novo. Depois ative "Auto-archive after PR merge or close" nas configurações, pra que as sessões terminadas se arquivem sozinhas.

Prefere o terminal? claude --worktree feature-auth te dá o mesmo isolamento sem o app, numa branch chamada worktree-feature-auth. Dá até pra isolar subagents: adicione isolation: worktree no frontmatter de um subagent customizado e as edições dele nunca tocam o seu checkout principal.

A mesma ideia fora do código: Cowork

O Cowork — a aba do app desktop do Claude pra trabalho que não é código — aplica o mesmo padrão a documentos e pesquisa: divide uma tarefa grande em partes que rodam ao mesmo tempo, pesquisando e organizando enquanto redige. Está incluído em todos os planos pagos, do Pro a US$ 17/mês (no plano anual) até Max, Team e Enterprise. O teste do que delegar é o mesmo do código: só tarefas que não precisam do resultado uma da outra no meio do caminho.

O ângulo de EM

Os worktrees eliminaram o risco técnico dos agentes em paralelo — e é exatamente por isso que o risco humano cresce: nada impede um dev de abrir cinco sessões e carimbar cinco diffs às seis da tarde. A qualidade agora mora na hora do merge. No time, trate branch de agente como PR de engenheiro júnior — mesma régua de revisão, sem exceção porque "foi o agente que escreveu". Dois agentes com trabalho verificado de verdade valem mais que cinco que você só passou o olho.

Hoje: atualize o Claude Desktop, adicione .claude/worktrees/ ao seu .gitignore, crie um .worktreeinclude com o seu .env e rode exatamente duas sessões paralelas em tarefas que não se encostam — uma feature de verdade e uma tarefa chata que você verifica em minutos.

Fontes