Claude Code: como /fork e subagentes aninhados cortam tokens (v2.1.172/173)

Passei os últimos dias testando duas mudanças recentes do Claude Code que mexem direto na conta de tokens de quem roda agente no terminal o dia todo. Como achei pouca coisa em português sobre isso, deixo o resumo prático aqui.

O que mudou

Subagentes aninhados, até 5 níveis (v2.1.172)

Por quase todo 2026 a regra era dura: subagente não abria outro subagente. Isso caiu em 10/jun. Agora dá pra montar uma árvore de subagentes (5 níveis é o teto). O ponto que importa pra custo: os filhos 2–5 compartilham o cached prefix do pai, então o custo do contexto compartilhado cai para ~o equivalente a um filho a mais — em vez de reprocessar tudo de novo a cada agente.

/fork em sessão não-interativa (v2.1.173)

O /fork cria um branch da conversa no estado atual: você explora um caminho, dá /resume e volta ao ponto para tentar outro, sem refazer o contexto. A novidade é que CLAUDE_CODE_FORK_SUBAGENT=1 passou a funcionar em sessão não-interativa/SDK (e em CI/CD automaticamente quando a env var está no ambiente).

Por que isso pesa no custo

O gargalo de quem usa agente o dia todo não é o "preço por token", é o retrabalho de contexto: reenviar o mesmo histórico e os mesmos arquivos a cada nova tarefa. As duas mudanças atacam isso — o fork reaproveita o branch e os subagentes aninhados compartilham o prefixo em cache mantendo cada contexto enxuto. Na prática, dá para paralelizar tarefa pesada sem multiplicar o consumo.

Quando usar cada um

• /fork: explorar mais de uma abordagem a partir do mesmo ponto (ex.: duas refatorações) sem perder o caminho anterior.
• Subagente aninhado: decompor uma tarefa grande em subtarefas com contexto próprio e curto, rodando em paralelo.

Duas pegadinhas

• Aninhar demais vira difícil de auditar. 5 níveis é teto, não meta.
• /fork em CI sem entender a env var pode disparar comportamento inesperado no pipeline.

Montei um guia mais completo, com as tabelas de custo em tokens e o passo a passo, aqui: https://neuroniosartificiais.com.br/subagentes-claude-code/

Quem aqui já está rodando subagente aninhado em produção? Queria saber se o ganho de token bateu na prática de vocês.