Consumo di token di Claude Code: 1 richiesta su 5 è lo stato di un agente

Flamerix AI ha pubblicato un gist con delle misurazioni secondo cui Claude Code spende il 16,4% del costo della sessione per un breve stato di 3–5 parole nel pannello degli agenti. Il 29 ottobre il post è arrivato in prima pagina su Hacker News e in un’ora ha raccolto più di 130 punti. Riguarda chiunque si preoccupi del consumo di token di Claude Code, soprattutto chi avvia molti agenti in background.

Da dove nasce il consumo di token di Claude Code?

Si tratta di un meccanismo chiamato agent_summary. Secondo l’autore del gist funziona così:

1. Ogni 30 secondi circa, separatamente per ogni agente in background, Claude Code invia al modello l’intera trascrizione di quell’agente.
2. Chiede al modello di descrivere l’ultima azione «in 3–5 parole» (testualmente: «describe your most recent action in 3-5 words»).
3. Il risultato finisce solo nel pannello degli agenti, cioè in una breve riga di stato.

Il meccanismo è attivo di default dalla versione 2.1.232 (agosto 2026) e non esiste un’impostazione ufficiale per disattivarlo.

Quanto costa?

I numeri del gist provengono da un export OpenTelemetry della settimana precedente alla disattivazione dei riepiloghi:

• il 16,4% del costo stimato andava in agent_summary, più che nella conversazione principale (15,7%),
• il 19,7% di tutte le richieste all’API, più o meno una su cinque,
• il 96% di quel costo riguardava Opus,
• il rapporto tra token in ingresso e in uscita era di circa 9000 a 1.

Curiosamente, circa il 98% di queste chiamate colpisce la cache del prompt, quindi sono economiche. Il problema è il restante 2% circa: senza cache, vale più di un terzo del costo dei riepiloghi.

I costi sono stime dello stesso Claude Code (il campo cost_usd), non una fattura, quindi prendiamoli con le pinze.

È una novità?

Il problema è noto da agosto. Il 15 agosto l’utente @rflcrz ha aperto la issue #86879 nel repository di Claude Code. In una sessione di 4 ore con 27 subagenti (1496 richieste), le chiamate agent_summary costituivano il 22,7% delle richieste e il 18% dei token ponderati, e ognuna restituiva in media circa 65 token di risposta.

Nei commenti altri utenti riportano risultati simili: 15–22% nelle sessioni con più di 20 subagenti e 26% dei token letti dalla cache nella versione 2.1.276. Uno di loro ha notato che la variabile CLAUDE_CODE_ENABLE_NARRATION=0 disattivava i riepiloghi nella versione 2.1.241, ma nella 2.1.245 non funzionava più.

La issue ha l’etichetta area:cost ed è aperta. Al 29 ottobre nessuno di Anthropic ha risposto.

Come verificarlo sul proprio setup?

Claude Code ha un export della telemetria tramite OpenTelemetry integrato. Lo attiviamo con la variabile CLAUDE_CODE_ENABLE_TELEMETRY=1 e configuriamo un exporter dei log. Ogni richiesta all’API arriva allora come evento claude_code.api_request con l’attributo query_source, che indica quale sottosistema l’ha inviata. Basta raggruppare gli eventi per query_source e sommare cost_usd: è esattamente così che l’autore del gist ha trovato il problema.

Si può disattivare?

Ufficialmente no. L’autore del gist ha condiviso un workaround: lo script no-agent-summary.js, precaricato tramite Bun (BUN_OPTIONS="--preload …"), che sostituisce il timer dei riepiloghi con uno inattivo, senza modificare il binario. Nel suo caso la quota di agent_summary nei costi è scesa dal 16,4% a zero.

Prima di usarlo conviene conoscerne i limiti:

1. Lo script è stato testato solo su Linux, non su macOS né su Windows.
2. Funziona facendo match sul codice sorgente, quindi qualsiasi aggiornamento di Claude Code può disattivarlo senza avvisare (verifica che funzioni dopo ogni aggiornamento).
3. Il pannello degli agenti smette di mostrare lo stato.
4. È un progetto della community con licenza MIT, senza legami con Anthropic.

Se non vogliamo iniettare nulla in Claude Code, la via più semplice è far girare meno agenti in background contemporaneamente, perché il costo dei riepiloghi cresce con il loro numero. Scrivo di più sul lavoro con Claude Code nella mia guida Claude Code, e di quanto velocemente si può bruciare il budget su Opus nell’articolo sul fast mode.

FAQ

Perché Claude Code consuma così tanti token?

Soprattutto perché ogni richiesta invia al modello il contesto della conversazione. Le misurazioni degli utenti mostrano che, con molti agenti in background, una parte consistente (16–22% del costo) se la mangiano anche i riepiloghi nascosti agent_summary, che ogni 30 secondi circa inviano l’intera trascrizione dell’agente.

Posso disattivare agent_summary nelle impostazioni?

Al 29 ottobre non c’è un interruttore ufficiale. La issue #86879 chiede un flag dedicato, l’inclusione dei riepiloghi nella variabile CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC oppure un intervallo configurabile.

Mi riguarda se non uso agenti in background?

I riepiloghi vengono generati per gli agenti in background, quindi il problema cresce con il loro numero. Il modo più semplice per verificarlo è nella telemetria, raggruppando le richieste per query_source.