I Claude API Message Threads consentono alla Messages API di conservare una conversazione di breve durata sul server, così ogni turno successivo invia solo i nuovi messaggi invece di reinviare l’intera cronologia. Annunciata in beta pubblica all’inizio di novembre 2026, la funzione riduce la dimensione delle richieste e il tempo al primo token nelle lunghe esecuzioni degli agenti, mentre l’utilizzo di token fatturato resta esattamente lo stesso.
Se hai creato un assistente di programmazione o un ciclo di strumenti a più passaggi, conosci il problema del turno 40. Ogni volta che il modello esegue un comando o esamina uno screenshot, il client raccoglie tutti i prompt, le risposte e i risultati degli strumenti precedenti e rispedisce l’intero pacchetto in rete. Message Threads è la soluzione di Anthropic a questo collo di bottiglia nel trasporto e nella convalida, con alcune regole rigorose su scadenza dopo cinque minuti, prompt caching e conservazione dei dati da considerare nella progettazione prima dell’attivazione.
Cosa sono i Claude API Message Threads?
I Message Threads sono una cache di conversazione sul server per la Claude Messages API, attivabile in beta con l’intestazione message-threads-2026-08-12. Invece di trattare ogni chiamata API come una pagina bianca che richiede l’intera cronologia della chat, il server conserva la conversazione in memoria tra i turni, così il client trasmette solo ciò che è cambiato dall’ultima risposta.
Secondo le note di rilascio e la documentazione di Anthropic del 2 novembre 2026, questa funzione è distinta dai thread di sessione di Claude Managed Agents. Funziona direttamente su /v1/messages con tutti i modelli in beta ed è disponibile tramite Claude API diretta, Claude Platform on AWS, Claude Models on Google Cloud (gestito da Anthropic) e Claude in Microsoft Foundry.
Tra un turno e l’altro, Anthropic conserva il thread nella memoria del server, cifrato con una chiave gestita dal server, e non lo scrive mai su un disco di archiviazione permanente.
Cosa fa risparmiare Message Threads e cosa no?
Message Threads riduce la quantità di dati caricati in rete e il tempo al primo token (TTFT) nelle conversazioni lunghe, ma non riduce il numero di token fatturati né modifica i limiti di frequenza.
Quando una sessione di un agente cresce fino a centinaia di migliaia di token, cosa comune quando un ciclo di programmazione legge file di grandi dimensioni o un agente che usa il computer scambia screenshot, reinviare e convalidare il payload a ogni turno aggiunge un ritardo percepibile prima ancora che il modello inizi a generare. Anthropic afferma che Message Threads è attivo per impostazione predefinita per la maggior parte degli utenti di Claude Code e che, nelle richieste da 500k a 1M token, il TTFT mediano diminuisce di circa il 35%.
La fattura non cambia. Anche se la richiesta HTTP contiene solo l’ultimo messaggio dell’utente o il risultato di uno strumento, Claude legge comunque l’intera conversazione a ogni turno. Si applicano le tariffe standard dei token: a novembre 2026 Claude Opus 5.5 è a listino a $4 per milione di token in input ($0.20 in cache) e $20 per milione di token in output, mentre Sonnet 5.5 costa $2 in input ($0.10 in cache) e $10 in output (vedi il nostro confronto dei prezzi delle API AI e la guida a Claude Opus 5.5 vs. Sonnet 5.5 per confrontare queste tariffe).
| Cosa cambia con Message Threads | Cosa rimane invariato |
|---|---|
| Payload delle richieste HTTP più piccoli nei turni successivi | Token dell’intera conversazione letti e fatturati a ogni turno |
| Tempo al primo token inferiore (secondo Anthropic, calo mediano del TTFT di ~35% per richieste da 500k–1M token in Claude Code) | Prezzi standard dei token API e limiti di frequenza esistenti |
system e tools inviati una volta alla creazione del thread |
L’app resta la fonte di riferimento per la cronologia dei messaggi |
Come si crea e si continua un thread?
Si avvia un thread inviando una normale richiesta /v1/messages con "thread": {"type": "create"} e l’intestazione beta message-threads-2026-08-12, quindi lo si continua al turno successivo passando l’id della risposta come previous_message_id. Se usi gli SDK di Anthropic, l’helper client.beta.messages.thread(...) gestisce la creazione e la continuazione e aggiunge automaticamente l’intestazione beta.
Nella chiamata iniziale create includi l’intera conversazione fino a quel momento insieme a system e tools:
{
"model": "claude-sonnet-5-5",
"max_tokens": 2048,
"system": "You are a careful repository refactoring assistant.",
"tools": [
{
"name": "run_tests",
"description": "Run the project test suite",
"input_schema": { "type": "object", "properties": {} }
}
],
"thread": {
"type": "create"
},
"messages": [
{ "role": "user", "content": "Check why the auth test is failing." }
]
}
L’API restituisce una risposta standard con un id (per esempio msg_01XYZ...) che rappresenta la conversazione memorizzata, inclusa la risposta di Claude. Al turno successivo invii solo i nuovi messaggi, come un tool_result o il prompt successivo dell’utente, e fai riferimento a quell’id:
{
"model": "claude-sonnet-5-5",
"max_tokens": 2048,
"thread": {
"type": "continue",
"previous_message_id": "msg_01XYZ..."
},
"messages": [
{
"role": "user",
"content": [
{
"type": "tool_result",
"tool_use_id": "toolu_01ABC...",
"content": "FAIL src/auth.test.ts: expected 200, got 401"
}
]
}
]
}
Regole che possono creare problemi se salti la documentazione
Anthropic impone una rigorosa coerenza per tutta la durata di un thread:
- Campi solo alla creazione: Devi omettere
systemetoolsin ogni richiestacontinue. Reinviarli produce un errore400. - Campi fissi:
model,tool_choice,thinking,mcp_servers(tranne il token di autenticazione di ciascun server),context_management,output_config, le skill del container,cache_controlal livello superiore e l’insieme esatto dei valori dell’intestazioneanthropic-betadevono corrispondere alla chiamata inizialecreate. Modificarne uno provoca un errore400thread_fingerprint_mismatch. - Campi per turno: Puoi continuare a modificare
max_tokens,stop_sequences,stream,metadataeservice_tierda un turno all’altro. - Cronologia con sola aggiunta: Ogni
iddi risposta può essere continuato una sola volta e devi sempre ripartire dall’iddella risposta più recente. Se devi modificare un messaggio precedente o creare una diramazione della conversazione, devi iniziare un nuovo thread concreate.
Quanto dura un Message Thread?
Un Message Thread scade 5 minuti dopo l’ultima richiesta e viene eliminato definitivamente dalla memoria del server entro 1 ora dall’ultimo utilizzo. Ogni risposta memorizzata correttamente azzera il timer di 5 minuti.
Poiché i thread sono conservati nella memoria volatile come cache best effort, la risposta dell’API non indica mai in anticipo se un turno specifico sia stato memorizzato correttamente. Lo scopri solo alla successiva chiamata continue. Se l’intervallo di 5 minuti è trascorso o il server ha rimosso il thread prima del tempo, l’API restituisce un errore 404.
Quando il client riceve un 404, il recupero è semplice: reinvia l’intera cronologia della conversazione (insieme a system e tools) in una nuova richiesta "thread": {"type": "create"}. L’applicazione deve rimanere la fonte di riferimento e conservare una propria copia completa di ogni messaggio e risultato degli strumenti.
Come funzionano i Message Threads con prompt caching?
Message Threads e prompt caching risolvono parti diverse del problema dei contesti lunghi e prompt caching non si attiva automaticamente abilitando i thread. Message Threads riduce i byte caricati e convalidati in rete; prompt caching riduce il costo dei token di input ripetuti (per esempio, da $2 a $0.10 per milione di token in input di Sonnet 5.5, come illustrato nel nostro confronto dei prezzi delle API AI).
Per ottenere sia un TTFT più rapido sia costi inferiori per i token in input, devi attivare entrambi. Per memorizzare nella cache ogni turno di un thread, includi cache_control al livello superiore nella richiesta iniziale create e continua a inviare lo stesso cache_control al livello superiore in ogni richiesta continue (ricorda che cache_control al livello superiore è uno dei campi fissi che devono corrispondere in tutto il thread). Anthropic consente un massimo di 4 punti di interruzione cache_control quando thread è impostato.
Chi dovrebbe attivare Message Threads?
I team che eseguono lunghi cicli di programmazione, flussi di lavoro con uso del computer o agenti multi-turno che gestiscono molti documenti vedranno il vantaggio più evidente; quelli con rigidi requisiti di conformità o pipeline batch potrebbero invece dover rinunciare. Se non conosci la differenza tra i cicli che usano strumenti e i normali chatbot, la nostra guida su cos’è un agente AI spiega le basi.
Dove Message Threads è più adatto:
- Agenti di programmazione: Cicli che leggono file, eseguono compilatori e iterano per decine di turni rapidi entro la finestra attiva di 5 minuti. (Anthropic lo ha già attivato per impostazione predefinita per la maggior parte degli utenti di Claude Code.)
- Agenti che usano il computer: Flussi in cui ogni turno allega un nuovo screenshot del desktop o del browser; conservare quelli precedenti sul server evita di ricaricare megabyte di immagini base64 a ogni passaggio.
- Chat ricche di documenti e immagini: Sessioni interattive in cui un utente carica PDF di grandi dimensioni o raccolte di immagini e pone rapidamente domande successive. Anche se l’agente orchestra pipeline multimediali esterne, per esempio scrivendo script e avviando rendering in uno strumento come AI Studio, conservare il voluminoso contesto di pianificazione e le immagini di riferimento in un thread sul server mantiene reattivo il ciclo di coordinamento.
Dove è bloccato o non supportato a novembre 2026:
- Organizzazioni Zero Data Retention (ZDR) e HIPAA: I Message Threads non sono idonei a ZDR e le organizzazioni con la predisposizione HIPAA attivata non possono usarli.
- Funzioni API non supportate: Non puoi usare
threadcon Message Batches, richieste di conteggio dei token che includonothread, compattazione su richiesta, la maggior parte delle strategie di modifica del contesto (tranneclear_thinking_20251015conkeep: "all") o nelle organizzazioni che hanno attivato gli Inference hooks.
Cosa farei davvero
Se gestisci un’infrastruttura di agenti basata sulla Claude Messages API, attiverei Message Threads ovunque una singola attività superi regolarmente 100k token e i turni siano separati da meno di cinque minuti, purché i requisiti di conformità lo consentano. Ecco la checklist di implementazione che seguirei:
- Mantieni intatto l’archivio locale delle conversazioni. Considera i thread sul server esclusivamente un acceleratore di trasporto, mai il tuo database. Aggiungi in locale ogni turno dell’utente, risposta dell’assistente e risultato degli strumenti come fai oggi.
- Aggiungi a
continueun meccanismo di ripiego automatico per404. Quando una chiamatacontinuerestituisce404(per una pausa di inattività di 5 minuti o una rimozione best effort), intercettalo e reinvia subito l’intera cronologia locale con"thread": {"type": "create"},systemetools. - Abbinalo a
cache_controlal livello superiore. Non attivare mai Message Threads aspettandoti una riduzione della fattura. Inseriscicache_controlal livello superiore sia nelle chiamatecreatesia nellecontinue, per ottenere lo sconto del 90%+ sugli input in cache oltre al miglioramento del TTFT. Consulta il nostro confronto dei prezzi delle API AI per stimare i costi degli input con e senza cache a 500k token. - Fissa la configurazione del thread al momento della creazione. Controlla che il ciclo dell’agente non modifichi dinamicamente
tools,system,thinkingo le intestazionianthropic-betadurante un’attività, altrimenti riceverai errori400thread_fingerprint_mismatch. - Verifica prima le impostazioni ZDR e HIPAA. Se il tuo ambiente di lavoro dipende da Zero Data Retention o dalla predisposizione HIPAA, lascia Message Threads disattivato: la beta non è idonea per nessuno dei due.
Domande frequenti
Message Threads riduce il costo dei miei token Claude API?
No. Anche se ogni richiesta HTTP successiva trasporta solo i nuovi messaggi, Claude legge comunque l’intera cronologia a ogni turno. Tutti i token in input e output vengono fatturati alle tariffe standard di Claude e i limiti di frequenza esistenti continuano ad applicarsi. Per ridurre il costo dei token in input sul contesto ripetuto, combina Message Threads con prompt caching.
Serve ancora prompt caching se uso Message Threads?
Sì. Message Threads conserva soltanto la conversazione nella memoria del server, evitando di caricare e convalidare nuovamente i messaggi precedenti in rete. Non attiva automaticamente prompt caching. Per ottenere il prezzo degli input in cache a ogni turno, invia cache_control al livello superiore nella richiesta iniziale create e in ogni successiva richiesta continue (fino a 4 punti di interruzione in totale).
Cosa succede dopo 5 minuti di inattività?
Un Message Thread scade 5 minuti dopo l’ultima richiesta (e viene eliminato dalla memoria entro 1 ora dall’ultimo utilizzo). Se invii una richiesta continue dopo la scadenza del thread, l’API restituisce il codice di stato 404. Il client dovrebbe intercettare quel 404 e reinviare l’intera conversazione con "thread": {"type": "create"} per avviare un nuovo thread.
Message Threads è disponibile su AWS, Azure e Google Cloud?
Sì. Secondo le note di rilascio di Anthropic del 2 novembre 2026, la beta pubblica (message-threads-2026-08-12) è disponibile tramite Claude API diretta, Claude Platform on AWS, Claude Models on Google Cloud (gestito da Anthropic) e Claude in Microsoft Foundry.
Claude Code usa già i Message Threads?
Sì. Anthropic afferma che i Message Threads sono attivi per impostazione predefinita per la maggior parte degli utenti di Claude Code; per le richieste tra 500k e 1M token, il tempo mediano al primo token si riduce di circa il 35%.
Dettagli della funzione verificati l’ultima volta il 3 novembre 2026. Prossima verifica: 3 dicembre 2026.
Fonti
- Anthropic, Note di rilascio di Claude Platform (2 novembre 2026), consultate il 3 novembre 2026
- Anthropic, Rendere più veloci gli agenti di lunga durata con Message Threads, consultato il 3 novembre 2026
- Documentazione Anthropic, Message Threads (
message-threads-2026-08-12), consultata il 3 novembre 2026 - LoTook, Confronto dei prezzi delle API AI, consultato il 3 novembre 2026



