Novità di Claude Sonnet 5.5

Claude Sonnet 5.5 offre la migliore combinazione di velocità e intelligenza. Cinque modifiche incompatibili (“breaking changes”) possono influire sul codice già in esecuzione su Claude Sonnet 5:

• Disattiva il ragionamento anticipato con between_tools.
• L’uso forzato degli strumenti restituisce un errore.
• I blocchi di ragionamento sono legati al modello e alla conversazione.
• Alcune versioni dello strumento computer use non sono supportate.
• Lo strumento advisor rifiuta quattro modelli come advisor: Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 e Claude Haiku 5.5.

Un’altra modifica altera la forma della risposta senza far fallire alcuna richiesta: il testo tra le chiamate agli strumenti viene restituito in blocchi thinking. Un’applicazione che trasmette in streaming quel testo ai propri utenti resta silenziosa tra le chiamate agli strumenti finché non imposta un valore display che restituisce il testo, oppure non disattiva il ragionamento anticipato con between_tools.

Nuovo modello

L’“adaptive thinking” (ragionamento adattivo) è attivo per impostazione predefinita, e il parametro “effort” (impegno) controlla la profondità del ragionamento. Il suo valore predefinito sull’API Claude è high. Il “tokenizer” (tokenizzatore) è lo stesso di Claude Sonnet 5, quindi lo stesso testo produce lo stesso numero di token. Per la “context window” (finestra di contesto), i limiti di output, la data limite delle conoscenze e i prezzi, consulta la pagina del modello Claude Sonnet 5.5.

Per tutti i modelli attuali, consulta Panoramica dei modelli.

Modifiche che causano incompatibilità

Disattiva il ragionamento anticipato con between_tools

Per disattivare il ragionamento anticipato su Claude Sonnet 5.5, invia thinking: {"type": "between_tools"} invece di "disabled". È l’impostazione di ragionamento più bassa su questo modello. È disponibile su ogni piattaforma che offre Claude Sonnet 5.5. I brevi “progress updates” (aggiornamenti di avanzamento) che il modello scrive tra le chiamate agli strumenti vengono comunque restituiti come blocchi thinking con il relativo testo di riepilogo. Rimanda indietro quei blocchi invariati insieme al resto del turno dell’assistente. Un blocco di aggiornamento di avanzamento che rimandi indietro fornisce al modello la nota completa che ha scritto, non il riepilogo. Se le tue richieste non usano strumenti, la risposta contiene solo testo, come con disabled su Claude Sonnet 5.

Su Claude Sonnet 5.5, una richiesta che invia thinking: {"type": "disabled"} restituisce un errore 400 invalid_request_error il cui messaggio rimanda a between_tools.

between_tools è accettato con effort low, medium e high. Con effort xhigh o max, una richiesta con between_tools restituisce un errore 400. Per eseguire con xhigh o max, usa il ragionamento adattivo: ometti il campo thinking oppure invia thinking: {"type": "adaptive"}, che è equivalente. Con between_tools, l’effort non può cambiare a metà conversazione: un output_config.effort per messaggio diverso dal livello in vigore restituisce un errore 400. Per variare l’effort a ogni turno, usa il ragionamento adattivo.

between_tools non accetta altri campi: display, budget_tokens o block_binding inviati insieme a esso restituiscono un errore 400. I budget di ragionamento manuali (thinking: {"type": "enabled", "budget_tokens": N}) restituiscono un errore 400. Consulta Ragionamento e Disattivare il ragionamento anticipato nella guida alla migrazione.

L’uso forzato degli strumenti non è supportato

Claude Sonnet 5.5 non supporta l’uso forzato degli strumenti. tool_choice impostato su {"type": "any"} o {"type": "tool", "name": "..."} restituisce un errore 400 invalid_request_error:

tool_choice: type "tool" and "any" are not supported for this model.

tool_choice: {"type": "auto"} (il valore predefinito) e {"type": "none"} sono supportati. Lo stesso controllo si applica all’endpoint di conteggio dei token. Per un input degli strumenti conforme allo schema, mantieni tool_choice: {"type": "auto"} e imposta strict: true con l’uso rigoroso degli strumenti, oppure sposta lo schema negli output strutturati. Per fare in modo che il modello chiami uno strumento anziché rispondere con del testo, indica nel prompt quando lo strumento è applicabile. La sezione L’uso forzato degli strumenti non è supportato della guida alla migrazione mostra il prima e il dopo.

I blocchi di ragionamento sono legati al modello e alla conversazione

Ogni blocco di ragionamento registra quale modello lo ha prodotto. Una conversazione che cambia modello mantiene il suo ragionamento precedente solo se il modello a cui passa è in grado di leggere i blocchi di ragionamento del modello precedente:

Quando una richiesta contiene un blocco che il modello di destinazione non può leggere, l’API lo scarta prima che il modello lo riceva. La richiesta ha esito positivo e i blocchi scartati non vengono fatturati. Con l’header beta thinking-binding-controls-2026-08-01, l’API segnala lo scarto in un array input_transformations di primo livello. Consulta Cambiare modello e tornare indietro. Per i cambi che non coinvolgono Claude Sonnet 5.5, consulta Quali cambi di modello mantengono il ragionamento sulla Claude API.

L’API verifica anche se qualcosa prima di un blocco di ragionamento di Claude Sonnet 5.5 è cambiato da quando il modello ha prodotto il blocco. Questo “prefix check” (controllo del prefisso) copre il prompt system, i tools e ogni messaggio precedente. Mantieni la conversazione in sola aggiunta: modifica le istruzioni o gli strumenti con i messaggi di sistema a metà conversazione anziché con delle modifiche.

Non superare il “prefix check” (controllo del prefisso) potrebbe causare oppure no un errore 400. Per identificare e gestire entrambi i casi, consulta Controlli del prefisso sui blocchi di ragionamento.

Il controllo del prefisso viene eseguito sulla Claude API e su alcune piattaforme cloud.

Consulta Ragionamento preservato e la nota sui blocchi di ragionamento della guida alla migrazione.

Alcune versioni dello strumento computer use non sono supportate

Claude Sonnet 5.5 supporta il computer use tramite il toolset computer_toolset_20260801. Su Amazon Bedrock, Claude Sonnet 5.5 accetta anche lo strumento computer_20251124 con l’header beta computer-use-2025-11-24. Claude Sonnet 5.5 restituisce un errore 400 per qualsiasi versione dello strumento computer use che non accetta, come computer_20251124 sulla Claude API. Il messaggio invalid_request_error della Claude API indica il tipo rifiutato e, dopo Did you mean one of, elenca i tipi di strumento che il modello accetta. Il messaggio inizia così:

'claude-sonnet-5-5' does not support tool types: computer_20251124.

Le integrazioni che usano il toolset non richiedono modifiche. Per spostare un’integrazione computer_20251124 al toolset, segui Migrare da computer_20251124, che mostra la richiesta prima e dopo. Rimuovi l’header beta e sostituisci la voce tools con {"type": "computer_toolset_20260801"}. Quindi aggiorna il tuo ciclo dell’agente per gestire i blocchi tool_use dei membri, le azioni in batch e toolset_name nei risultati.

Alcuni abbinamenti dello strumento advisor non sono supportati

Lo strumento advisor è in beta. Un executor Claude Sonnet 5.5 accetta solo questi advisor:

• Claude Mythos 5.2 e Claude Fable 5.2
• Claude Mythos 5.1 e Claude Fable 5.1
• Claude Mythos 5 e Claude Fable 5
• Claude Opus 5.5 e Claude Opus 5
• Claude Sonnet 5.5 stesso

Gli advisor Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 e Claude Haiku 5.5 funzionano con un executor Claude Sonnet 5. Con un executor Claude Sonnet 5.5, restituiscono un errore 400 invalid_request_error. Ogni advisor accettato da Claude Sonnet 5.5 restituisce il proprio consiglio crittografato, come blocco advisor_redacted_result. Quindi il tuo client non può leggere il testo del consiglio. Consulta le sezioni Compatibilità dei modelli e Varianti del risultato dello strumento advisor.

Supporto delle funzionalità

Claude Sonnet 5.5 supporta queste funzionalità:

• Effort per messaggio, che è in beta
• Messaggi di sistema a metà conversazione
• Modifiche agli strumenti a metà conversazione, che sono in beta
• Cache dei prompt, con un prompt minimo memorizzabile nella cache di 512 token
• Elaborazione in batch
• La Files API
• Supporto PDF
• Visione
• Strumenti lato server e lato client (consulta Uso degli strumenti con Claude)

Claude Sonnet 5 non supporta l’effort per messaggio, i messaggi di sistema a metà conversazione né le modifiche agli strumenti a metà conversazione. Su Claude Sonnet 5, il prompt minimo memorizzabile nella cache è di 1.024 token. Consulta la pagina di ciascuna funzionalità per la disponibilità dei modelli.

Compattazione su richiesta (beta)

Con l’header beta compact-2026-09-04, una richiesta che invia il parametro di primo livello compaction restituisce un blocco compaction firmato che riassume i messaggi di quella richiesta. Nelle richieste successive, il blocco va per primo in messages, al posto dei messaggi che riassume. Sei tu a scegliere quando eseguire la “compaction” (compattazione) e quali turni mantenere dopo il blocco. Su Claude Sonnet 5.5, i blocchi di ragionamento nei turni mantenuti possono restare validi dopo la compattazione. Per le condizioni, consulta Compattazione e ragionamento preservato. Consulta Compattazione su richiesta per la disponibilità sulle piattaforme e il flusso completo della richiesta.

Definire strumenti in un messaggio (beta)

Con l’header beta inline-tools-2026-09-15, un blocco tool_addition in un messaggio di sistema a metà conversazione può contenere una definizione completa dello strumento anziché un riferimento. Puoi aggiungere uno strumento, modificarne lo schema o spostare uno strumento server a una versione più recente a metà conversazione senza modificare tools e senza perdere la cache dei prompt. Consulta Definire strumenti in un messaggio.

I blocchi di ragionamento restano con l’account che li ha prodotti

I blocchi di ragionamento prodotti da Claude Sonnet 5.5 funzionano solo nell’account che li ha prodotti, o in un account collegato a esso. Quando un altro account invia uno di questi blocchi, l’API scarta il blocco prima che il modello lo riceva, e la richiesta ha esito positivo. I blocchi di Claude Haiku 5.5, Claude Fable 5.2 e Claude Mythos 5.2 seguono la stessa regola.

Sulla Claude API e su Claude Models on Google Cloud (Google managed), puoi vedere quali blocchi sono stati scartati. Invia l’header beta thinking-binding-controls-2026-08-01 e la risposta elenca ogni blocco scartato in input_transformations con reason: "organization_binding_mismatch". Consulta Account e piattaforme cloud.

Differenze di comportamento

Per indicazioni su ciascuno dei seguenti aspetti, consulta Prompting per Claude Sonnet 5.5. Claude Sonnet 5.5 differisce da Claude Sonnet 5 nei seguenti modi, che si manifestano senza alcuna modifica al codice:

• I livelli di effort sono ricalibrati. Un livello di effort non produce la stessa quantità di ragionamento che produceva su Claude Sonnet 5. Ripeti la tua valutazione dei livelli di effort anziché riportare un’impostazione esistente. Inizia con high, a meno che il tuo carico di lavoro non sia agentico o sensibile alla “latency” (latenza). Per la programmazione agentica e l’uso degli strumenti in più passaggi, inizia con medium per attività ben specificate e passa a high per quelle più difficili o più lunghe. Per la chat e altri lavori sensibili alla latenza, inizia con medium o low.
• Il testo tra le chiamate agli strumenti viene restituito in blocchi di ragionamento. Tra le chiamate agli strumenti, le note più lunghe di una o due frasi vengono restituite come blocchi thinking di aggiornamento di avanzamento. Le osservazioni più brevi restano text. Con il valore predefinito display: "omitted", il testo dei blocchi di aggiornamento di avanzamento è vuoto, quindi un’applicazione che trasmette in streaming quelle note ai propri utenti resta silenziosa tra le chiamate agli strumenti, senza alcun errore. Se disattivi il ragionamento anticipato con between_tools, il testo viene restituito. Per riceverlo, consulta Il testo tra le chiamate agli strumenti viene restituito nei blocchi di ragionamento nella guida alla migrazione.
• Categorie di salvaguardia. Le salvaguardie del modello possono rifiutare una richiesta in cinque categorie stop_details. "cyber" significa che la richiesta potrebbe favorire danni informatici. "bio" significa che potrebbe favorire danni biologici. "frontier_llm" significa che potrebbe aiutare lo sviluppo di modelli di IA concorrenti. "reasoning_extraction" significa che chiede al modello di riprodurre il suo ragionamento interno nel testo della risposta. "general_harms" significa che rientra in un’altra area delle norme di utilizzo. Consulta Rifiuti, fallback e fatturazione.

Rifiuti, fallback e fatturazione

Tutto quanto descritto in Rifiuti e fallback si applica a Claude Sonnet 5.5. Una richiesta rifiutata restituisce HTTP 200 con stop_reason: "refusal" e un oggetto stop_details che indica l’area delle norme.

Gestisci i rifiuti nel tuo codice e configura il fallback. Con il fallback lato server (fallbacks: "default"), una richiesta rifiutata nella categoria "cyber" o "frontier_llm" viene eseguita di nuovo su Claude Sonnet 5. Una richiesta rifiutata nella categoria "bio", "reasoning_extraction" o "general_harms" non viene ritentata. Il fallback lato server è in beta sulla Claude API e su Claude Models on Google Cloud (Anthropic managed). Puoi anche usare il middleware dell’SDK o un tuo meccanismo di nuovo tentativo.

Un rifiuto che arriva prima di qualsiasi output viene fatturato in alcune categorie di rifiuto e non in altre. In ogni caso, viene conteggiato ai fini dei tuoi “rate limit” (limiti di velocità). Consulta Come vengono fatturati i rifiuti.

Prezzi

Claude Sonnet 5.5 ha gli stessi prezzi di Claude Sonnet 5, ad eccezione delle letture dalla cache dei prompt, che costano $0,10 USD per milione di token, la metà della tariffa di Claude Sonnet 5. Consulta Prezzi per l’elenco completo, la residenza dei dati e i prezzi degli strumenti.

Disponibilità

Claude Sonnet 5.5 è disponibile su:

• Claude API: tutti i clienti, come claude-sonnet-5-5
• AWS: Claude in Amazon Bedrock, come anthropic.claude-sonnet-5-5, e Claude Platform on AWS, come claude-sonnet-5-5
• Google Cloud: Claude Models on Google Cloud (Anthropic managed), come claude-sonnet-5-5, e Claude Models on Google Cloud (Google managed), come claude-sonnet-5-5
• Microsoft Foundry: Claude in Microsoft Foundry, come claude-sonnet-5-5

Migrare da Claude Sonnet 5

Aggiorna l’ID del modello:

model = "claude-sonnet-5"  # Before
model = "claude-sonnet-5-5"  # After

Quindi verifica sei aspetti:

1. Se il tuo codice disattiva il ragionamento con disabled, invia invece between_tools, con effort high o inferiore.
2. Sostituisci i tipi tool_choice any e tool con auto più l’uso rigoroso degli strumenti.
3. Mantieni le conversazioni in sola aggiunta. Una richiesta che ripropone un blocco di ragionamento di Claude Sonnet 5.5 dopo una modifica alla cronologia precedente può restituire un errore 400. Consulta I blocchi di ragionamento sono legati al modello e alla conversazione.
4. Se usi il computer use tramite computer_20251124, passa al toolset. Su Amazon Bedrock, anche computer_20251124 funziona.
5. Se usi lo strumento advisor con un advisor Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 o Claude Haiku 5.5, passa a un advisor che Claude Sonnet 5.5 accetta.
6. Se la tua interfaccia mostra il testo tra le chiamate agli strumenti, imposta thinking.display quando usi il ragionamento adattivo. Con between_tools, il testo viene restituito senza di esso. Consulta Il testo tra le chiamate agli strumenti viene restituito nei blocchi di ragionamento.

La Guida alla migrazione a Claude Sonnet 5.5 contiene istruzioni dettagliate per la migrazione da Claude Sonnet 5 e dai modelli precedenti, oltre alla checklist completa.

Passaggi successivi