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:

1. Aggiorna il nome del tuo modello:

   • Da: claude-3-7-sonnet-20250219
   • A: claude-sonnet-4-20250514 o claude-opus-4-20250514

2. 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:

{"id":"msg_014XEDjypDjFzgKVWdFUXxZP",
"type":"message",
"role":"assistant",
"model":"claude-sonnet-4-20250514",
"content":[{"type":"text","text":"I would be happy to assist you. You can "}],
"stop_reason":"refusal",
"stop_sequence":null,
"usage":{"input_tokens":564,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":22}
}

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.

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.

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.

Se stai migrando da Claude Sonnet 3.7 e utilizzi lo strumento editor di testo:

# Claude Sonnet 3.7
tools=[
    {
        "type": "text_editor_20250124",
        "name": "str_replace_editor"
    }
]

# Claude 4
tools=[
    {
        "type": "text_editor_20250429",
        "name": "str_replace_based_edit_tool"
    }
]

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.