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 lungo termine 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 rivedere 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, che offre prestazioni di classe mondiale per ragionamento, codifica e agenti autonomi a lungo termine. Questa migrazione include diverse modifiche critiche che richiedono aggiornamenti alla tua implementazione.

Passaggi di migrazione

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"

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 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
    ...
)

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

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"}]
```
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. Vedi Documentazione dello strumento di esecuzione del codice per le istruzioni di migrazione.

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
    ...
)

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
    ...
)

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 Claude 4 per una guida all'ottimizzazione.
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 influisce sull'efficienza della .
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.

Checklist di 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 (se applicabile)

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, che offre qualità di 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à, vedi Novità in Claude 4.5.

Prezzi di Haiku 4.5: $1 per milione di token di input, $5 per milione di token di output. Vedi Prezzi di Claude per i dettagli.

Passaggi di migrazione

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"

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"}]

Checklist di 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 di abilitare il pensiero esteso per compiti di ragionamento complesso (nuova capacità)

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 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 di memoria e capacità di modifica del contesto
Compiti 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
Compiti 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 compiti 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 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 di prestazione superano il compromesso della 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 il tuo 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.

Semplicemente aggiorna il tuo 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 lungo termine di classe mondiale. Offre prestazioni superiori rispetto a Opus 4.1 per la maggior parte dei casi d'uso.

Migrazione da Claude Opus 4.1 → Opus 4.5

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

Semplicemente aggiorna il tuo ID del modello:

# Prima (Claude Opus 4.1)
model="claude-opus-4-1-20250805"

# Dopo (Claude Opus 4.5)
model="claude-opus-4-5-20251101"

Claude Opus 4.5 è il nostro modello più intelligente, che combina la massima capacità con prestazioni pratiche. Presenta miglioramenti significativi nella visione, codifica e uso del computer a un prezzo più accessibile rispetto a Opus 4.1. Ideale per compiti specializzati complessi e ingegneria del software professionale.

Per basi di codice con molti riferimenti ai modelli, è disponibile un plugin Claude Code per automatizzare la migrazione a Opus 4.5.

Migrazione tra modelli Claude 4.5

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

Semplicemente aggiorna il tuo ID del modello.

Hai bisogno di aiuto?

Controlla la nostra documentazione API per le specifiche dettagliate
Rivedi le capacità dei modelli per i confronti delle prestazioni
Rivedi le note di rilascio API per gli aggiornamenti API
Contatta il supporto se riscontri problemi durante la migrazione

token-efficient-tools-2025-02-19

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 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
    ...
)

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 influisce sull'efficienza della cache dei prompt.