Introduzione ai message threads e al loro impatto su Claude Code

Il 2 novembre 2026 Anthropic ha annunciato l’apertura della beta pubblica dei message threads, una funzionalità della Messages API che elimina l’obbligo per i programmi di rispedire l’intera conversazione a ogni turno. La novità è già attiva per la maggior parte degli utenti di Claude Code, l’agente di programmazione di Anthropic, e porta a una riduzione media del 35 % del tempo che intercorre prima che il modello inizi a rispondere, quando le richieste si aggirano tra 500.000 e 1 milione di token.

La Messages API è il punto di ingresso con cui software, agenti e strumenti interagiscono con i modelli Claude. Si invia un testo, si riceve una risposta e si paga a token, unità in cui il modello segmenta le parole. Claude Code, che opera sia nel terminale sia nell’app desktop, legge i file di un progetto, esegue comandi e modifica il codice al posto dello sviluppatore, dialogando con l’API centinaia di volte in una singola sessione.

Come funzionano i message threads

In assenza di thread, l’API riceve, valida e tokenizza l’intera conversazione a ogni richiesta, operazione che diventa costosa quando la storia supera le centinaia di migliaia di token. Con i thread, invece, il server conserva la conversazione per pochi minuti; il client invia solo i messaggi nuovi e l’ID del messaggio precedente, consentendo a Claude di rispondere più rapidamente.

Il ciclo in tre passaggi

    • Create: la prima richiesta contiene la conversazione completa, il prompt di sistema e gli strumenti, più il campo "thread": {"type": "create"}. L’API salva tutto sotto un ID di risposta.
    • Continue: nei turni successivi si inviano solo i messaggi nuovi e l’ID della risposta precedente, con "type": "continue". Prompt di sistema e strumenti rimangono memorizzati dal thread.
    • Replay: il thread scade cinque minuti dopo l’ultima richiesta. Se l’API restituisce l’errore 404 threadnotfound, il client deve rimandare l’intera conversazione e aprire un nuovo thread.

Ogni chiamata deve includere l’header beta message-threads-2026-08-12. Gli SDK ufficiali (Python, TypeScript, Go, Java, C#, PHP e Ruby) offrono il helper client.beta.messages.thread() che gestisce automaticamente create, continue e replay.

Cosa cambia per gli utenti di Claude Code

Il problema che i thread risolvono è evidente osservando il funzionamento di un agente. Ad ogni passo Claude Code invia all’API l’intera storia della sessione – messaggi, output dei comandi, file letti, diff – e quando la conversazione supera i 500 000 token, la sola trasmissione aggiunge ritardi. Il parametro chiave è il time to first token (TTFT), ovvero l’intervallo fra l’invio della richiesta e la prima parola visualizzata.

Con i message threads attivi di default, Anthropic ha misurato una diminuzione mediana del TTFT del 35 % per richieste tra 500 000 e 1 milione di token. I dati di lancio, attribuiti da AlphaSignal ai test interni, mostrano che la dimensione mediana della richiesta è scesa da circa 800 KB a 1,8 KB, ovvero più di 400 volte meno dati da caricare a ogni turno.

Per gli utenti di Claude Code non è necessario attivare nulla: basta un account sulla Claude Console con chiave API, impostare il parametro thread e includere l’header beta message-threads-2026-08-12. La fatturazione rimane a token con le tariffe standard.

Confronto con le soluzioni di OpenAI e Google

OpenAI e Google offrono funzionalità simili da tempo. La Responses API di OpenAI utilizza il parametro previousresponseid per concatenare le risposte, mentre Google impiega previousinteractionid nella Interactions API di Gemini. Tuttavia, entrambe le soluzioni mantengono lo stato per periodi più lunghi: OpenAI lo conserva per 30 giorni di default, Google per 55 giorni a pagamento (1 giorno nel piano gratuito). Anthropic, al contrario, conserva lo stato in memoria per cinque minuti, cancellandolo entro un’ora.

Questa differenza influisce sulla privacy: i thread di Anthropic hanno una finestra di conservazione molto più breve, ma non rientrano nella modalità zero data retention (ZDR) né sono disponibili per utenti con conformità HIPAA.

Message threads vs. prompt caching

I message threads e il prompt caching risolvono problemi distinti. Il prompt caching evita al modello di ricalcolare l’inizio di un prompt già visto, riducendo il costo dei token. I thread, invece, evitano al client di ricaricare l’intera conversazione e all’API di rivalidarla, migliorando solo la velocità.

Per ottenere entrambi i benefici è possibile aggiungere il campo cache_control di primo livello a ogni richiesta, mantenendo lo stesso valore per tutti i turni (rispettando il limite di quattro breakpoint per richiesta). Il consumo di token resta invariato, poiché Claude rilegge comunque l’intera conversazione a ogni turno. La documentazione specifica che “threads do not change pricing or rate limits”.

Limiti e considerazioni pratiche

La riduzione del 35 % di attesa è valida per richieste comprese tra 500 000 e 1 milione di token; per sessioni più brevi l’impatto è minimo. La riduzione da 800 KB a 1,8 KB è stata comunicata solo sui social di Anthropic, con un arrotondamento che porta a “400 volte” meno dati, ma il valore più preciso è circa 444 volte.

Nonostante la maggiore velocità, la bolletta non diminuisce: Claude legge comunque tutta la conversazione a ogni turno, quindi i token fatturati e i limiti d’uso rimangono invariati. Inoltre, le aziende con requisiti di privacy stretti (ZDR, HIPAA) non potranno usufruire dei thread.

Implementazione pratica per gli sviluppatori

Per utilizzare i message threads è necessario:

    • Creare un account sulla Claude Console e generare una chiave API.
    • Impostare il parametro thread nella richiesta (tipo create o continue).
    • Aggiungere l’header beta message-threads-2026-08-12 a ogni chiamata.
    • Gestire il ciclo di vita del thread: creare, continuare, e rinnovare se scade (errore 404).
    • Assicurarsi che modello e impostazioni di ragionamento rimangano costanti per la durata del thread, altrimenti si otterrà l’errore 400 threadfingerprintmismatch.

Gli SDK forniscono il metodo client.beta.messages.thread(), che automatizza questi passaggi. Gli sviluppatori devono comunque mantenere una copia locale di tutti i messaggi, poiché l’API non conferma esplicitamente la memorizzazione del thread fino alla successiva richiesta.

Conclusioni

I message threads rappresentano un passo importante verso sessioni di programmazione più fluide con Claude Code, soprattutto per progetti complessi che richiedono centinaia di migliaia di token. La riduzione del TTFT del 35 % e la drastica diminuzione dei dati trasmessi (da 800 KB a 1,8 KB) migliorano l’esperienza dell’utente senza alterare i costi o i limiti di utilizzo.

Pur non essendo una soluzione definitiva per la privacy (non è compatibile con ZDR o HIPAA) e non riducendo il consumo di token, i thread offrono un vantaggio competitivo rispetto a OpenAI e Google, grazie a una finestra di conservazione più breve e a una più semplice integrazione via SDK. Gli sviluppatori interessati dovrebbero aggiornare subito la CLI di Claude e sperimentare i thread per valutare l’impatto concreto sui propri workflow.