Limite di utilizzo di Claude Code: stati degli agenti il 99% più economici

La sera del 4 novembre l’account ClaudeDevs ha annunciato su X che gli agenti in background (background subagents) di Claude Code ora consumano meno limite di utilizzo. Lo stato di ciascun agente si aggiorna ogni 30 secondi e finora ogni aggiornamento rileggeva l’intera conversazione. Ora lo scrive Haiku 5.5 partendo da brevi note, quindi ogni aggiornamento costa circa il 99% in meno.

Cosa cambia nel calcolo del limite di utilizzo di Claude Code?

Parliamo della breve riga di stato che vediamo accanto a ogni agente in esecuzione in background. Secondo il post di ClaudeDevs, finora il meccanismo funzionava così:

1. Ogni 30 secondi, separatamente per ogni agente attivo, Claude Code generava un nuovo stato.
2. Ognuno di questi aggiornamenti rileggeva l’intera conversazione dell’agente, che col tempo si allunga.
3. Ora lo stato lo scrive Haiku 5.5 a partire da brevi note, invece di leggere tutta la trascrizione.

Secondo il changelog di Claude Code, Haiku 5.5 costa nell’API 0,10 USD per milione di token in input e 0,50 USD per milione di token in output.

Il post si è diffuso in fretta: entro la mattina del 5 novembre aveva raccolto oltre 16.000 like e quasi 1,2 milioni di visualizzazioni. Non sorprende, perché i limiti sono uno degli argomenti più frequenti tra chi lavora ogni giorno con Claude Code.

Perché è importante?

Perché proprio questo meccanismo era all’origine delle misurazioni tanto discusse di una settimana fa. Ne ho scritto nell’articolo sul consumo di token di Claude Code: secondo un gist di Flamerix AI, i riepiloghi agent_summary valevano il 16,4% del costo stimato della sessione, più della conversazione principale.

Da allora nella issue #86879 si sono aggiunte altre analisi. Il 31 ottobre un utente ha calcolato dai log della versione 2.1.314 che un singolo riepilogo inviava tra 2.800 e 13.000 token in input fuori cache e che, nel suo modello di una settimana di lavoro con molti agenti, i riepiloghi pesavano circa il 13–32% della spesa. Altri hanno pubblicato i propri workaround, dalle variabili d’ambiente agli script caricati all’avvio.

Curiosamente, sotto la issue nessuno di Anthropic si è ancora espresso. Al 5 novembre è ancora aperta, e la modifica è stata annunciata su X, non nel thread su GitHub.

Cos’altro è stato migliorato negli agenti in background?

Nel changelog della versione 2.1.318 del 4 novembre troviamo diverse modifiche nella stessa area:

1. Gli agenti in background spostano un comando di shell in background dopo 3 minuti con tutti i provider, così la cache del prompt non scade mentre è in esecuzione.
2. Su Bedrock, Vertex e Foundry (e con la telemetria disattivata), il riepilogo dei progressi dell’agente può, a cache fredda, attendere fino a 5 minuti la risposta dell’agente.
3. È stato corretto il messaggio «Now using usage credits», che compariva circa ogni 30 secondi mentre era attivo un agente in background.

Il post di ClaudeDevs non indica un numero di versione né parla della necessità di aggiornare. Nemmeno il changelog descrive questa modifica in modo diretto, quindi la cosa più semplice è avere l’ultima versione (verifichiamola con claude --version).

A cosa fare attenzione?

Primo, alla scala. Il 99% riguarda un singolo aggiornamento di stato, non l’intera bolletta. Quanto risparmieremo davvero dipende da quanti agenti lanciamo insieme e da quanto a lungo lavorano. Le sessioni senza agenti in background non dovrebbero accorgersi del cambiamento.

Secondo, alla mancanza di un interruttore. Il post non cita alcuna impostazione per disattivare gli stati, e gli utenti continuano a chiederla nella issue.

Terzo, ai numeri delle misurazioni. Le quote del 13–32% citate prima sono stime degli utenti (dal campo cost_usd e da modelli di costo), non fatture, quindi prendiamole con cautela. La cosa migliore è verificarlo sul proprio setup con la telemetria OpenTelemetry, raggruppando le richieste per query_source, come ho descritto nell’articolo precedente. Per saperne di più sul lavoro con gli agenti c’è la guida a Claude Code.

FAQ

Perché il limite di utilizzo di Claude Code finisce così in fretta?

Ogni richiesta invia al modello il contesto della conversazione, quindi sessioni lunghe e molti agenti in parallelo consumano rapidamente il limite. Secondo le misurazioni degli utenti, anche gli stati degli agenti in background generavano una buona parte del costo, e dal 4 novembre costano circa il 99% in meno per aggiornamento.

Devo attivare qualcosa per sfruttare la modifica?

Secondo il post di ClaudeDevs non serve configurare nulla. Conviene comunque avere una versione aggiornata di Claude Code.

Si possono disattivare del tutto gli stati degli agenti in background?

Per ora non esiste un’impostazione ufficiale. Nella issue #86879 circolano workaround degli utenti, ma non funzionano ovunque e Anthropic non li supporta.