Estas 5 palavras custam 12% do seu uso do Claude Code

Highlights

• Os resumos automáticos de agentes em segundo plano consomem entre 5% e 20% do uso total de assinaturas no Claude Code.

• O Claude Code envia a conversa inteira a cada 30 segundos para gerar uma descrição de 3 a 5 palavras sobre a atividade do agente.

• O custo dessas chamadas repetidas alcança cerca de 40.000 tokens de entrada para retornar apenas 130 tokens de saída.

• As execuções de resumo utilizam o modelo Opus em vez de uma alternativa mais econômica, como o Haiku.

• Os arquivos de transcrição JSONL do Claude Code omitem o registro desses resumos, mascarando o consumo real nos utilitários de uso.

• A configuração 'claude code fork subagents' definida como zero desativa os subagentes ramificados e elimina completamente o custo do resumo.

Timeline

1. 00:00 - 03:38

   Impacto dos resumos de agentes no consumo de tokens

   O sistema monitora a atividade dos agentes em segundo plano gerando descrições resumidas de poucas palavras de forma recorrente. A análise de telemetria revela que o volume de dados enviados cresce à medida que a conversa avança, acumulando milhares de tokens desnecessários. Diferentes medições da comunidade e da própria Anthropic situam esse gasto entre 2% e 20% do uso total do terminal. Esse consumo passa despercebido nas ferramentas comuns de rastreamento porque os arquivos JSONL padrão não registram essas requisições específicas.

   • O Claude Code executa um processo a cada 30 segundos que envia todo o histórico de conversas para descrever a tarefa do agente.
   • Testes práticos com exportação OpenTelemetry demonstram que esses resumos representam de 8% a 12% do custo de uma sessão.
   • Cada chamada de resumo processa cerca de 40.000 tokens de entrada para gerar uma resposta curta com o modelo Opus.
2. 03:39 - 05:15

   Alternativas para contornar e desativar os resumos

   A ausência de uma configuração simples de desativação obriga os usuários a recorrerem a soluções alternativas. A alteração do parâmetro de subagentes ramificados remove o custo dos resumos, mantendo a capacidade de execução de agentes em segundo plano, mas sem o histórico acumulado. Outra alternativa técnica envolve o uso de scripts de preload para bloquear o timer de execução, exigindo inspeção manual para evitar vulnerabilidades. A expectativa geral recae sobre futuras atualizações oficiais que corrijam o desperdício de recursos sem a necessidade de gambiarras.

   • A interface oficial do Claude Code não disponibiliza um interruptor direto para desligar a função de resumo.
   • Definir a opção 'claude code fork subagents' como zero encerra os resumos, fazendo com que os subagentes iniciem do zero sem herdar o histórico completo.
   • Scripts de terceiros baseados em Bun conseguem interceptar o temporizador de resumo, embora exijan cautela com a segurança do código.