Monitoraggio deprecazioni e migrazioni
I modelli vengono ritirati, i parametri vengono rinominati, i comportamenti cambiano. Questa pagina tiene traccia delle modifiche incompatibili in modo che gli aggiornamenti non ti colgano di sorpresa. Se costruisci sull'API, dalle un'occhiata periodicamente.
Perché è importante
Un ID di modello fissato verrà prima o poi deprecato e poi rimosso. Il codice che lo scrive in modo fisso si rompe. Un po' di igiene previene sorprese alle 2 di notte.
Regole di sopravvivenza
- Leggi gli ID dei modelli dalla configurazione, non disseminare valori letterali in tutta la base di codice — così migrare è una modifica di una sola riga.
- Tieni d'occhio gli annunci per le date di deprecazione e le sostituzioni consigliate.
- Riesegui le tue eval quando cambi modello — il comportamento può variare anche su un modello "più nuovo e migliore".
- Testa prima della scadenza, non dopo la rimozione.
Tipi comuni di modifica
| Modifica | Esempio | Cosa fare |
|---|---|---|
| Modello ritirato | Un ID di modello più vecchio smette di funzionare | Passa al successore consigliato; rivaluta |
| Parametro sostituito | Una manopola di reasoning/budget rimpiazzata da effort | Aggiorna le chiamate; vedi Thinking ed Effort |
| Cambio di default | Un nuovo modello/comportamento predefinito | Fissa intenzionalmente; verifica che i tuoi prompt funzionino ancora |
| Aggiornamento endpoint/SDK | Nuova versione major dell'SDK | Leggi la guida alla migrazione; aggiorna con cautela |
Monitoraggio attuale
La pianificazione autorevole si trova nella pagina ufficiale delle deprecazioni dei modelli — conferma lì le date prima di migrare. Anthropic dà un preavviso di almeno 60 giorni prima di ritirare un modello rilasciato pubblicamente.
Modelli deprecati
| ID modello | Deprecato | Ritiro | Passa a |
|---|---|---|---|
claude-opus-4-1-20250805 (Opus 4.1) | 5 giugno 2026 | 5 agosto 2026 | claude-opus-4-8 |
Le richieste a un modello oltre la sua data di ritiro falliscono — se hai fissato Opus 4.1, migra prima della scadenza.
Ritirati di recente
claude-opus-4-20250514 (Opus 4) e claude-sonnet-4-20250514 (Sonnet 4) sono stati ritirati il 15 giugno 2026. Le chiamate a quegli ID ora danno errore — passa rispettivamente a claude-opus-4-8 e claude-sonnet-5.
Deprecazioni di parametri
Su Claude Opus 4.7 e versioni successive (incluso Opus 4.8), le manopole di campionamento temperature, top_p e top_k sono deprecate: impostarne una qualsiasi a un valore non predefinito restituisce un errore 400. Omettile e orienta il comportamento con il prompting e Thinking ed Effort.
Verifica sempre i tuoi ID di modello rispetto alla tabella Modelli e prezzi attuali; se sei su un ID più vecchio, pianifica una migrazione.