Voltar
Material gratuito

Como desligar o resumo dos agentes do Claude Code e conferir que funcionou

O passo a passo do gist no-agent-summary: instalar o arquivo, deixar fixo em todo processo do Claude Code e conferir depois de cada atualização que a correção continua ativa.

6 min de leitura
Como desligar o resumo dos agentes do Claude Code e conferir que funcionou

O que você vai aprender

Quem usa agentes em segundo plano no Claude Code e vê o limite de uso acabar antes da hora pode estar pagando por uma linha de status de três a cinco palavras. A cada 30 segundos, para cada agente em segundo plano, o Claude Code manda a conversa inteira desse agente para o modelo dele, quase sempre o Opus, e pede que descreva a última ação em três a cinco palavras. A resposta só atualiza a linha de status do painel de agentes.

Um gist da Flamerix AI mediu esse gasto na própria máquina: o resumo respondeu por 16,4% do gasto da semana, mais que a conversa principal (15,7%), e 19,7% das requisições, cerca de uma em cinco. Cerca de 96% desse gasto foi no Opus. A issue #86879 do repositório do Claude Code junta quatro medições independentes, de 18% a 26%.

Este guia traz o que o vídeo cortou: o link do gist e da issue, o passo a passo para instalar o arquivo e deixá-lo fixo, o que ele altera de verdade, como conferir depois de cada atualização e o que muda na tela. Tudo vem do gist, conferido em 29/10/2026. O gist é de terceiros: não é da Anthropic nem tem apoio dela.

Links

Para quem é

Quem programa com o Claude Code e usa agentes em segundo plano. O gasto é medido pelo próprio Claude Code (o campo de custo por requisição), não é uma fatura. Em plano de assinatura, o que se perde é folga no limite de uso. Sem agentes em segundo plano, não há nada a desligar.

Por que não existe um botão para desligar

Segundo o gist, não há configuração que desligue o resumo. A opção documentada do SDK só liga: o valor false não muda nada. O intervalo vem do servidor, fica entre 30 e 240 segundos, e o padrão já é o mínimo. Desde a versão 2.1.232 (agosto de 2026) o resumo vem ligado por padrão para agentes em segundo plano no modo interativo.

Variáveis de ambiente que parecem servir não servem. Duas delas param o resumo, mas levam junto os subagentes ou os agentes em segundo plano, segundo o gist. Por isso o autor fez outra coisa.

O que o arquivo faz

O no-agent-summary.js é um arquivo de cerca de 70 linhas que o Bun, o ambiente em que o Claude Code roda, carrega antes do programa (--preload). Ele só intercepta o cronômetro do resumo e entrega no lugar um cronômetro que nunca dispara. Os outros cronômetros passam sem alteração. O programa do Claude Code não é modificado, e o arquivo só age dentro do Claude Code: em qualquer outro uso do Bun ele carrega e não faz nada.

Passo a passo para instalar

O teste rápido, só para ver funcionando (no Linux):

curl -fsSL https://gist.githubusercontent.com/flamerix-ai/c3905705cc4205e5de3011fa2e74efce/raw/no-agent-summary.js -o ~/.local/share/no-agent-summary.js
claude daemon stop --any
BUN_OPTIONS="${BUN_OPTIONS:+$BUN_OPTIONS }--preload=$HOME/.local/share/no-agent-summary.js" claude

O primeiro comando baixa o arquivo, o segundo reinicia o processo de apoio do Claude Code e o terceiro abre o Claude Code com o arquivo carregado.

Passo a passo para deixar fixo

O comando acima vale só para aquela sessão. Para valer em todo processo do Claude Code:

  1. Guarde o arquivo num lugar estável e anote o caminho absoluto.
  2. Defina BUN_OPTIONS de forma global, com = depois de --preload (com espaço, outros comandos do Bun quebram, segundo o gist). Num ~/.profile, ~/.bashrc ou ~/.zshrc:
export BUN_OPTIONS="${BUN_OPTIONS:+$BUN_OPTIONS }--preload=/caminho/absoluto/no-agent-summary.js"
  1. Reinicie o processo de apoio e toda sessão que já estava aberta, e abra o Claude Code de um terminal que tenha essa variável:
claude daemon stop --any

Os processos de apoio herdam o ambiente de quem os iniciou. Se um deles subiu antes de a variável existir, continua criando sessões sem a correção. Execuções sem tela (claude -p, cron, CI) precisam da variável também.

O gist traz ainda a opção de um script chamado claude colocado antes do original no PATH, e variações para o fish e para o ambiente do systemd. Os detalhes estão no gist.

Como conferir depois de cada atualização

O gist diz que uma atualização pode desfazer a correção em silêncio: o arquivo reconhece o cronômetro pelo texto do código dele, e se a Anthropic mudar esse texto, os resumos voltam sem aviso. Por isso a conferência é depois de cada versão nova, em dois passos.

  1. O arquivo carrega:
BUN_OPTIONS="--preload=$HOME/.local/share/no-agent-summary.js" CC_AGENT_SUMMARY_LOG=/tmp/nas.log claude --version && cat /tmp/nas.log

Tem de aparecer uma linha preload active mode=off. Sem linha, a variável não chegou ao processo ou o caminho não é absoluto.

  1. O cronômetro é barrado: com a mesma variável e o mesmo CC_AGENT_SUMMARY_LOG, rode um subagente em segundo plano por um ou dois minutos. O log tem de mostrar summary timer #1 suppressed (setTimeout, delay=30000). Quem exporta a telemetria do Claude Code pode checar também que o query_source = agent_summary continua em zero, que é a única conferência que pega todos os casos de falha.

O que muda na tela: o efeito da correção

O efeito visível é este: a linha de status de cada agente no painel de agentes para de atualizar. Subagentes, agentes em segundo plano e sessões seguem funcionando normalmente: só o resumo é pulado. O gist mediu a abertura do claude --version subindo de cerca de 10 para 17 milissegundos, numa medição.

Limites

Fontes

Você é o dono ou sócio do negócio?