DEV Community

Cover image for Subagentes do Claude Code agora consomem menos do seu limite de uso
Lucas
Lucas

Posted on Originally published at apidog.com

Subagentes do Claude Code agora consomem menos do seu limite de uso

Subagentes do Claude Code agora consomem menos do seu limite de uso

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.

Experimente o Apidog hoje

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.

Diagrama comparando dois fluxos: antes, toda a conversa do subagente alimentava cada atualização de status a cada 30 segundos; agora, anotações curtas vão para o Haiku 5.5, que escreve a atualização com cerca de 99% menos custo por atualização

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

Comparação em barras: uma atualização de status cai cerca de 99%, enquanto uma sessão inteira com subagentes em segundo plano cai cerca de 5%, conforme informado pela Anthropic

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
Enter fullscreen mode Exit fullscreen mode

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"
  }
}
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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.
Enter fullscreen mode Exit fullscreen mode

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.
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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.

Top comments (0)