Novità di Claude Opus 5.5

Claude Opus 5.5 è progettato per il “long-running agentic coding” (codifica agentica di lunga durata) e per il lavoro di conoscenza, con un prezzo di $4 / $20 USD per milione di token di input / output. Quattro modifiche incompatibili possono influire sul codice già in esecuzione su Claude Opus 5:

• Il “thinking” (ragionamento) non può essere disabilitato.
• Il “tool use” (uso degli strumenti) forzato restituisce un errore.
• I blocchi di ragionamento sono legati al modello e alla conversazione.
• Alcune versioni dello strumento di “computer use” (uso del computer) non sono supportate.

Le prime tre si applicano anche a Claude Fable 5.1. Un’ulteriore modifica altera la forma della risposta senza far fallire alcuna richiesta: il testo tra le chiamate agli strumenti viene restituito in blocchi thinking il cui testo è vuoto con l’impostazione display predefinita. Un’applicazione che trasmette in streaming quel testo ai propri utenti come aggiornamenti di avanzamento resta silenziosa tra le chiamate agli strumenti finché non imposta un valore di display che restituisce il testo.

Nuovo modello

L’“adaptive thinking” (ragionamento adattivo) è sempre attivo, e il parametro effort controlla la profondità del ragionamento; il suo valore predefinito su questo modello è medium. 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 Opus 5.5; per tutti i modelli attuali, consulta la panoramica dei modelli.

Modifiche incompatibili

Il ragionamento non può essere disabilitato

Su Claude Opus 5, il ragionamento è attivo per impostazione predefinita e thinking: {"type": "disabled"} è accettato con effort high o inferiore. Su Claude Opus 5.5, il ragionamento è sempre attivo: una richiesta che imposta thinking: {"type": "disabled"}, o un budget manuale con thinking: {"type": "enabled", "budget_tokens": N}, restituisce un 400 invalid_request_error. Ometti il campo thinking, oppure invia thinking: {"type": "adaptive"}, che è equivalente. Non è coinvolto alcun header beta.

I messaggi di errore sono:

"thinking.type.disabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

"thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

Il parametro effort è il controllo per la profondità del ragionamento, la latenza e il costo: abbassalo dove in precedenza disabilitavi il ragionamento; Ottimizzare per costo e intelligenza riporta risultati misurati per scegliere un livello. Poiché ogni risposta può iniziare con uno o più blocchi thinking (restituiti con un campo thinking vuoto con l’impostazione predefinita display: "omitted"), seleziona i blocchi di contenuto in base al loro campo type anziché in base alla posizione, e restituisci i blocchi thinking senza modificarli nei cicli di uso degli strumenti. Il codice già in esecuzione su Claude Opus 5 con il ragionamento attivo non richiede modifiche. Consulta Ragionamento e il prima e dopo per il ragionamento nella guida alla migrazione.

L’uso forzato degli strumenti non è supportato

Claude Opus 5.5 non supporta l’uso forzato degli strumenti. tool_choice impostato su {"type": "any"} o {"type": "tool", "name": "..."} restituisce un 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, e la stessa validazione si applica all’endpoint di conteggio dei token. Per ottenere JSON 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 si applica. La guida alla migrazione mostra il prima e dopo per la scelta dello strumento.

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

Ogni blocco di ragionamento registra quale modello lo ha prodotto, e ogni modello legge i propri blocchi e solo quelli di alcuni altri modelli. Claude Opus 5.5 legge i blocchi di ragionamento di Claude Opus 5, dei modelli Opus, Sonnet e Haiku precedenti e, sulla Claude API e su Claude Models on Google Cloud (Google managed), di Claude Sonnet 5.5 e Claude Haiku 5.5, ma non dei modelli Claude Fable o Claude Mythos. Sulla Claude API, Claude Fable 5.1 e Claude Mythos 5.1 leggono i blocchi di ragionamento di Claude Opus 5.5; nessun altro modello lo fa. Una conversazione che passa da Claude Opus 5 a Claude Opus 5.5, oppure da Claude Opus 5.5 a Claude Fable 5.1 o Claude Mythos 5.1 sulla Claude API, mantiene il proprio ragionamento. Una che passa da Claude Opus 5.5 a qualsiasi modello diverso da questi due, oppure a Claude Opus 5.5 da un modello Claude Fable o Claude Mythos, esegue i turni successivi al cambio senza il ragionamento del modello precedente. Quando una richiesta contiene un blocco che il modello di destinazione non può leggere, l’API lo rimuove prima che il modello lo veda: la richiesta va a buon fine e i blocchi rimossi non vengono fatturati. Con l’header beta thinking-binding-controls-2026-08-01, la rimozione viene segnalata in un array input_transformations di primo livello. Consulta Cambiare modello a metà conversazione.

L’API verifica inoltre se qualcosa che precede un blocco di ragionamento di Claude Opus 5.5 (il prompt system, i tools o un messaggio precedente) sia cambiato da quando il blocco è stato prodotto. Mantieni la conversazione in sola aggiunta: modifica le istruzioni o gli strumenti con i messaggi di sistema a metà conversazione anziché con delle modifiche. Una richiesta che ripropone un blocco dopo un cambiamento di questo tipo e lascia thinking.block_binding.prefix_mismatch_behavior non impostato riceve un errore 400 sugli account creati a partire dal 31 agosto 2026, 00:00 UTC. Questo vale sulla Claude API e sulle piattaforme cloud. Sugli account creati prima di tale data, la richiesta riceve l’errore solo quando imposta il campo su "error". Per rimuovere invece i blocchi interessati, invia l’header beta thinking-binding-controls-2026-08-01 e imposta il campo su "drop_block". Consulta Ragionamento preservato e la nota sui blocchi di ragionamento della guida alla migrazione.

Alcune versioni dello strumento di computer use non sono supportate

Claude Opus 5.5 supporta il computer use tramite il toolset computer_toolset_20260801. Su Amazon Bedrock, Claude Opus 5.5 accetta anche lo strumento computer_20251124 con l’header beta computer-use-2025-11-24. Claude Opus 5.5 restituisce un errore 400 per qualsiasi versione dello strumento di 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 accettati dal modello. Il messaggio inizia con:

'claude-opus-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. Rimuovi l’header beta e sostituisci la voce tools con {"type": "computer_toolset_20260801"}. Quindi aggiorna il ciclo del tuo agente per i blocchi tool_use dei membri, le azioni batch e toolset_name nei risultati. La guida alla migrazione mostra la richiesta prima e dopo.

Supporto delle funzionalità

Claude Opus 5.5 supporta l’effort per messaggio (beta), i messaggi di sistema a metà conversazione, i budget delle attività, la “prompt caching” (cache dei prompt) con un prompt memorizzabile in cache minimo di 512 token, l’elaborazione batch, la Files API, il supporto PDF, la visione e gli strumenti lato server e lato client. Consulta la pagina di ciascuna funzionalità per la disponibilità dei modelli.

Modalità veloce

La modalità veloce è disponibile per Claude Opus 5.5 sulla Claude API, su Claude Models on Google Cloud (Anthropic managed) e su Claude in Microsoft Foundry per le distribuzioni ospitate su Azure. Sulla Claude API e su Claude Models on Google Cloud (Anthropic managed), imposta speed: "fast" nella tua richiesta. Claude Opus 5.5 non richiede un header beta. Consulta Modalità veloce per i modelli supportati, i “rate limits” (limiti di velocità) e i prezzi.

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, così puoi aggiungere uno strumento, modificarne lo schema o passare uno strumento server a una versione più recente a metà conversazione senza modificare tools e senza perdere la cache dei prompt. Questo funziona su ogni modello che supporta le modifiche agli strumenti a metà conversazione, incluso Claude Opus 5.5. Consulta Definire strumenti in un messaggio.

Compattazione su richiesta (beta)

Con l’header beta compact-2026-09-04, una richiesta che invia il parametro compaction di primo livello restituisce un blocco compaction firmato che riassume l’intera conversazione, che poi invii per primo al posto dei messaggi riassunti. È disponibile sui modelli che supportano la compattazione, incluso Claude Opus 5.5. Sei tu a scegliere quando compattare e la richiesta può essere eseguita in background. Alle condizioni descritte in Compattazione e ragionamento preservato, i blocchi di ragionamento nei turni che mantieni possono restare validi dopo la sostituzione. Questo è importante su Claude Opus 5.5 perché i suoi blocchi di ragionamento sono legati alla conversazione. Consulta Compattazione su richiesta per la disponibilità sulle piattaforme e il flusso completo della richiesta.

Differenze di comportamento

Claude Opus 5.5 differisce da Claude Opus 5 in diversi modi che si manifestano senza alcuna modifica al codice. Per ciascuno ci sono indicazioni in Scrivere prompt per Claude Opus 5.5:

• L’effort predefinito è medium. Una richiesta che omette effort viene eseguita a medium; su Claude Opus 5 veniva eseguita a high. Imposta effort esplicitamente e ripeti la tua valutazione dei livelli; consulta Calibra l’effort.
• Più ragionamento per turno a un dato livello di effort. Con la stessa impostazione di effort il modello tende a pensare di più per turno rispetto a Claude Opus 5, soprattutto a xhigh e max. Ripeti la tua valutazione dei livelli di effort anziché riutilizzare un’impostazione precedente, e lascia spazio in max_tokens per il ragionamento. Consulta Calibra l’effort.
• Il testo tra le chiamate agli strumenti viene restituito in blocchi di ragionamento. Le brevi note che il modello scrive tra le chiamate agli strumenti arrivano come blocchi thinking di aggiornamento sullo stato di avanzamento anziché come blocchi text, quindi con l’impostazione predefinita display: "omitted" un’applicazione che li trasmette in streaming ai propri utenti resta silenziosa tra le chiamate agli strumenti, senza alcun errore. La guida alla migrazione spiega come ricevere il testo tra le chiamate agli strumenti, e Aggiornamenti sullo stato di avanzamento per l’utente spiega come richiederne di più.
• Più categorie di salvaguardia. Il modello esegue un classificatore di sicurezza per la biologia in aggiunta a quello per la cybersicurezza. Come su Claude Opus 5, le richieste che lo spingono a riprodurre il proprio ragionamento interno nel testo della risposta potrebbero essere rifiutate con la categoria reasoning_extraction. Consulta Rifiuti e fallback in Claude Opus 5.5 e Rifiuti per salvaguardia.
• Lettura più precisa di grafici, diagrammi e screenshot. Il modello legge i valori da grafici densi e da elementi visivi dipendenti dal layout in modo molto più preciso senza strumenti, quindi le soluzioni alternative per la visione lato prompt create per i modelli precedenti potrebbero non essere più necessarie; gli strumenti per le immagini aggiungono comunque precisione sugli input più densi. Consulta Strumenti per input visivi complessi.

Se la tua integrazione con Claude Opus 5 funzionava con il ragionamento disabilitato, consulta Prompt scritti per il ragionamento disabilitato insieme alla modifica incompatibile Il ragionamento non può essere disabilitato. Per i miglioramenti delle capacità nel coding agentico e nella revisione del codice, nel lavoro intellettuale, nella comunicazione, negli input visivi e nel computer use, consulta Capacità rilevanti per il prompting.

Rifiuti e fallback

Claude Opus 5.5 include classificatori di sicurezza, e si applica tutto quanto descritto in Rifiuti e fallback. Una richiesta rifiutata restituisce HTTP 200 con stop_reason: "refusal" e un oggetto stop_details che indica l’area della policy, quindi gestisci i rifiuti e configura il fallback: riprova su un altro modello con il fallback lato server (fallbacks: "default", in beta, riprova sul modello che Anthropic consiglia per quella categoria), con il middleware dell’SDK o con un tuo meccanismo di nuovo tentativo. Il fatto che un rifiuto che arriva prima di qualsiasi output venga fatturato dipende dalla sua categoria di rifiuto, e in ogni caso viene conteggiato nei tuoi “rate limit” (limiti di velocità); consulta Come vengono fatturati i rifiuti.

Prezzi

Claude Opus 5.5 costa $4 USD per milione di token di input e $20 USD per milione di token di output, meno dei $5 e $25 USD di Claude Opus 5, con scritture nella cache di 5 minuti a $5 USD, scritture nella cache di 1 ora a $8 USD e letture dalla cache a $0,20 USD per milione di token (0,05x il prezzo base di input). L’elaborazione in batch costa la metà: $2 e $10 USD. Consulta Prezzi per la residenza dei dati e i prezzi degli strumenti.

Disponibilità

Claude Opus 5.5 è disponibile su:

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

Migrare da Claude Opus 5

Aggiorna l’ID del modello:

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

Quindi rimuovi qualsiasi impostazione thinking: {"type": "disabled"} o thinking: {"type": "enabled", ...} e scegli invece un livello di effort. Sostituisci i tipi tool_choice any e tool con auto più l’uso rigoroso degli strumenti. Se usi il computer use tramite computer_20251124, passa al toolset. Su Amazon Bedrock, anche computer_20251124 funziona. Se la tua interfaccia mostra il testo tra le chiamate agli strumenti, imposta anche thinking.display; consulta Il testo tra le chiamate agli strumenti viene restituito in blocchi di ragionamento. Consulta la guida alla migrazione per istruzioni dettagliate a partire da Claude Opus 5 e dai modelli precedenti, e per la checklist completa.

Passaggi successivi