Os subagentes do Claude Code agora consomem menos do seu limite de uso. A Anthropic mudou a linha de status dos subagentes em segundo plano: em vez de reler toda a conversa, o Haiku 5.5 agora trabalha a partir de anotações curtas. Cada atualização custa cerca de 99% menos, e sessões com subagentes em segundo plano usaram cerca de 5% menos do limite. Atualize para a v2.1.316 ou posterior para obter o recurso.
Essa é a história completa em quatro frases. O restante deste post aborda quem recebe a mudança, o que as duas porcentagens significam, o que permanece desconhecido e quais configurações reduzem ainda mais o uso dos subagentes.
O que mudou nos subagentes do Claude Code
Um subagente em segundo plano é um auxiliar que roda junto com a sua sessão principal enquanto você continua trabalhando. No terminal, ele exibe uma linha de status curta para você acompanhar o que está fazendo, e essa linha é atualizada a cada 30 segundos.
A Anthropic anunciou a mudança no X em 5 de novembro de 2026:
- Antes: cada atualização de 30 segundos relia toda a conversa do subagente.
- Agora: o Haiku 5.5 escreve a atualização a partir de anotações curtas.
- Sem alteração: o subagente mantém o próprio modelo. Se ele roda no Opus 5.5 ou no Sonnet 5.5, continua assim. Apenas a linha de status migrou para o Haiku 5.5.
Você não precisa alterar nenhuma configuração nem abrir mão da qualidade do trabalho em si. A saída do subagente vem do mesmo modelo de antes.
Por que a linha de status de um subagente era cara
A linha de status era cara porque um resumo de uma linha pagava a leitura completa de uma conversa longa. A saída era minúscula, mas a entrada não — e a tarefa se repetia a cada 30 segundos durante todo o tempo em que o subagente rodava.
A aritmética mostra a rapidez com que isso se acumula. Com uma atualização a cada 30 segundos, um subagente rodando por uma hora gera 120 atualizações. Três rodando por uma hora geram 360.
O comprimento da conversa também pesa. A documentação de custos do Claude Code diz que o custo em tokens escala com o tamanho do contexto, e a conversa de um subagente cresce à medida que ele lê arquivos e executa ferramentas. Ou seja, o design antigo provavelmente cobrava mais justamente quando um subagente de longa duração acumulava mais contexto. Essa é a nossa leitura da documentação, já que a Anthropic não publicou uma curva de custos para isso.
Não confunda isso com a linha de status personalizada que você configura com o /statusline. A documentação da linha de status diz que essa roda localmente e não consome tokens da API. A mudança aqui se refere à linha de status que o Claude Code gera para cada subagente em execução.
Os números: 99% por atualização, cerca de 5% por sessão
Os dois números medem coisas diferentes, e apenas um deles descreve o seu limite.
| Número | O que mede | O que não é |
|---|---|---|
| Cerca de 99% menos | O custo de uma atualização de status | Uma economia na sua fatura ou no seu limite |
| Cerca de 5% menos | O limite usado por sessões com subagentes em segundo plano | Uma economia em sessões sem eles |
| Cerca de 6% a mais | Prompts que você obtém com o mesmo limite, segundo a Anthropic | Um aumento do limite em si |
Se você for lembrar de um único número, que seja o 5%. Um corte de 99% em algo que era uma pequena parte da sessão resulta em uma economia pequena na sessão como um todo. Os subagentes continuam fazendo o trabalho real com o próprio modelo, e é esse trabalho que consome a maior parte do uso.
A Anthropic não disse quanto do limite as atualizações de status consumiam antes. Os dois números, juntos, sugerem cerca de um vigésimo dessas sessões, mas isso é uma inferência a partir de valores arredondados, não um dado publicado.
A sua economia também vai variar. Os cerca de 5% são o que a Anthropic reporta no conjunto de sessões com subagentes em segundo plano. A empresa não publicou uma faixa, e uma sessão com um único subagente curto tem menos a ganhar do que uma com vários longos.
Quem recebe a redução no uso dos subagentes
A Anthropic diz que a mudança está ativa para a maioria dos planos individuais e todos os planos de organização, apenas na CLI.
| Onde você usa o Claude Code | Situação |
|---|---|
| Pro, Max, Ultra | Ativo para a maioria dos usuários, não para todos |
| Team, Enterprise | Ativo para todos |
| CLI | Incluído, na v2.1.316 ou posterior |
| App para desktop | Nada a mudar: ele não gera essa linha de status |
| API key, Bedrock, Vertex, Foundry | Não informado |
O detalhe sobre o desktop vem de uma resposta no mesmo tópico, de Lydia Hallie, da Anthropic, que disse que o app para desktop não gera essa linha de status do subagente, então não havia nada a mudar lá.
Duas lacunas valem a pena conhecer:
- “A maioria” não tem um teste público. O tópico e a documentação não citam nenhuma flag ou indicador que mostre se a sua conta Pro, Max ou Ultra já tem o recurso. Estar na versão correta é necessário, mas não prova que a mudança está ativa para você.
- Quem paga por token ainda não tem resposta. A Anthropic tratou do tema em termos de limites de planos e não abordou configurações com chave de API ou provedores de nuvem. O changelog da 2.1.318 de fato altera os resumos de progresso de subagentes no Bedrock, Vertex e Foundry, ou com a telemetria desativada: com um cache de prompt frio, pode-se esperar até 5 minutos pela resposta pendente do subagente. Isso mostra que essas configurações têm um tratamento próprio, e não que recebem essa economia.
As entradas do changelog da 2.1.316 que lemos também não mencionam a linha de status, então o tópico é a única fonte para os números e a versão.
Como atualizar o Claude Code e verificar a sua versão
Três comandos resolvem:
claude --version # needs to show 2.1.316 or later
claude update # installs a newer version if one exists
claude --version # confirm
O claude update também funciona em instalações feitas por gerenciador de pacotes, atualizando por meio desse gerenciador. A versão mais recente listada no changelog em 5 de novembro era a 2.1.318.
Para ver o que os subagentes consomem, execute o /usage dentro de uma sessão. Nos planos Pro, Max, Ultra, Team e Enterprise, ele atribui o uso recente a skills, subagentes, plugins e servidores MCP, em percentuais. Pressione d ou w para alternar entre 24 horas e 7 dias. Os números são aproximados e vêm do histórico local daquela máquina, então trate uma comparação antes e depois como um guia aproximado. Se você acompanha os limites de perto, o nosso guia de limites do Claude Pro e Max explica como eles funcionam.
Outras formas de gastar menos com subagentes
A correção da linha de status é automática, mas rende cerca de 5%. A documentação é clara quanto ao resto: cada subagente envia as próprias requisições, e elas contam para o mesmo limite da sua conversa principal. Essas configurações têm mais margem para ajudar.
Escolha um modelo menor. Um subagente herda o modelo da sua sessão, a menos que seja definido o contrário, então uma troca para o Opus também vale para esses subagentes. Defina model: haiku na definição de um subagente para tarefas simples. Nosso guia sobre o Claude Haiku 5.5 no Claude Code cobre essa configuração.
Para definir um padrão para todos:
{
"env": {
"CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
"CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
}
}
A primeira variável sozinha funciona apenas como padrão. A definição de um subagente ou um modelo que o Claude passar ainda prevalece, e ela não muda os subagentes internos Explore e Plan. A segunda força um único modelo em todos os subagentes.
Reduza o nível de esforço. A versão 2.1.316 adicionou a CLAUDE_CODE_SUBAGENT_EFFORT, que define o nível de esforço dos subagentes quando nada mais especifica um, em vez de herdar o da sessão. Ela aparece no changelog, mas não estava na referência de variáveis de ambiente em 5 de novembro, então verifique os valores aceitos antes de contar com ela. Para um subagente específico, defina o campo effort documentado na definição dele (low, medium, high, xhigh ou max, dependendo do modelo).
Rode menos ao mesmo tempo. O limite padrão é de 20 subagentes em execução por sessão. Defina a CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS com um número inteiro menor se quiser um teto rígido. Execute o /tasks para ver o que está rodando e qual modelo e nível de esforço cada subagente usa.
Mantenha o escopo restrito. A documentação de custos observa que pedidos vagos disparam varreduras amplas. Um subagente orientado a verificar um único endpoint lê menos do que um encarregado de revisar a API. Nosso guia sobre criar subagentes personalizados do Claude Code detalha o formato completo das definições.
Execute testes de API em um subagente em segundo plano com a Apidog CLI
Execuções de testes de API são um bom caso para um subagente em segundo plano: demoram, produzem saída verbosa e, no fim, você só precisa das falhas. A Apidog CLI permite que o subagente execute um cenário de teste salvo enquanto a sua sessão principal segue programando, e a saída bruta fica fora do seu contexto principal.
Configure uma única vez:
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick Claude Code when prompted
Depois, adicione um subagente pequeno no arquivo .claude/agents/api-tester.md:
---
name: api-tester
description: Runs Apidog test scenarios and reports only the failures.
tools: Bash, Read
model: haiku
background: true
---
Run the Apidog test scenario you are given. Report which steps failed
and why. Don't paste the full output.
Agora, dê um único prompt ao Claude Code:
Use the api-tester subagent to run Apidog test scenario <scenarioId> in
project <projectId> against environment <environmentId>. Keep working on
the checkout refactor. When it finishes, tell me only what failed.
O subagente executa comandos como estes:
apidog test-scenario list --project <projectId>
apidog test-scenario run <scenarioId> --project <projectId> -e <environmentId> -r cli,json --out-dir apidog-reports
Pedidos de permissão de um subagente em segundo plano aparecem na sua sessão principal, indicando qual subagente está pedindo. Para execuções longas, a versão 2.1.318 também move um comando de shell para o segundo plano após 3 minutos, para que o cache de prompt não expire enquanto ele roda.
O mesmo comando run funciona em CI com -r junit, como mostra o guia de CI/CD da Apidog CLI. Para a configuração geral, consulte Apidog CLI no Claude Code. O plano Free da Apidog cobre até 4 usuários.
FAQ
Os subagentes do Claude Code agora custam 99% menos? Não. Os 99% se aplicam a cada atualização de status. A Anthropic diz que sessões com subagentes em segundo plano usaram cerca de 5% menos do limite.
Meu subagente agora roda no Haiku 5.5? Não. O subagente mantém o próprio modelo. Apenas a linha de status migrou para o Haiku 5.5.
Qual versão eu preciso? v2.1.316 ou posterior. Execute claude --version para verificar e claude update para atualizar.
Isso se aplica ao app para desktop do Claude? Não, porque não havia nada a mudar. Lydia Hallie, da Anthropic, disse que o app para desktop não gera essa linha de status do subagente.
Já está ativo no meu plano Pro? Provavelmente, mas não com certeza. A Anthropic diz que a maioria dos usuários Pro, Max e Ultra já tem o recurso, assim como todos os do Team e Enterprise. O tópico e a documentação não indicam uma forma de verificar na sua conta.
Isso ajuda se eu usar uma chave de API ou o Bedrock? A Anthropic não disse. O anúncio fala sobre limites de uso e não aborda o uso com chave de API, Bedrock ou Vertex.