---
title: Guida alla migrazione a Claude Haiku 5.5
url: https://platform.claude.com/docs/it/models/haiku-5-5/migration-guide
description: Passa a Claude Haiku 5.5 dai modelli Haiku precedenti con questa guida alla migrazione. Le indicazioni per abilitare Claude Haiku 5.5 includono il nuovo ID del modello, le impostazioni che restituiscono errori, le modifiche al ragionamento e una checklist per ciascun modello di partenza.
---
Questa guida copre la migrazione del codice della [Messages API](https://platform.claude.com/docs/it/build-with-claude/working-with-messages). Se usi [Claude Managed Agents](https://platform.claude.com/docs/it/managed-agents/overview), non sono necessarie modifiche oltre all'aggiornamento del nome del modello.
**Automatizza la tua migrazione con la skill Claude API.** In Claude Code, esegui `/claude-api migrate` per invocare la [skill Claude API](https://platform.claude.com/docs/it/agents-and-tools/agent-skills/claude-api-skill#migrating-to-a-newer-claude-model) inclusa. Funziona con qualsiasi modello Claude attuale come destinazione:
Lascia che Claude Code migri il tuo codice per te
```text
/claude-api migrate questo progetto a claude-haiku-5-5
```
La skill applica la sostituzione dell'ID del modello e, se necessario, le modifiche incompatibili ai parametri, la sostituzione del prefill e la calibrazione dell'effort per il modello di destinazione in tutta la tua base di codice, quindi produce una checklist di elementi da verificare manualmente. Ti chiede di confermare l'ambito della migrazione (l'intera directory di lavoro, una sottodirectory o un elenco specifico di file) prima di modificare qualsiasi file. La skill rileva inoltre i client Amazon Bedrock e Claude Platform su AWS e adatta i formati degli ID dei modelli e le modifiche alle funzionalità per tali piattaforme.
Questa guida tratta il passaggio del codice che chiama Claude Haiku 4.5 a Claude Haiku 5.5. Per il codice che chiama Claude Haiku 3.5 o Claude Haiku 3, apporta anche le modifiche descritte in [Migrazione a Claude Haiku 5.5 da Claude Haiku 3.5 e modelli Haiku precedenti](https://platform.claude.com/docs/it/models/haiku-5-5/migration-guide#migrating-from-haiku-35). Per passare invece a un modello Sonnet o Opus, consulta [Aggiornamento tra versioni dei modelli](https://platform.claude.com/docs/it/about-claude/models/migration-guide). Per sapere per quanto tempo Claude Haiku 4.5 resterà disponibile, consulta [Deprecazioni dei modelli](https://platform.claude.com/docs/it/about-claude/model-deprecations).
## Checklist di migrazione per modello di partenza
Procedi attraverso i gruppi e fermati dopo quello che indica il tuo modello attuale. Se usi Claude Haiku 4.5, il primo gruppo è l'elenco completo. Ogni voce è una modifica da apportare al tuo codice.
### Ogni modello di partenza
1. Sostituisci l'ID del modello con l'ID di Claude Haiku 5.5 per la tua piattaforma. Consulta [Usa l'ID del modello Claude Haiku 5.5](https://platform.claude.com/docs/it/models/haiku-5-5/migration-guide#use-the-claude-haiku-5-5-model-id).
2. Riconta i token dei tuoi prompt e rivedi i limiti di `max_tokens` e le stime dei costi, perché lo stesso testo corrisponde a più token e le immagini di grandi dimensioni corrispondono a più token visivi. Consulta [Riconta i token](https://platform.claude.com/docs/it/models/haiku-5-5/migration-guide#recount-tokens).
3. Se le tue richieste inviano `thinking: {"type": "enabled", "budget_tokens": N}`, cambia `thinking` in `{"type": "adaptive"}`. Consulta [Configura il ragionamento](https://platform.claude.com/docs/it/models/haiku-5-5/migration-guide#configure-thinking).
4. Se il tuo codice legge il primo blocco di contenuto come risposta, seleziona invece i blocchi in base al `type`. Consulta [Configura il ragionamento](https://platform.claude.com/docs/it/models/haiku-5-5/migration-guide#configure-thinking).
5. Rimuovi `temperature`, `top_p` e `top_k` dalle tue richieste. Consulta [Rimuovi i parametri di campionamento](https://platform.claude.com/docs/it/models/haiku-5-5/migration-guide#remove-sampling-parameters).
6. Se le tue richieste terminano `messages` con un turno dell'assistente che il modello deve continuare, terminale invece con un turno dell'utente. Consulta [Sostituisci il prefill dell'assistente](https://platform.claude.com/docs/it/models/haiku-5-5/migration-guide#replace-assistant-prefill).
7. Se usi il computer use, sostituisci `computer_20250124`: sulla Claude API e su Google Cloud, con il toolset `computer_toolset_20260801`; su Amazon Bedrock, con `computer_20251124` e l'header beta `computer-use-2025-11-24`. Consulta [Sposta il computer use sul toolset](https://platform.claude.com/docs/it/models/haiku-5-5/migration-guide#computer-use-toolset).
8. Se riproduci conversazioni memorizzate tramite un account diverso, riproduci ciascuna tramite l'account che l'ha prodotta. Consulta [Riproduci i blocchi di ragionamento tramite l'account che li ha prodotti](https://platform.claude.com/docs/it/models/haiku-5-5/migration-guide#replay-thinking-blocks-through-the-producing-account).
9. Se il tuo codice modifica `system`, `tools` o i `messages` precedenti tra le richieste di una conversazione e rinvia i blocchi di ragionamento, mantieni la conversazione in sola aggiunta. Consulta [Mantieni invariati i turni precedenti](https://platform.claude.com/docs/it/models/haiku-5-5/migration-guide#keep-earlier-turns-unchanged).
10. Gestisci `stop_reason: "refusal"`. Claude Haiku 5.5 esegue "safety classifiers" (classificatori di sicurezza) che possono rifiutare una richiesta, e non dispone di un fallback lato server. Consulta [Rifiuti delle salvaguardie](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#safeguard-refusals).
11. Se usi gli [output strutturati](https://platform.claude.com/docs/it/build-with-claude/structured-outputs) (`output_config.format` o strumenti con `strict: true`) su Amazon Bedrock, descrivi il formato nel prompt o usa uno strumento senza `strict`, e convalida l'output nel tuo codice. Gli output strutturati non sono disponibili per Claude Haiku 5.5 su Amazon Bedrock.
Se la tua organizzazione ha un impegno [Priority Tier](https://platform.claude.com/docs/it/api/service-tiers#supported-models) su Claude Haiku 4.5, pianifica la capacità separatamente: il Priority Tier non è supportato su Claude Haiku 5.5.
### Claude Haiku 3.5 o precedenti
1. Sostituisci l'ID del modello Claude Haiku 3.5 o Claude Haiku 3 con l'ID di Claude Haiku 5.5 per la tua piattaforma. Consulta [Migrazione a Claude Haiku 5.5 da Claude Haiku 3.5 e modelli Haiku precedenti](https://platform.claude.com/docs/it/models/haiku-5-5/migration-guide#migrating-from-haiku-35).
2. Se usi lo strumento legacy `code_execution_20250522`, passa a `code_execution_20250825` o successivo.
3. Se usi lo strumento editor di testo, passa a `text_editor_20250728`.
4. Gestisci i motivi di arresto `refusal` e `model_context_window_exceeded`.
5. Se il tuo codice confronta esattamente i parametri stringa delle chiamate agli strumenti, tieni conto dei caratteri di nuova riga finali.
6. Rivedi i tuoi prompt.
## Usa l'ID del modello Claude Haiku 5.5
Sostituisci l'ID del modello Claude Haiku 4.5 con l'ID di Claude Haiku 5.5 per la tua piattaforma.
| Piattaforma | Claude Haiku 4.5 | Claude Haiku 5.5 |
| ---------------------- | ------------------------------------------------ | ---------------------------- |
| Claude API | `claude-haiku-4-5-20251001` o `claude-haiku-4-5` | `claude-haiku-5-5` |
| Amazon Bedrock | `anthropic.claude-haiku-4-5` | `anthropic.claude-haiku-5-5` |
| Claude Platform on AWS | `claude-haiku-4-5` | `claude-haiku-5-5` |
| Google Cloud | `claude-haiku-4-5@20251001` | `claude-haiku-5-5` |
| Microsoft Foundry | `claude-haiku-4-5` | `claude-haiku-5-5` |
`claude-haiku-5-5` è un ID del modello fisso, senza suffisso di data e senza un alias separato.
## Riconta i token
Claude Haiku 5.5 usa lo stesso "tokenizer" (tokenizzatore) più recente di Claude 4.7 e dei modelli successivi. Come per tutti i modelli che usano questo tokenizer, lo stesso testo di input produce circa il 30% di token in più su Claude Haiku 5.5 rispetto a Claude Haiku 4.5. L'aumento esatto dipende dal contenuto. Richieste, risposte ed eventi di streaming mantengono la stessa struttura. Ciò che cambia è tutto ciò che misuri o pianifichi in token:
* I campi `usage` e i risultati del [conteggio dei token](https://platform.claude.com/docs/it/build-with-claude/token-counting) sono più alti per lo stesso testo.
* Un dato numero di token contiene meno testo.
* Un limite di `max_tokens` calibrato per Claude Haiku 4.5 potrebbe troncare un output equivalente.
* Le stime dei costi basate sui conteggi dei token di Claude Haiku 4.5 devono essere ricalcolate con i conteggi e i [prezzi](https://platform.claude.com/docs/it/about-claude/pricing) di Claude Haiku 5.5, inclusi i suoi prezzi più alti per i prompt lunghi. Consulta [Prezzi del contesto lungo](https://platform.claude.com/docs/it/about-claude/pricing#long-context-pricing).
Anche le immagini di grandi dimensioni possono costare più token. Claude Haiku 5.5 usa il livello di immagini ad alta risoluzione, che ridimensiona le immagini oltre i 2.576 pixel sul lato lungo o i 4.784 token visivi. Claude Haiku 4.5 e i modelli Haiku precedenti usano il livello standard, che ridimensiona le immagini oltre i 1.568 pixel sul lato lungo o i 1.568 token visivi. Un'immagine di 2.000 per 1.500 pixel costa circa 2,5 volte più token visivi su Claude Haiku 5.5 rispetto a Claude Haiku 4.5. Consulta [Risoluzione e costo in token](https://platform.claude.com/docs/it/build-with-claude/vision#evaluate-image-size).
Conta i token dei tuoi prompt con `model` impostato su `claude-haiku-5-5` invece di riutilizzare i conteggi misurati su Claude Haiku 4.5.
## Configura il ragionamento
Claude Haiku 5.5 configura il "thinking" (ragionamento) in modo diverso da Claude Haiku 4.5. Un valore di `thinking` pari a `{"type": "enabled", "budget_tokens": N}` restituisce un errore 400, quindi una richiesta che lo invia necessita di un nuovo valore di `thinking`.
Prima, una richiesta a Claude Haiku 4.5 impostava `thinking` su `enabled` con un budget di token:
```json
{
"model": "claude-haiku-4-5",
"max_tokens": 16000,
"thinking": { "type": "enabled", "budget_tokens": 8000 },
"messages": [{ "role": "user", "content": "..." }]
}
```
Dopo, la stessa richiesta a Claude Haiku 5.5 usa l'"adaptive thinking" (ragionamento adattivo). Il valore di `thinking` cambia e `output_config.effort` stabilisce quanto ragiona il modello:
```json
{
"model": "claude-haiku-5-5",
"max_tokens": 16000,
"thinking": { "type": "adaptive" },
"output_config": { "effort": "medium" },
"messages": [{ "role": "user", "content": "..." }]
}
```
Il ragionamento adattivo è attivo per impostazione predefinita, quindi una risposta può iniziare con uno o più blocchi `thinking` anche quando la richiesta non imposta `thinking`. Lascia `thinking` non impostato o impostalo su `{"type": "adaptive"}`, e usa l'[effort](https://platform.claude.com/docs/it/build-with-claude/effort) come leva: dove Claude Haiku 4.5 funzionava senza ragionamento, o con un budget ridotto per risparmiare token, scegli un livello di effort più basso. A un livello più basso il modello ragiona meno e può saltare del tutto il ragionamento nelle richieste più semplici. Per indicazioni sui prompt, consulta [Usa l'effort per controllare il ragionamento](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#use-effort-to-control-thinking). Seleziona i blocchi di contenuto in base al loro campo `type` anziché in base alla posizione, e rinvia i blocchi `thinking` senza modifiche insieme ai risultati degli strumenti.
I token di ragionamento contano ai fini di `max_tokens`, quindi una richiesta con un `max_tokens` ridotto può fermarsi con `stop_reason: "max_tokens"` dopo un blocco `thinking` e prima di qualsiasi testo. Se hai impostato un `max_tokens` ridotto per Claude Haiku 4.5, aumentalo per lasciare spazio al ragionamento, oppure scegli un livello di [effort](https://platform.claude.com/docs/it/build-with-claude/effort) più basso.
I blocchi di ragionamento dei turni precedenti dell'assistente restano nel contesto e vengono conteggiati come token di input, mentre Claude Haiku 4.5 conservava solo quelli dell'ultimo turno. Le conversazioni multi-turno contengono quindi più token di input di quanto spieghi il solo cambio di tokenizer. Per rimuovere i blocchi più vecchi, usa la [rimozione dei blocchi di ragionamento](https://platform.claude.com/docs/it/build-with-claude/context-editing#thinking-block-clearing). Consulta [Preservazione dei blocchi di ragionamento per modello](https://platform.claude.com/docs/it/build-with-claude/thinking#thinking-block-preservation-by-model).
Per impostazione predefinita, Claude Haiku 5.5 restituisce ogni blocco `thinking` con un campo `thinking` vuoto e solo una `signature`, mentre Claude Haiku 4.5 restituiva il ragionamento riassunto. Per ricevere il ragionamento riassunto, imposta `thinking: {"type": "adaptive", "display": "summarized"}`.
Claude Haiku 5.5 accetta un `tool_choice` forzato (`any` o uno strumento specifico), ma la risposta inizia con la chiamata allo strumento e non contiene alcun blocco `thinking`. Per consentire al modello di ragionare prima di chiamare uno strumento, usa `tool_choice: {"type": "auto"}` e indica nel prompt quando usare lo strumento.
Claude Haiku 5.5 legge i blocchi di ragionamento di Claude Sonnet 5, Claude Opus 4.8, Claude Haiku 4.5 e dei modelli precedenti, quindi una conversazione che sposti da Claude Haiku 4.5 a Claude Haiku 5.5 mantiene il suo ragionamento. Non legge i blocchi di Claude Opus 5, Claude Opus 5.5, Claude Sonnet 5.5 o di qualsiasi modello Claude Fable o Claude Mythos; l'API li scarta senza errori. Sulla Claude API e su Google Cloud, Claude Opus 5.5 e Claude Sonnet 5.5 leggono i blocchi di Claude Haiku 5.5. Consulta [Cambiare modello a metà conversazione](https://platform.claude.com/docs/it/build-with-claude/preserved-thinking#switching-models).
## Rimuovi i parametri di campionamento
Claude Haiku 4.5 accetta `temperature`, `top_p` e `top_k`. Su Claude Haiku 5.5, ometti tutti e tre e usa invece il prompt per guidare il comportamento del modello. Se una richiesta include `temperature`, deve essere `1`. Se include `top_p`, deve essere `0.99`, il suo valore predefinito. Qualsiasi altro valore di `temperature` o `top_p` restituisce un errore 400, incluso un `top_p` pari a `1`. Lo stesso vale per qualsiasi valore di `top_k` e per una richiesta che include sia `temperature` sia `top_p`.
## Sostituisci il prefill dell'assistente
Un "prefill" (precompilazione) è un turno finale dell'assistente in `messages` che il modello continua. Claude Haiku 4.5 lo accetta quando il ragionamento è disattivato. Claude Haiku 5.5 lo rifiuta con un errore 400, anche con il ragionamento disattivato. Termina `messages` con un turno dell'utente e sostituisci ogni prefill in base al suo scopo:
* **Formato dell'output:** usa gli [output strutturati](https://platform.claude.com/docs/it/build-with-claude/structured-outputs), oppure strumenti con campi enum per la classificazione. Su Amazon Bedrock, gli output strutturati non sono disponibili per Claude Haiku 5.5. Lì, descrivi il formato nel prompt o usa uno strumento senza `strict`, e convalida l'output nel tuo codice.
* **Preamboli:** chiedi nel prompt di sistema una risposta diretta.
* **Continuazioni:** spostale nel messaggio dell'utente, ad esempio "La tua risposta precedente è stata interrotta e terminava con `[previous_response]`. Continua da dove avevi interrotto."
* **Promemoria di contesto:** inseriscili nel turno dell'utente.
## Sposta il computer use sul toolset
Claude Haiku 4.5 supporta il [computer use](https://platform.claude.com/docs/it/agents-and-tools/tool-use/computer-use-tool) tramite lo strumento `computer_20250124`, con l'header beta `computer-use-2025-01-24`. Sulla Claude API e su Google Cloud, Claude Haiku 5.5 supporta il computer use solo tramite il toolset `computer_toolset_20260801`, e una richiesta che dichiara `computer_20250124` restituisce un errore 400. Neanche su Amazon Bedrock Claude Haiku 5.5 accetta `computer_20250124`; usa la versione dello strumento `computer_20251124` con l'header beta `computer-use-2025-11-24`.
Per spostare un'integrazione sul toolset, rimuovi l'header beta `computer-use-2025-01-24` e sostituisci la voce `tools` con `{"type": "computer_toolset_20260801"}`. Poi apporta le altre modifiche alla richiesta e al ciclo dell'agente descritte in [Migra da `computer_20251124`](https://platform.claude.com/docs/it/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124): smista in base a `name` e `toolset_name` di ciascun blocco `tool_use` membro anziché in base a `input.action`, gestisci ogni blocco di questo tipo in un turno e riporta `toolset_name` nei risultati. Lo zoom è attivo per impostazione predefinita nel toolset; se il tuo ambiente non lo implementa, aggiungi `"configs": {"zoom": {"enabled": false}}`. Se invii l'header beta `fine-grained-tool-streaming-2025-05-14`, rimuovilo. Insieme a una voce di toolset, restituisce un errore 400. Per le altre piattaforme, consulta la sezione [Compatibilità](https://platform.claude.com/docs/it/agents-and-tools/tool-use/computer-use-tool#compatibility) dello strumento computer use.
Sulla Claude API e su Google Cloud, Claude Haiku 5.5 supporta anche lo [strumento browser use](https://platform.claude.com/docs/it/agents-and-tools/tool-use/browser-use-tool) (`browser_toolset_20260801`) per le attività all'interno delle pagine web. Claude Haiku 4.5 non lo supporta.
## Riproduci i blocchi di ragionamento tramite l'account che li ha prodotti
I blocchi di ragionamento di Claude Haiku 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 veda e la richiesta va a buon fine senza quel ragionamento. Ciò riguarda il codice che memorizza le conversazioni e le riproduce tramite un account diverso, ad esempio un servizio che serve più clienti da un unico archivio di conversazioni. Riproduci ogni conversazione tramite l'account che l'ha prodotta. Consulta [I blocchi di ragionamento restano con l'account che li ha prodotti](https://platform.claude.com/docs/it/build-with-claude/preserved-thinking#account-bound-thinking).
## Mantieni invariati i turni precedenti
Un blocco di ragionamento di Claude Haiku 5.5 resta valido solo finché tutto ciò che è stato inviato prima di esso rimane invariato: una richiesta che rinvia un blocco di ragionamento dopo una modifica a `system`, `tools` o ai `messages` precedenti restituisce un errore 400. Claude Haiku 4.5 non esegue questo controllo. Mantieni le conversazioni in sola aggiunta. Sugli account creati prima del 31 agosto 2026, 00:00 UTC, l'errore si verifica solo nelle richieste che impostano `thinking.block_binding.prefix_mismatch_behavior`. Per le modifiche che attivano l'errore e cosa fare invece, consulta [Chi deve modificare qualcosa](https://platform.claude.com/docs/it/build-with-claude/preserved-thinking#who-is-affected).
## Migrazione a Claude Haiku 5.5 da Claude Haiku 3.5 e modelli Haiku precedenti
Claude Haiku 3.5 è ritirato sulla Claude API e su Amazon Bedrock, e Claude Haiku 3 è ritirato sulla Claude API e su Google Cloud. Le richieste a un modello ritirato non vanno a buon fine. Google Cloud elenca Claude Haiku 3.5 come deprecato e disponibile solo per i clienti esistenti. Consulta [Deprecazioni dei modelli](https://platform.claude.com/docs/it/about-claude/model-deprecations).
Da entrambi i modelli, applica prima tutte le sezioni precedenti, poi queste modifiche:
* **ID del modello:** Sostituisci `claude-3-5-haiku-20241022`, il suo alias `claude-3-5-haiku-latest` o `claude-3-haiku-20240307` con `claude-haiku-5-5`. Su Google Cloud, sostituisci `claude-3-5-haiku@20241022` con `claude-haiku-5-5`. Su Amazon Bedrock, usa l'ID di Claude Haiku 5.5 indicato in [Usa l'ID del modello Claude Haiku 5.5](https://platform.claude.com/docs/it/models/haiku-5-5/migration-guide#use-the-claude-haiku-5-5-model-id).
* **Esecuzione del codice:** Claude Haiku 5.5 accetta `code_execution_20250825` e le versioni successive. Se usi lo strumento legacy solo Python `code_execution_20250522`, passa a una di esse. Consulta [Aggiornamento all'ultima versione dello strumento](https://platform.claude.com/docs/it/agents-and-tools/tool-use/code-execution-tool#upgrade-to-latest-tool-version).
* **Editor di testo:** Se usi lo strumento editor di testo, passa a `text_editor_20250728` (nome dello strumento `str_replace_based_edit_tool`), che non dispone del comando `undo_edit`. Consulta [Strumento editor di testo](https://platform.claude.com/docs/it/agents-and-tools/tool-use/text-editor-tool).
* **Motivi di arresto:** Gestisci `refusal` e `model_context_window_exceeded`. Consulta [Gestione dei motivi di arresto](https://platform.claude.com/docs/it/build-with-claude/handling-stop-reasons).
* **Caratteri di nuova riga finali:** Claude 4.5 e i modelli successivi mantengono i caratteri di nuova riga finali nei parametri stringa delle chiamate agli strumenti. Se il tuo codice confronta esattamente queste stringhe, tienine conto.
* **Prompt:** Claude 4 e i modelli successivi hanno uno stile comunicativo più conciso e diretto e necessitano di indicazioni esplicite. Rivedi i tuoi prompt alla luce di [Prompting per Claude Haiku 5.5](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5) e delle [best practice per i prompt](https://platform.claude.com/docs/it/build-with-claude/prompt-engineering/claude-prompting-best-practices).