Sessões paralelas do Claude Code: isolamento e handoff

Paralelismo só ajuda em tarefas separadas. Se duas mudanças precisam do mesmo arquivo, um owner assume e o trabalho é sequenciado. Para API separada, o guia BetterToken para Claude Code usa sua própria API Key; BetterToken não é assinatura Claude.ai nem conta compartilhada.

Mapeie arquivos e resultado

Tarefa	Escopo permitido	Pronta quando
amount vazio	parser/, tests/import/	retorna erro de validação
--dry-run	cmd/, tests/cli/	mostra plano sem gravar dados

Arquivo comum é sinal para parar o paralelo.

Isole com worktrees

git status --short
git worktree add ../project-fix-empty-amount -b fix/empty-amount
git worktree add ../project-cli-dry-run -b feat/cli-dry-run

Não esconda mudanças alheias. O worktree separa arquivos e branch; a sessão separa contexto, mas não resolve conflito.

Delimite o prompt

Informe pastas permitidas, proibições e teste. Se parser/schema.ts compartilhado for necessário, pare e registre o bloqueio em vez de ampliar o escopo.

Registre o handoff

Task: empty amount returns validation error
Worktree / branch: ../project-fix-empty-amount / fix/empty-amount
Changed: parser/amount.ts, tests/import/empty-amount.test.ts
Verified: npm test -- tests/import/empty-amount.test.ts
Not verified: full integration suite
Next: review diff before merge

Passe estado e comando reproduzível, não a conversa.

Verifique e reverta

git status --short
git diff --check
npm test -- tests/import/empty-amount.test.ts

A sessão seguinte entra no worktree e repete o comando. Sem reprodução, a mudança não está verificada: reverta ou devolva ao owner.

Permissões e segredos

Em conflito, um owner lê os dois diffs, integra o comportamento e roda ambos os testes. Não dê permissão ampla fora do escopo. API keys, cookies, .env, dados pessoais e logs sensíveis completos não entram em handoff ou commit.

CTA e fontes

Configure apenas sua chave pelo guia atual e entregue segredos pelo mecanismo normal.

• Claude Code documentation
• Git worktree documentation