Subagents: gaste tokens sem gastar o seu contexto
Os dados da própria Anthropic mostram que os tokens que um agente gasta explicam a maior parte da performance — só que, numa sessão única, todo token cai na mesma janela que guarda o seu plano. Subagents quebram esse vínculo. Aqui vai o arquivo de três linhas, os padrões que mudaram e quando pular essa ferramenta.
- #claude-code
- #subagents
- #context
- #delegation
O dado que fez os subagents fazerem sentido pra mim está escondido no relato da Anthropic sobre o sistema de pesquisa deles: nas avaliações de navegação, o uso de tokens, sozinho, explicou 80% da variação de performance. Na maioria dos casos, gastar mais tokens num problema é justamente como um agente fica melhor nele. O problema: numa sessão única, cada um desses tokens se acumula na mesma context window que guarda as suas instruções, o seu plano e os seus diffs — até o que importa afundar no meio do ruído.
O subagent é o mecanismo que quebra esse vínculo. Ele deixa o Claude gastar tokens num problema em outro lugar e te devolver só um resumo. Esse é o modelo mental certo: não é um Claude menor — é uma segunda context window que você aluga por tarefa.
O que você está comprando de verdade
Um subagent roda com a própria context window, o próprio system prompt e as próprias permissões de ferramentas. Ele nunca vê a sua conversa — recebe as instruções dele mais o básico, tipo o diretório de trabalho, e nada além disso. Duas consequências:
- A bagunça fica de fora. Saída de testes,
grepem logs, pesquisa de dependências — milhares detokensqueimam na janela dosubagent, e só a conclusão volta pra sua. - Zero premissa herdada. Um
subagentrevisor lê o trabalho frio, então não carrega o raciocínio que produziu o bug. A folha em branco é o recurso, não a limitação.
O gatilho que eu uso: se uma tarefa paralela vai inundar a conversa principal com saída que eu nunca mais vou consultar, ela vai pra um subagent.
Um subagent customizado é um arquivo Markdown
Salve isso em .claude/agents/ (escopo do projeto, entra no git) ou em ~/.claude/agents/ (todos os seus projetos):
---
name: log-triage
description: Digs through test output and logs to isolate the failing case. Use proactively when tests fail.
tools: Read, Grep, Glob, Bash
model: haiku
---
You investigate failures. Report back only: the failing test, the exact
error, and the most likely file to fix. No log dumps.
Só name e description são obrigatórios — o Claude decide quando delegar lendo a description, e escrever "use proactively" ali realmente empurra a decisão. tools funciona como allowlist (esse aí não consegue escrever arquivo). model herda o modelo da sessão por padrão; apontar o trabalho braçal pro haiku é a otimização mais barata disponível no Claude Code. Os dois diretórios são monitorados, então uma edição vale em segundos, sem reiniciar nada. Digite @ e mencione o agente quando quiser forçar a delegação em vez de deixar na mão do Claude.
Os padrões mudaram faz pouco tempo
Duas mudanças que valem saber. Desde a v2.1.198, subagents rodam em segundo plano por padrão — o Claude continua na sua tarefa enquanto eles trabalham, e o resultado chega como notificação. E subagents podem criar os próprios subagents, até três camadas abaixo da sua conversa — um revisor que despacha um verificador por achado, sem nenhuma saída intermediária encostar na sua janela.
Quando é a ferramenta errada
O contexto limpo se paga com latência: um subagent começa em branco e precisa levantar o próprio contexto do zero. Edições rápidas e pontuais, trabalho que exige ida e volta com você e fases que realmente compartilham contexto ficam na conversa principal. E cuidado com o caminho de volta — cinco subagents devolvendo cada um relatório detalhado poluem de novo exatamente a janela que você estava protegendo. Peça resumo, sempre.
O ângulo de EM
Uma pasta .claude/agents/ no controle de versão é a política de delegação do seu time em forma de código. Como a gente revisa, como a gente tria falha, o que um agente de pesquisa pode tocar — o próximo contratado clona o repositório e herda tudo isso, limites de ferramenta incluídos.
Hoje: crie um arquivo — um log-triage ou code-reviewer só de leitura em .claude/agents/, com tools: Read, Grep, Glob — e mande a próxima tarefa barulhenta passar por ele. Depois repare em quanto a sua janela principal ficou mais enxuta.
Fontes
Continue lendo
Mais guias parecidos com este.
Divida seus agentes por contexto, não por cargo
A maioria dos sistemas multiagente quebra porque a pessoa divide o trabalho como dividiria num time — quem planeja, quem escreve, quem testa. A própria Anthropic chama isso de anti-padrão. Aqui está a divisão que funciona, e a conta que vem junto.
Skill, workflow ou agente? Uma pergunta decide
Muito dev parte pro agente quando um workflow de 20 linhas resolveria mais barato, mais rápido e sem surpresa. Essa é a escada de três níveis, com as definições da própria Anthropic — e a única pergunta que diz qual construir.
O playbook da Anthropic pra times de humanos e agentes de IA
A Anthropic publicou como os próprios times dela trabalham com agentes Claude — e as quatro lições são habilidade de gestão, não truque de prompt. Aqui vai o playbook, e como eu aplicaria como EM mesmo sem uma frota de agentes.