Claude Platform Docs
Modelli e prezziClaude Haiku 5.5

Novità di Claude Haiku 5.5

Panoramica delle nuove funzionalità, delle modifiche incompatibili e delle modifiche di comportamento in Claude Haiku 5.5, con un link alla guida di ciascuna funzionalità e alla guida alla migrazione per le modifiche al codice.

Claude Haiku 5.5 è progettato per carichi di lavoro ad alto volume e sensibili alla latenza, come classificazione, instradamento, estrazione e attività di subagenti. Supporta il ragionamento adattivo con il parametro effort, una “context window” (finestra di contesto) da 1M di token e fino a 128k token di output. Utilizza lo stesso tokenizer più recente di Claude 4.7 e dei modelli successivi, quindi lo stesso testo conta come circa il 30 percento di token in più rispetto a Claude Haiku 4.5. I suoi blocchi di ragionamento funzionano solo nell’account che li ha prodotti o in un account collegato a esso.

Per le modifiche al codice, consulta la guida alla migrazione. Per ID dei modelli, prezzi e limiti, consulta la panoramica di Claude Haiku 5.5. Per indicazioni sulla scrittura dei prompt, consulta Prompting per Claude Haiku 5.5.

Riepilogo delle modifiche rispetto a Claude Haiku 4.5

Ogni riga indica una modifica, se è nuova, modificata o incompatibile, e cosa deve fare il tuo codice.

ModificaTipoAzione richiesta
Ragionamento adattivo ed effortNuovoFacoltativo: imposta effort per bilanciare la qualità delle risposte con velocità e costo.
Finestra di contesto e output più ampiNuovoNessuna. I valori esistenti di max_tokens restano validi, ma i token di ragionamento vengono conteggiati al loro interno. I prompt lunghi vengono fatturati a prezzi più alti; consulta Prezzi per contesti lunghi.
Strumento browser useNuovoNessuna.
I classificatori di sicurezza possono rifiutare una richiestaNuovoGestisci stop_reason: "refusal" nel tuo client. Il fallback lato server non è disponibile. Rimuovi dai prompt le istruzioni che chiedono al modello di scrivere il proprio ragionamento.
Il ragionamento esteso manuale restituisce un erroreIncompatibileSostituisci budget_tokens con il ragionamento adattivo.
I parametri di campionamento possono restituire un erroreIncompatibileOmetti temperature, top_p e top_k.
Il prefill dei messaggi dell’assistente restituisce un erroreIncompatibileTermina messages con un turno dell’utente.
computer_20250124 restituisce un erroreIncompatibileSostituiscilo con computer_toolset_20260801. Su Amazon Bedrock funziona anche computer_20251124.
La modifica dei turni precedenti invalida i blocchi di ragionamentoIncompatibileMantieni le conversazioni in sola aggiunta se rinvii i blocchi di ragionamento.
Le risposte possono iniziare con blocchi di ragionamentoModificatoSeleziona i blocchi di contenuto in base al type, non alla posizione.
Il testo del ragionamento è omesso per impostazione predefinitaModificatoPer ricevere il ragionamento riassunto, imposta thinking.display su "summarized".
Lo stesso testo conta come più tokenModificatoRiconta i token dei prompt e rivedi max_tokens e le stime dei costi.
Riproduzione dei blocchi di ragionamento tra account diversiModificatoSe riproduci conversazioni archiviate tramite un account diverso, riproduci ciascuna tramite l’account che l’ha generata.
I blocchi di ragionamento precedenti restano nel contestoModificatoAspettati più token di input nelle conversazioni multi-turno. Per rimuovere i blocchi più vecchi, usa la cancellazione dei blocchi di ragionamento.
I prompt più brevi possono essere memorizzati nella cacheModificatoNessuna. La lunghezza minima di un prompt memorizzabile nella cache è di 512 token, rispetto ai 4.096 di Claude Haiku 4.5, quindi un prompt di lunghezza intermedia che imposta cache_control viene memorizzato nella cache su Claude Haiku 5.5.
I tag di consapevolezza del contesto non vengono inseritiModificatoPer fornire al modello un budget esplicito per un ciclo agentico, usa i budget delle attività (beta).

Nuove funzionalità

Ragionamento adattivo ed effort

Con il “adaptive thinking” (ragionamento adattivo), Claude Haiku 5.5 determina quando e quanto ragionare. Il ragionamento adattivo è attivo per impostazione predefinita. Sebbene tu possa ancora disattivare il ragionamento con thinking: {"type": "disabled"} con effort high o inferiore, il modo migliore per bilanciare la qualità della risposta con velocità e costi è usare il parametro effort.

Finestra di contesto e output più ampi

Claude Haiku 5.5 ha una finestra di contesto da 1M di token e restituisce fino a 128k token di output, rispetto ai 200k e 64k di Claude Haiku 4.5. I valori esistenti di max_tokens restano validi, ma i token di ragionamento vengono conteggiati in max_tokens, quindi un limite ridotto può interrompere la risposta dopo un blocco thinking e prima di qualsiasi testo. Consulta Configura il ragionamento. I prompt lunghi vengono fatturati a prezzi più alti; consulta Prezzi del contesto lungo.

Modifiche di comportamento

Le risposte possono iniziare con blocchi di ragionamento

Il ragionamento adattivo è attivo per impostazione predefinita, quindi una risposta può iniziare con uno o più blocchi thinking anche quando la richiesta non menziona il ragionamento. Il codice che legge il primo blocco di contenuto come risposta deve selezionare i blocchi in base al loro campo type. Consulta Configurare il ragionamento nella guida alla migrazione.

I blocchi di ragionamento precedenti restano nel contesto

Claude Haiku 5.5 mantiene nel contesto i blocchi di ragionamento di tutti i turni precedenti dell’assistente, e questi vengono conteggiati come token di input. Claude Haiku 4.5 manteneva solo i blocchi dell’ultimo turno. Le conversazioni a più turni comportano quindi più token di input di quanto spieghi la sola modifica del tokenizer. Per rimuovere i blocchi più vecchi, usa la rimozione dei blocchi di ragionamento. Consulta Preservazione dei blocchi di ragionamento per modello.

Lo stesso testo corrisponde a più token

Claude Haiku 5.5 utilizza lo stesso tokenizer più recente di Claude 4.7 e dei modelli successivi. Come per tutti i modelli che utilizzano questo tokenizer, lo stesso testo di input produce circa il 30 percento di token in più su Claude Haiku 5.5 rispetto a Claude Haiku 4.5. L’aumento esatto dipende dal contenuto. La struttura delle richieste e delle risposte non dipende dal tokenizer, ma tutto ciò che misuri o pianifichi in token cambia. Consulta Ricontare i token nella guida alla migrazione.

Riproduzione dei blocchi di ragionamento tra account

I blocchi di ragionamento di Claude Haiku 5.5 funzionano solo nell’account che li ha prodotti o in un account collegato a esso. Questo è rilevante solo se memorizzi le conversazioni e le riproduci tramite un account diverso. Consulta Riproduci i blocchi di ragionamento tramite l’account che li ha prodotti.

Questa pagina ti è stata utile?