Migrazione a Claude 4
Questa pagina fornisce indicazioni sulla migrazione dai modelli Claude 3.7 ai modelli Claude 4 (Opus 4 e Sonnet 4).
Nella maggior parte dei casi, puoi passare ai modelli Claude 4 con modifiche minime:
-
Aggiorna il nome del tuo modello:
- Da:
claude-3-7-sonnet-20250219
- A:
claude-sonnet-4-20250514
oclaude-opus-4-20250514
- Da:
-
Le chiamate API esistenti dovrebbero continuare a funzionare senza modifiche, sebbene il comportamento dell’API sia leggermente cambiato nei modelli Claude 4 (vedi note di rilascio API per i dettagli).
Cosa c’è di nuovo in Claude 4
Nuovo motivo di interruzione per rifiuto
I modelli Claude 4 introducono un nuovo motivo di interruzione refusal
per contenuti che il modello rifiuta di generare per motivi di sicurezza, a causa dell’intelligenza aumentata dei modelli Claude 4:
Durante la migrazione a Claude 4, dovresti aggiornare la tua applicazione per gestire i motivi di interruzione refusal
.
Pensiero riassunto
Con il pensiero esteso abilitato, l’API Messages per i modelli Claude 4 restituisce un riepilogo del processo di pensiero completo di Claude. Il pensiero riassunto fornisce tutti i vantaggi di intelligenza del pensiero esteso, prevenendo al contempo l’uso improprio.
Mentre l’API è coerente tra i modelli Claude 3.7 e 4, le risposte in streaming per il pensiero esteso potrebbero essere restituite con un modello di consegna “a blocchi”, con possibili ritardi tra gli eventi di streaming.
Il riassunto viene elaborato da un modello diverso da quello a cui ti rivolgi nelle tue richieste. Il modello di pensiero non vede l’output riassunto.
Per ulteriori informazioni, consulta la documentazione sul pensiero esteso.
Pensiero intrecciato
I modelli Claude 4 supportano l’intreccio dell’uso degli strumenti con il pensiero esteso, consentendo conversazioni più naturali in cui gli usi degli strumenti e le risposte possono essere mescolati con i messaggi regolari.
Il pensiero intrecciato è in versione beta. Per abilitare il pensiero intrecciato, aggiungi l’intestazione beta interleaved-thinking-2025-05-14
alla tua richiesta API.
Per ulteriori informazioni, consulta la documentazione sul pensiero esteso.
Strumento editor di testo aggiornato
Lo strumento editor di testo è stato aggiornato per i modelli Claude 4 con le seguenti modifiche:
- Tipo di strumento:
text_editor_20250429
- Nome dello strumento:
str_replace_based_edit_tool
- Il comando
undo_edit
non è più supportato nei modelli Claude 4.
Lo strumento editor di testo str_replace_editor
rimane lo stesso per Claude Sonnet 3.7.
Se stai migrando da Claude Sonnet 3.7 e utilizzi lo strumento editor di testo:
Per ulteriori informazioni, consulta la documentazione sullo strumento editor di testo.
Uso efficiente dei token per gli strumenti non più supportato
L’uso efficiente dei token per gli strumenti è disponibile solo in Claude Sonnet 3.7.
Se stai migrando da Claude Sonnet 3.7 e utilizzi l’uso efficiente dei token per gli strumenti, ti consigliamo di rimuovere l’intestazione beta token-efficient-tools-2025-02-19
dalle tue richieste.
L’intestazione beta token-efficient-tools-2025-02-19
può ancora essere inclusa nelle richieste per Claude 4, ma non avrà alcun effetto.
Output esteso non più supportato
L’intestazione beta output-128k-2025-02-19
per l’output esteso è disponibile solo in Claude Sonnet 3.7.
Se stai migrando da Claude Sonnet 3.7, ti consigliamo di rimuovere output-128k-2025-02-19
dalle tue richieste.
L’intestazione beta output-128k-2025-02-19
può ancora essere inclusa nelle richieste per Claude 4, ma non avrà alcun effetto.
Considerazioni sulle prestazioni
Claude Sonnet 4
- Migliorate capacità di ragionamento e intelligenza rispetto a Claude Sonnet 3.7
- Maggiore precisione nell’uso degli strumenti
Claude Opus 4
- Modello più capace con ragionamento e intelligenza superiori
- Più lento dei modelli Sonnet
- Ideale per attività complesse che richiedono un’analisi approfondita
Checklist per la migrazione
- Aggiorna l’ID del modello nelle tue chiamate API
- Testa le richieste esistenti (dovrebbero funzionare senza modifiche)
- Rimuovi l’intestazione beta
token-efficient-tools-2025-02-19
se applicabile - Rimuovi l’intestazione beta
output-128k-2025-02-19
se applicabile - Gestisci il nuovo motivo di interruzione
refusal
- Aggiorna il tipo e il nome dello strumento editor di testo se lo stai utilizzando
- Rimuovi qualsiasi codice che utilizza il comando
undo_edit
- Esplora le nuove capacità di intreccio degli strumenti con il pensiero esteso
- Rivedi le migliori pratiche di prompt engineering per Claude 4 per risultati ottimali
- Testa in ambiente di sviluppo prima del deployment in produzione
Hai bisogno di aiuto?
- Consulta la nostra documentazione API per specifiche dettagliate.
- Rivedi le capacità dei modelli per confronti sulle prestazioni.
- Rivedi le note di rilascio API per gli aggiornamenti API.
- Contatta il supporto se riscontri problemi durante la migrazione.