ClaudeAgents

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.

1 de jul de 20264 min de leitura2 fontes

#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, grep em logs, pesquisa de dependências — milhares de tokens queimam na janela do subagent, e só a conclusão volta pra sua.
Zero premissa herdada. Um subagent revisor 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

Mais guias parecidos com este.

ClaudeAgents11 min de leitura

12 loops de agente pra copiar (um deles não faz nada e não avisa)

O loop mais óbvio de todos — /loop 20m /code-review — não faz nada: o revisor embutido recusa ser chamado pelo modelo, então o disparo agendado chega como texto puro. Aqui vão 12 loops que rodam de verdade, agrupados pelo que realmente diferencia um do outro, mais os limites que matam loop em silêncio.

26 de jul de 20266 fontes

ClaudeAgents4 min de leitura

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.

2 de jul de 20263 fontes