Questa guida copre due percorsi di migrazione chiave ai modelli Claude 4.5:
  • Claude Sonnet 3.7 → Claude Sonnet 4.5: Il nostro modello più intelligente con capacità di ragionamento, codifica e agenti a lungo termine di prima classe
  • Claude Haiku 3.5 → Claude Haiku 4.5: Il nostro modello Haiku più veloce e intelligente con prestazioni quasi all’avanguardia per applicazioni in tempo reale e elaborazione intelligente ad alto volume
Entrambe le migrazioni comportano cambiamenti che interrompono la compatibilità e richiedono aggiornamenti alla tua implementazione. Questa guida ti guiderà attraverso ogni percorso di migrazione con istruzioni passo dopo passo e cambiamenti che interrompono la compatibilità chiaramente contrassegnati. Prima di iniziare la migrazione, raccomandiamo di rivedere Novità in Claude 4.5 per comprendere le nuove funzionalità e capacità disponibili in questi modelli, inclusi il pensiero esteso, la consapevolezza del contesto e i miglioramenti comportamentali.

​
Migrazione da Claude Sonnet 3.7 a Claude Sonnet 4.5

Claude Sonnet 4.5 è il nostro modello più intelligente, che offre prestazioni di prima classe per ragionamento, codifica e agenti autonomi a lungo termine. Questa migrazione include diversi cambiamenti che interrompono la compatibilità e richiedono aggiornamenti alla tua implementazione.

​
Passaggi di migrazione

  1. Aggiorna il nome del tuo modello: 
    # Prima (Claude Sonnet 3.7)
model="claude-3-7-sonnet-20250219"

# Dopo (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"
  2. Aggiorna i parametri di campionamento
    Questo è un cambiamento che interrompe la compatibilità rispetto a Claude Sonnet 3.7.
    Usa solo temperature O top_p, non entrambi: 
    # Prima (Claude Sonnet 3.7) - Questo darà errore in Sonnet 4.5
response = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    temperature=0.7,
    top_p=0.9,  # Non puoi usare entrambi
    ...
)

# Dopo (Claude Sonnet 4.5)
response = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    temperature=0.7,  # Usa temperature O top_p, non entrambi
    ...
)
  3. Gestisci il nuovo motivo di arresto refusal Aggiorna la tua applicazione per gestire i motivi di arresto refusal: 
    response = client.messages.create(...)

if response.stop_reason == "refusal":
    # Gestisci il rifiuto appropriatamente
    pass
  4. Aggiorna lo strumento editor di testo (se applicabile)
    Questo è un cambiamento che interrompe la compatibilità rispetto a Claude Sonnet 3.7.
    Aggiorna a text_editor_20250728 (tipo) e str_replace_based_edit_tool (nome). Rimuovi qualsiasi codice che usa il comando undo_edit. 
    # Prima (Claude Sonnet 3.7)
tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]

# Dopo (Claude Sonnet 4.5)
tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
    Vedi Documentazione dello strumento editor di testo per i dettagli.
  5. Aggiorna lo strumento di esecuzione del codice (se applicabile) Aggiorna a code_execution_20250825. La versione legacy code_execution_20250522 funziona ancora ma non è raccomandata. Vedi Documentazione dello strumento di esecuzione del codice per le istruzioni di migrazione.
  6. Rimuovi l’header beta per l’uso efficiente dei token degli strumenti L’uso efficiente dei token degli strumenti è una funzionalità beta in Claude 3.7. Tutti i modelli Claude 4 hanno l’uso efficiente dei token degli strumenti integrato, quindi non dovresti più includere l’header beta. Rimuovi l’header beta token-efficient-tools-2025-02-19 dalle tue richieste: 
    # Prima (Claude Sonnet 3.7)
client.messages.create(
    model="claude-3-7-sonnet-20250219",
    betas=["token-efficient-tools-2025-02-19"],  # Rimuovi questo
    ...
)

# Dopo (Claude Sonnet 4.5)
client.messages.create(
    model="claude-sonnet-4-5-20250929",
    # Nessun header beta token-efficient-tools
    ...
)
  7. Rimuovi l’header beta per l’output esteso L’header beta output-128k-2025-02-19 per l’output esteso è disponibile solo in Claude Sonnet 3.7. Rimuovi questo header dalle tue richieste: 
    # Prima (Claude Sonnet 3.7)
client.messages.create(
    model="claude-3-7-sonnet-20250219",
    betas=["output-128k-2025-02-19"],  # Rimuovi questo
    ...
)

# Dopo (Claude Sonnet 4.5)
client.messages.create(
    model="claude-sonnet-4-5-20250929",
    # Nessun header beta output-128k
    ...
)
  8. Aggiorna i tuoi prompt per i cambiamenti comportamentali Claude Sonnet 4.5 ha uno stile di comunicazione più conciso e diretto e richiede una direzione esplicita. Rivedi Le migliori pratiche di ingegneria dei prompt di Claude 4 per una guida all’ottimizzazione.
  9. Considera di abilitare il pensiero esteso per compiti complessi Abilita il pensiero esteso per miglioramenti significativi delle prestazioni su compiti di codifica e ragionamento (disabilitato per impostazione predefinita): 
    response = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 10000},
    messages=[...]
)
    Il pensiero esteso impatta l’efficienza del caching dei prompt.
  10. Testa la tua implementazione
Testa in un ambiente di sviluppo prima di distribuire in produzione per assicurarti che tutti i cambiamenti che interrompono la compatibilità siano gestiti correttamente.

​
Lista di controllo per la migrazione Sonnet 3.7 → 4.5

  • Aggiorna l’ID del modello a claude-sonnet-4-5-20250929
  • INTERRUZIONE: Aggiorna i parametri di campionamento per usare solo temperature O top_p, non entrambi
  • Gestisci il nuovo motivo di arresto refusal nella tua applicazione
  • INTERRUZIONE: Aggiorna lo strumento editor di testo a text_editor_20250728 e str_replace_based_edit_tool (se applicabile)
  • INTERRUZIONE: Rimuovi qualsiasi codice che usa il comando undo_edit (se applicabile)
  • Aggiorna lo strumento di esecuzione del codice a code_execution_20250825 (se applicabile)
  • Rimuovi l’header beta token-efficient-tools-2025-02-19 (se applicabile)
  • Rimuovi l’header beta output-128k-2025-02-19 (se applicabile)
  • Rivedi e aggiorna i prompt seguendo le migliori pratiche di Claude 4
  • Considera di abilitare il pensiero esteso per compiti di ragionamento complessi
  • Gestisci il motivo di arresto model_context_window_exceeded (specifico di Sonnet 4.5)
  • Considera di abilitare lo strumento memoria per agenti a lungo termine (beta)
  • Considera di usare la cancellazione automatica delle chiamate agli strumenti per l’editing del contesto (beta)
  • Testa nell’ambiente di sviluppo prima della distribuzione in produzione

​
Funzionalità rimosse da Claude Sonnet 3.7

  • Uso efficiente dei token degli strumenti: L’header beta token-efficient-tools-2025-02-19 non è supportato (vedi passaggio 6)
  • Output esteso: L’header beta output-128k-2025-02-19 non è supportato (vedi passaggio 7)
Entrambi gli header possono essere inclusi nelle richieste ma non avranno effetto.

​
Migrazione da Claude Haiku 3.5 a Claude Haiku 4.5

Claude Haiku 4.5 è il nostro modello Haiku più veloce e intelligente con prestazioni quasi all’avanguardia, che offre qualità di modello premium con prestazioni in tempo reale per applicazioni interattive e elaborazione intelligente ad alto volume. Questa migrazione include diversi cambiamenti che interrompono la compatibilità e richiedono aggiornamenti alla tua implementazione. Per una panoramica completa delle nuove capacità, vedi Novità in Claude 4.5.
Prezzi di Haiku 4.5: 1permilioneditokendiinput,1 per milione di token di input, 5 per milione di token di output. Vedi Prezzi di Claude per i dettagli.

​
Passaggi di migrazione

  1. Aggiorna il nome del tuo modello: 
    # Prima (Haiku 3.5)
model="claude-3-5-haiku-20241022"

# Dopo (Haiku 4.5)
model="claude-haiku-4-5-20251001"
  2. Aggiorna le versioni degli strumenti (se applicabile)
    Questo è un cambiamento che interrompe la compatibilità rispetto a Claude Haiku 3.5.
    Haiku 4.5 supporta solo le versioni più recenti degli strumenti: 
    # Prima (Haiku 3.5)
tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]

# Dopo (Haiku 4.5)
tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
    • Editor di testo: Usa text_editor_20250728 e str_replace_based_edit_tool
    • Esecuzione del codice: Usa code_execution_20250825
    • Rimuovi qualsiasi codice che usa il comando undo_edit
  3. Aggiorna i parametri di campionamento
    Questo è un cambiamento che interrompe la compatibilità rispetto a Claude Haiku 3.5.
    Usa solo temperature O top_p, non entrambi: 
    # Prima (Haiku 3.5) - Questo darà errore in Haiku 4.5
response = client.messages.create(
    model="claude-3-5-haiku-20241022",
    temperature=0.7,
    top_p=0.9,  # Non puoi usare entrambi
    ...
)

# Dopo (Haiku 4.5)
response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    temperature=0.7,  # Usa temperature O top_p, non entrambi
    ...
)
  4. Rivedi i nuovi limiti di velocità Haiku 4.5 ha limiti di velocità separati da Haiku 3.5. Vedi Documentazione sui limiti di velocità per i dettagli.
  5. Gestisci il nuovo motivo di arresto refusal Aggiorna la tua applicazione per gestire i motivi di arresto refusal.
  6. Considera di abilitare il pensiero esteso per compiti complessi Abilita il pensiero esteso per miglioramenti significativi delle prestazioni su compiti di codifica e ragionamento (disabilitato per impostazione predefinita): 
    response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 5000},
    messages=[...]
)
    Il pensiero esteso impatta l’efficienza del caching dei prompt.
  7. Esplora le nuove capacità Vedi Novità in Claude 4.5 per i dettagli sulla consapevolezza del contesto, capacità di output aumentata (64K token), intelligenza superiore e velocità migliorata.
  8. Testa la tua implementazione Testa in un ambiente di sviluppo prima di distribuire in produzione per assicurarti che tutti i cambiamenti che interrompono la compatibilità siano gestiti correttamente.

​
Lista di controllo per la migrazione Haiku 3.5 → 4.5

  • Aggiorna l’ID del modello a claude-haiku-4-5-20251001
  • INTERRUZIONE: Aggiorna le versioni degli strumenti alle più recenti (es. text_editor_20250728, code_execution_20250825) - versioni legacy non supportate
  • INTERRUZIONE: Rimuovi qualsiasi codice che usa il comando undo_edit (se applicabile)
  • INTERRUZIONE: Aggiorna i parametri di campionamento per usare solo temperature O top_p, non entrambi
  • Rivedi e adatta ai nuovi limiti di velocità (separati da Haiku 3.5)
  • Gestisci il nuovo motivo di arresto refusal nella tua applicazione
  • Considera di abilitare il pensiero esteso per compiti di ragionamento complessi (nuova capacità)
  • Sfrutta la consapevolezza del contesto per una migliore gestione dei token in sessioni lunghe
  • Preparati per risposte più grandi (output massimo aumentato da 8K a 64K token)
  • Rivedi e aggiorna i prompt seguendo le migliori pratiche di Claude 4
  • Testa nell’ambiente di sviluppo prima della distribuzione in produzione

​
Scegliere tra Sonnet 4.5 e Haiku 4.5

Sia Claude Sonnet 4.5 che Claude Haiku 4.5 sono potenti modelli Claude 4 con punti di forza diversi:

​
Scegli Claude Sonnet 4.5 (più intelligente) per:

  • Ragionamento e analisi complessi: Intelligenza di prima classe per compiti sofisticati
  • Agenti autonomi a lungo termine: Prestazioni superiori per agenti che lavorano indipendentemente per periodi estesi
  • Compiti di codifica avanzati: Il nostro modello di codifica più forte con pianificazione avanzata e ingegneria della sicurezza
  • Flussi di lavoro con contesto ampio: Gestione del contesto migliorata con strumento memoria e capacità di editing del contesto
  • Compiti che richiedono capacità massima: Quando intelligenza e accuratezza sono le priorità principali

​
Scegli Claude Haiku 4.5 (Haiku più veloce e intelligente) per:

  • Applicazioni in tempo reale: Tempi di risposta veloci per esperienze utente interattive con prestazioni quasi all’avanguardia
  • Elaborazione intelligente ad alto volume: Intelligenza conveniente su scala con velocità migliorata
  • Distribuzioni sensibili ai costi: Prestazioni quasi all’avanguardia a prezzi più bassi
  • Architetture di sotto-agenti: Agenti veloci e intelligenti per sistemi multi-agente
  • Uso del computer su scala: Automazione desktop e browser autonoma conveniente
  • Compiti che richiedono velocità: Quando la bassa latenza è critica mantenendo intelligenza quasi all’avanguardia

​
Raccomandazioni per il pensiero esteso

I modelli Claude 4, in particolare Sonnet e Haiku 4.5, mostrano miglioramenti significativi delle prestazioni quando usano il pensiero esteso per compiti di codifica e ragionamento complessi. Il pensiero esteso è disabilitato per impostazione predefinita ma raccomandiamo di abilitarlo per lavori impegnativi. Importante: Il pensiero esteso impatta l’efficienza del caching dei prompt. Quando contenuto non-tool-result viene aggiunto a una conversazione, i blocchi di pensiero vengono rimossi dalla cache, il che può aumentare i costi nelle conversazioni multi-turno. Raccomandiamo di abilitare il pensiero quando i benefici delle prestazioni superano il compromesso del caching.

​
Altri scenari di migrazione

I percorsi di migrazione principali coperti sopra (Sonnet 3.7 → 4.5 e Haiku 3.5 → 4.5) rappresentano gli aggiornamenti più comuni. Tuttavia, potresti stare migrando da altri modelli Claude a Claude 4.5. Questa sezione copre quegli scenari.

​
Migrazione da Claude Sonnet 4 → Sonnet 4.5

Cambiamento che interrompe la compatibilità: Non puoi specificare sia temperature che top_p nella stessa richiesta. Tutte le altre chiamate API funzioneranno senza modifiche. Aggiorna il tuo ID modello e adatta i parametri di campionamento se necessario: 
# Prima (Claude Sonnet 4)
model="claude-sonnet-4-20250514"

# Dopo (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"

​
Migrazione da Claude Opus 4.1 → Sonnet 4.5

Nessun cambiamento che interrompe la compatibilità. Tutte le chiamate API funzioneranno senza modifiche. Semplicemente aggiorna il tuo ID modello: 
# Prima (Claude Opus 4.1)
model="claude-opus-4-1-20250805"

# Dopo (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"
Claude Sonnet 4.5 è il nostro modello più intelligente con capacità di ragionamento, codifica e agenti a lungo termine di prima classe. Offre prestazioni superiori rispetto a Opus 4.1 per la maggior parte dei casi d’uso.

​
Hai bisogno di aiuto?