Subagentes do Claude Code gastam o limite mais rápido?

Por que subagentes gastam mais do seu limite

Três fatos da documentação de subagentes da Anthropic explicam:

• Contexto novo. Cada subagente começa com uma janela de contexto nova e isolada. Ele não vê o histórico da conversa nem os arquivos que o Claude já leu, então pode ler de novo.
• Requisições próprias. O subagente faz requisições próprias, que contam para os mesmos limites de uso da conversa principal.
• Os resultados voltam. Quando os subagentes terminam, os resultados voltam para a conversa principal. Muitos subagentes que devolvem resultados longos podem ocupar bastante contexto, e cada um gasta tokens próprios enquanto roda.

Nada disso é bug. É o custo do isolamento. A pergunta é qual modelo paga a conta.

Em qual modelo o subagente roda

Quando o arquivo do agente não fixa o modelo, o Claude Code escolhe nesta ordem:

1. O parâmetro model da chamada.
2. O model no frontmatter da definição do subagente, em que inherit usa o modelo da conversa principal.
3. A variável de ambiente CLAUDE_CODE_SUBAGENT_MODEL.
4. O modelo da conversa principal.

Então, se nada define o modelo, o subagente roda no modelo principal: Opus ou Fable em muitas sessões. A documentação acrescenta que CLAUDE_CODE_SUBAGENT_MODEL é um padrão, então a definição do subagente ou um modelo que o Claude passe ainda vencem.

A armadilha do Explore

O agente embutido Explore é rápido e somente leitura, feito para buscar e analisar o código. Ele roda no modelo da conversa principal. Quando a conversa principal roda Fable numa assinatura do Claude, o Explore roda no Opus. E definir CLAUDE_CODE_SUBAGENT_MODEL sozinha não muda o modelo do Explore e do Plan.

Busca é o trabalho mais mecânico de uma sessão, e num modelo grande é o consumo mais fácil de desperdiçar. A Central de Ajuda da Anthropic diz que o Opus custa várias vezes mais por turno que o Sonnet, e o Sonnet mais que o Haiku, e que gastar Opus em trabalho rotineiro é o jeito mais rápido de esgotar um limite diário.

Como colocar subagentes num modelo menor

Para mover o próprio Explore, defina um agente seu chamado Explore. A documentação diz que um subagente de usuário ou de projeto com esse nome e um campo model substitui o embutido:

---
name: Explore
description: Busca somente leitura no código. Acha arquivos, lê e responde.
model: haiku
---
Busque e leia o código para responder à pergunta. Não edite arquivos.

Para os outros subagentes que não definem nada, uma variável basta:

export CLAUDE_CODE_SUBAGENT_MODEL=haiku

Crie também menos subagentes e mais focados. Cada um relê contexto e cada resultado volta para a conversa principal.

Escolher por tarefa, não por agente

Todas as alavancas acima fixam um modelo para um tipo de agente inteiro. Um rename e uma revisão de arquitetura que usam o mesmo tipo de agente recebem o mesmo modelo.

O Downshift é um hook gratuito e open source que aplica o modelo que o Claude escolheu em cada chamada, dentro de uma política que você declara, e mantém o modelo pedido na dúvida. O downshift policy init oferece um perfil explore que manda o Explore para o tier pequeno e mostra em qual modelo isso resolve antes de gravar qualquer coisa. O perfil chegou depois da versão 0.11.0. Como todo perfil declarado, ele também vale quando a chamada nomeia um modelo, então apague-o se quiser que o Claude escolha pelo Explore.

O downshift report mostra, por harness, quantos tokens cobráveis rodaram abaixo do modelo da sessão. Ele mostra tokens, não dinheiro, e não mede o limite do seu plano.

Perguntas frequentes

Subagentes do Claude Code contam no meu limite de uso?

Sim. A documentação da Anthropic diz que o subagente faz requisições próprias, que contam para os mesmos limites de uso da conversa principal.

CLAUDE_CODE_SUBAGENT_MODEL muda o subagente Explore?

Não. A documentação diz que defini-la sozinha não muda o modelo dos agentes embutidos Explore e Plan. Defina um agente seu chamado Explore com o campo model.

Qual modelo um subagente usa por padrão?

O modelo da conversa principal, a menos que a chamada, o arquivo do agente ou CLAUDE_CODE_SUBAGENT_MODEL definam outro, nessa ordem.

Subagentes no Haiku fazem trabalho pior?

Em busca, leitura de arquivos e edições mecânicas a própria Anthropic sugere o Haiku. Deixe trabalho de julgamento, como design e mudanças arriscadas, no modelo principal. Num teste controlado do Downshift com tarefas mecânicas, só o roteamento rodou cerca de 24% menos tokens por execução aceita (estudo pré-O8) (2026-10-21, uma pessoa, 46 execuções, intervalo de +2,1% a +46,7%).

Guias relacionados

• Qual modelo cada subagente usa no Claude Code
• O limite de uso do Claude Code acaba rápido: de onde vem o consumo
• Limite semanal do Claude Code explicado: reset, planos e o que o consome

Fontes

1. Anthropic docsmedido
   code.claude.com/docs/en/sub-agents
   contexto novo, ordem de resolução do modelo, modelo do Explore, limites de uso, conselho de custo; os primeiros 100.000 de 116.722 caracteres lidos (fetched 2026-11-07)
2. Central de Ajuda da Anthropicmedido
   Models, usage, and limits in Claude Code
   custo relativo de Opus, Sonnet e Haiku por turno; CLAUDE.md enviado a cada turno (fetched 2026-11-07)
3. Downshift repomedido
   docs/guides/policy.md
   o perfil explore oferecido pelo policy init; precedência de perfis
4. Downshift repomedido
   docs/guides/evidence.md
   o que cada número de economia significa e quais não estão provados