Novità di Claude Opus 5.5

Claude Opus 5.5 è progettato per il coding agentico di lunga durata e per il lavoro di conoscenza, con un prezzo di $4 / $20 USD per milione di token di input / output. Quattro "breaking changes" (modifiche incompatibili) interessano il codice già in esecuzione su Claude Opus 5: il pensiero non può essere disabilitato, l'uso forzato degli strumenti restituisce un errore, i blocchi di pensiero sono legati al modello e alla conversazione e, sulla Claude API e su Google Cloud, lo strumento di computer use precedente computer_20251124 non è accettato. Le prime tre si applicano anche a Claude Fable 5.1. Un'ulteriore modifica altera la struttura 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" (pensiero adattivo) è sempre attivo, e il parametro effort controlla la profondità del pensiero; 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 pensiero non può essere disabilitato

Su Claude Opus 5, il pensiero è attivo per impostazione predefinita e thinking: {"type": "disabled"} è accettato con effort high o inferiore. Su Claude Opus 5.5, il pensiero è 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 pensiero, la latenza e il costo: abbassalo dove in precedenza disabilitavi il pensiero; 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 il valore predefinito display: "omitted"), seleziona i blocchi di contenuto in base al loro campo type anziché in base alla posizione, e restituisci i blocchi thinking senza modifiche nei cicli di uso degli strumenti. Il codice che già funziona su Claude Opus 5 con il pensiero attivo non richiede modifiche. Consulta Pensiero e il prima e dopo della 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 valido rispetto 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 è pertinente. La guida alla migrazione mostra il prima e dopo.

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

Ogni blocco di pensiero 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 pensiero di Claude Opus 5 e dei precedenti modelli Opus, Sonnet e Haiku, ma non quelli dei modelli Claude Fable o Claude Mythos. Sulla Claude API, Claude Fable 5.1 e Claude Mythos 5.1 leggono i blocchi di pensiero di Claude Opus 5.5; nessun altro modello lo fa. Una conversazione che passa da Claude Opus 5 a Claude Opus 5.5, o da Claude Opus 5.5 a Claude Fable 5.1 o Claude Mythos 5.1 sulla Claude API, mantiene il proprio ragionamento. Una conversazione che passa da Claude Opus 5.5 a qualsiasi modello diverso da quei due, o che arriva su di esso 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 scarta prima che il modello lo veda: la richiesta ha esito positivo e i blocchi scartati non vengono fatturati. Con l'header beta thinking-binding-controls-2026-08-01 lo scarto viene segnalato in un array input_transformations di primo livello. Consulta Cambiare modello a metà conversazione.

L'API verifica anche se qualcosa che precede un blocco di pensiero di Claude Opus 5.5 (il prompt system, i tools o un messaggio precedente) è cambiato da quando il blocco è stato prodotto. Come su Claude Fable 5.1, applica tale controllo per impostazione predefinita per gli account creati a partire dal 31 agosto 2026, 00:00 UTC, sulla Claude API e sulle piattaforme cloud. Su questi account, una richiesta che ripropone un blocco dopo una tale modifica restituisce un errore 400. Per scartare invece i blocchi interessati, invia l'header beta thinking-binding-controls-2026-08-01 e imposta thinking.block_binding.prefix_mismatch_behavior su "drop_block". Sugli account meno recenti, impostare quel campo su uno dei due valori attiva il controllo per la richiesta. Mantieni la conversazione in sola aggiunta (append-only) in modo che il problema non si presenti mai: modifica istruzioni o strumenti con i messaggi di sistema a metà conversazione anziché con modifiche. Consulta Pensiero preservato e la nota su questa modifica della guida alla migrazione.

Lo strumento di computer use computer_20251124 non è supportato sulla Claude API e su Google Cloud

Claude Opus 5 accetta il "computer use" (uso del computer) sia come toolset computer_toolset_20260801 sia, con l'header beta computer-use-2025-11-24, come lo strumento precedente computer_20251124. Sulla Claude API e su Google Cloud, Claude Opus 5.5 supporta solo il toolset: una richiesta che dichiara uno strumento computer_20251124 restituisce un 400 invalid_request_error. Il messaggio indica il tipo rifiutato, quindi elenca i tipi di strumento che il modello accetta (tra cui computer_toolset_20260801) dopo Did you mean one of; inizia così:

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

Per spostare un'integrazione esistente sulla Claude API o su Google Cloud, segui Migra da computer_20251124: rimuovi l'header beta, sostituisci la voce tools con {"type": "computer_toolset_20260801"} e aggiorna il ciclo del tuo agente per gestire i blocchi tool_use membri, le azioni in batch e toolset_name nei risultati. Su Amazon Bedrock, lo strumento precedente computer_20251124 continua a funzionare su Claude Opus 5.5 come su Claude Opus 5, quindi lì non è necessaria alcuna modifica. Per le altre piattaforme, consulta la sezione Compatibilità dello strumento di computer use. Le integrazioni che già usano il toolset, e lo strumento di browser use, non richiedono modifiche. 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 di attività, il "prompt caching" (cache dei prompt) con un prompt minimo memorizzabile nella cache di 512 token, l'elaborazione batch, la Files API, il supporto PDF, la visione e gli strumenti lato server e lato client. Sulla Claude API e su Google Cloud, il computer use richiede il toolset computer_toolset_20260801 (consulta la modifica incompatibile). Consulta la pagina di ciascuna funzionalità per la disponibilità dei modelli.

Modalità veloce

La "fast mode" (modalità veloce) (anteprima di ricerca) è disponibile per Claude Opus 5.5 solo sulla Claude API; non è disponibile su Amazon Bedrock, Claude Platform on AWS, Google Cloud o Microsoft Foundry. Imposta speed: "fast" con l'header beta fast-mode-2026-02-01. Consulta Modalità veloce per l'accesso, i modelli supportati 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, la richiesta può essere eseguita in background e i blocchi di pensiero nei turni che mantieni possono rimanere validi dopo la sostituzione (alle condizioni indicate in Compattazione e pensiero preservato), il che è importante su Claude Opus 5.5 perché i suoi blocchi di pensiero 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 sono disponibili 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ù pensiero 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 pensiero. Consulta Calibra l'effort.
• Il testo tra le chiamate agli strumenti viene restituito in blocchi di pensiero. Le brevi note che il modello scrive tra le chiamate agli strumenti arrivano come blocchi thinking di aggiornamento di avanzamento anziché come blocchi text, quindi con il valore predefinito 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 contiene la soluzione per riceverli, e Aggiornamenti sui progressi rivolti all'utente spiega come richiederne di più.
• Più categorie di salvaguardia. Il modello esegue un classificatore di sicurezza per la biologia oltre a quello per la cybersecurity, e le richieste che lo spingono a riprodurre il proprio ragionamento interno nel testo della risposta possono essere rifiutate con la categoria reasoning_extraction. Consulta Rifiuti e fallback e Rifiuti delle salvaguardie.
• 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 accuratezza sugli input più densi. Consulta Strumenti per input visivi complessi.

Se la tua integrazione con Claude Opus 5 funzionava con il pensiero disabilitato, consulta Prompt scritti per il pensiero disabilitato insieme alla modifica incompatibile. Per i miglioramenti delle capacità nel coding agentico e nella revisione del codice, nel lavoro di conoscenza, 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.

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 di Claude Opus 5, con scritture nella cache di 5 minuti a $5, scritture nella cache di 1 ora a $8 e letture dalla cache a $0,20 per milione di token (0,05x il prezzo base di input). L'elaborazione batch costa la metà: $2 e $10. 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 su Google Cloud, 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 eventuali impostazioni thinking: {"type": "disabled"} o thinking: {"type": "enabled", ...} e scegli invece un livello di effort. Sostituisci i tipi di tool_choice any e tool con auto più l'uso rigoroso degli strumenti. Se usi il computer use tramite computer_20251124 sulla Claude API o su Google Cloud, passa al toolset. 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 nei blocchi di pensiero. Consulta la guida alla migrazione per istruzioni dettagliate per la migrazione da Claude Opus 5 e dai modelli precedenti, e per la checklist completa.

Passaggi successivi