Migrazione a Claude 4.5

Questa guida copre due percorsi di migrazione chiave verso i modelli Claude 4.5:

• Claude Sonnet 3.7 → Claude Sonnet 4.5: Il nostro modello più intelligente con ragionamento, codifica e capacità di agenti a lunga durata di classe mondiale
• Claude Haiku 3.5 → Claude Haiku 4.5: Il nostro modello Haiku più veloce e intelligente con prestazioni quasi di frontiera per applicazioni in tempo reale ed elaborazione intelligente ad alto volume

Entrambe le migrazioni comportano modifiche critiche che richiedono aggiornamenti alla tua implementazione. Questa guida ti guiderà attraverso ogni percorso di migrazione con istruzioni passo dopo passo e modifiche critiche chiaramente indicate.

Prima di iniziare la migrazione, ti consigliamo di consultare Novità in Claude 4.5 per comprendere le nuove funzionalità e capacità disponibili in questi modelli, incluso 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, offrendo prestazioni di classe mondiale per il ragionamento, la codifica e gli agenti autonomi a lunga durata. Questa migrazione include diverse modifiche critiche che richiedono aggiornamenti alla tua implementazione.

Passaggi di migrazione

1. Aggiorna il nome del 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

   Questa è una modifica critica rispetto a Claude Sonnet 3.7.

   Usa solo temperature O top_p, non entrambi:

   # Prima (Claude Sonnet 3.7) - Questo genererà un 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 in modo appropriato
       pass

4. Aggiorna lo strumento editor di testo (se applicabile)

   Questa è una modifica critica rispetto a Claude Sonnet 3.7.

   Aggiorna a text_editor_20250728 (tipo) e str_replace_based_edit_tool (nome). Rimuovi qualsiasi codice che utilizza 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"}]

   Consulta la 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 è consigliata. Consulta la documentazione dello strumento di esecuzione del codice per le istruzioni di migrazione.

6. Rimuovi l'intestazione beta per l'uso efficiente dei token

   L'uso efficiente dei token è una funzionalità beta che funziona solo con Claude 3.7 Sonnet. Tutti i modelli Claude 4 hanno l'uso efficiente dei token integrato, quindi non dovresti più includere l'intestazione beta.

   Rimuovi l'intestazione 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",
       # Nessuna intestazione beta token-efficient-tools
       ...
   )

7. Rimuovi l'intestazione beta per l'output esteso

   L'intestazione beta output-128k-2025-02-19 per l'output esteso è disponibile solo in Claude Sonnet 3.7.

   Rimuovi questa intestazione 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",
       # Nessuna intestazione 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. Consulta le migliori pratiche di ingegneria dei prompt Claude 4 per una guida all'ottimizzazione.

9. Considera l'abilitazione del pensiero esteso per attività complesse

   Abilita il pensiero esteso per miglioramenti significativi delle prestazioni su attività 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 influisce sull'efficienza della memorizzazione nella cache dei prompt.

10. Testa la tua implementazione

Testa in un ambiente di sviluppo prima di distribuire in produzione per assicurarti che tutte le modifiche critiche siano gestite correttamente.

Elenco di controllo della migrazione da Sonnet 3.7 → 4.5

• Aggiorna l'ID del modello a claude-sonnet-4-5-20250929
• CRITICO: Aggiorna i parametri di campionamento per usare solo temperature O top_p, non entrambi
• Gestisci il nuovo motivo di arresto refusal nella tua applicazione
• CRITICO: Aggiorna lo strumento editor di testo a text_editor_20250728 e str_replace_based_edit_tool (se applicabile)
• CRITICO: Rimuovi qualsiasi codice che utilizza il comando undo_edit (se applicabile)
• Aggiorna lo strumento di esecuzione del codice a code_execution_20250825 (se applicabile)
• Rimuovi l'intestazione beta token-efficient-tools-2025-02-19 (se applicabile)
• Rimuovi l'intestazione beta output-128k-2025-02-19 (se applicabile)
• Rivedi e aggiorna i prompt seguendo le migliori pratiche Claude 4
• Considera l'abilitazione del pensiero esteso per attività di ragionamento complesso
• Gestisci il motivo di arresto model_context_window_exceeded (specifico di Sonnet 4.5)
• Considera l'abilitazione dello strumento di memoria per agenti a lunga durata (beta)
• Considera l'uso della cancellazione automatica delle chiamate di strumenti per la modifica del contesto (beta)
• Testa in ambiente di sviluppo prima della distribuzione in produzione

Funzionalità rimosse da Claude Sonnet 3.7

• Uso efficiente dei token: L'intestazione beta token-efficient-tools-2025-02-19 funziona solo con Claude 3.7 Sonnet e non è supportata nei modelli Claude 4 (vedi passaggio 6)
• Output esteso: L'intestazione beta output-128k-2025-02-19 non è supportata (vedi passaggio 7)

Entrambe le intestazioni possono essere incluse nelle richieste Claude 4 ma non avranno alcun 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 di frontiera, offrendo qualità del modello premium con prestazioni in tempo reale per applicazioni interattive ed elaborazione intelligente ad alto volume. Questa migrazione include diverse modifiche critiche che richiedono aggiornamenti alla tua implementazione.

Per una panoramica completa delle nuove capacità, consulta Novità in Claude 4.5.

Passaggi di migrazione

1. Aggiorna il nome del 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)

   Questa è una modifica critica 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 utilizza il comando undo_edit

3. Aggiorna i parametri di campionamento

   Questa è una modifica critica rispetto a Claude Haiku 3.5.

   Usa solo temperature O top_p, non entrambi:

   # Prima (Haiku 3.5) - Questo genererà un 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. Consulta la 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 l'abilitazione del pensiero esteso per attività complesse

   Abilita il pensiero esteso per miglioramenti significativi delle prestazioni su attività 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 influisce sull'efficienza della memorizzazione nella cache dei prompt.

7. Esplora le nuove capacità

   Consulta Novità in Claude 4.5 per i dettagli sulla consapevolezza del contesto, sulla capacità di output aumentata (64K token), sulla maggiore intelligenza e sulla velocità migliorata.

8. Testa la tua implementazione

   Testa in un ambiente di sviluppo prima di distribuire in produzione per assicurarti che tutte le modifiche critiche siano gestite correttamente.

Elenco di controllo della migrazione da Haiku 3.5 → 4.5

• Aggiorna l'ID del modello a claude-haiku-4-5-20251001
• CRITICO: Aggiorna le versioni degli strumenti alle più recenti (ad es. text_editor_20250728, code_execution_20250825) - le versioni legacy non sono supportate
• CRITICO: Rimuovi qualsiasi codice che utilizza il comando undo_edit (se applicabile)
• CRITICO: Aggiorna i parametri di campionamento per usare solo temperature O top_p, non entrambi
• Rivedi e regola per i nuovi limiti di velocità (separati da Haiku 3.5)
• Gestisci il nuovo motivo di arresto refusal nella tua applicazione
• Considera l'abilitazione del pensiero esteso per attività di ragionamento complesso (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 Claude 4
• Testa in ambiente di sviluppo prima della distribuzione in produzione

Scelta 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 classe mondiale per attività sofisticate
• Agenti autonomi a lunga durata: Prestazioni superiori per agenti che lavorano in modo indipendente per periodi prolungati
• Attività di codifica avanzate: 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 di memoria e capacità di modifica del contesto
• Attività che richiedono la massima capacità: Quando l'intelligenza e l'accuratezza sono le priorità principali

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

• Applicazioni in tempo reale: Tempi di risposta rapidi per esperienze utente interattive con prestazioni quasi di frontiera
• Elaborazione intelligente ad alto volume: Intelligenza conveniente su larga scala con velocità migliorata
• Distribuzioni sensibili ai costi: Prestazioni quasi di frontiera a prezzi inferiori
• Architetture di sub-agenti: Agenti veloci e intelligenti per sistemi multi-agente
• Uso del computer su larga scala: Automazione desktop e browser autonoma conveniente
• Attività che richiedono velocità: Quando la bassa latenza è critica mantenendo un'intelligenza quasi di frontiera

Raccomandazioni sul pensiero esteso

I modelli Claude 4, in particolare Sonnet e Haiku 4.5, mostrano miglioramenti significativi delle prestazioni quando si utilizza il pensiero esteso per attività di codifica e ragionamento complesso. Il pensiero esteso è disabilitato per impostazione predefinita ma ti consigliamo di abilitarlo per il lavoro impegnativo.

Importante: Il pensiero esteso influisce sull'efficienza della memorizzazione nella cache dei prompt. Quando il contenuto non relativo ai risultati degli strumenti viene aggiunto a una conversazione, i blocchi di pensiero vengono rimossi dalla cache, il che può aumentare i costi nelle conversazioni multi-turno. Ti consigliamo di abilitare il pensiero quando i vantaggi in termini di prestazioni superano il compromesso della memorizzazione nella cache.

Altri scenari di migrazione

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

Migrazione da Claude Sonnet 4 → Sonnet 4.5

Modifica critica: Non puoi specificare sia temperature che top_p nella stessa richiesta.

Tutte le altre chiamate API funzioneranno senza modifiche. Aggiorna l'ID del modello e regola 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

Nessuna modifica critica. Tutte le chiamate API funzioneranno senza modifiche.

Aggiorna semplicemente l'ID del 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 ragionamento, codifica e capacità di agenti a lunga durata di classe mondiale. Offre prestazioni superiori rispetto a Opus 4.1 per la maggior parte dei casi d'uso.

Hai bisogno di aiuto?

• Consulta la nostra documentazione API per le specifiche dettagliate
• Rivedi le capacità del modello per i confronti delle prestazioni
• Rivedi le note di rilascio dell'API per gli aggiornamenti dell'API
• Contatta il supporto se riscontri problemi durante la migrazione