Deprecazioni dei modelli
Scopri quali modelli Claude sono attivi, deprecati o ritirati, e trova le date di ritiro e le sostituzioni consigliate per modelli e parametri API.
Man mano che vengono lanciati modelli più sicuri e capaci, Anthropic ritira regolarmente quelli più vecchi. Le applicazioni che si basano sui modelli Anthropic potrebbero richiedere aggiornamenti occasionali per continuare a funzionare. I clienti interessati saranno sempre avvisati via email e nella documentazione.
Questa pagina elenca tutte le deprecazioni dell’API, insieme alle sostituzioni consigliate.
Panoramica
Anthropic utilizza i seguenti termini per descrivere il ciclo di vita dei modelli:
- Attivo (Active): Il modello è pienamente supportato e consigliato per l’uso.
- Legacy: Il modello non riceverà più aggiornamenti e potrebbe essere deprecato in futuro.
- Deprecato (Deprecated): Il modello è ancora funzionante ma non più consigliato. Anthropic fornisce una sostituzione consigliata e assegna una data di ritiro.
- Ritirato: Il modello non è più disponibile per l’uso. Le richieste ai modelli ritirati falliscono.
Le date in questa pagina si applicano alle piattaforme gestite da Anthropic: la Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) e Microsoft Foundry. Le piattaforme gestite dai partner, Claude Models on Google Cloud (Google managed) e Amazon Bedrock, stabiliscono i propri calendari di ritiro, quindi lo stato del ciclo di vita e le date di un modello possono differire. Consulta le tabelle dei modelli di Amazon Bedrock (bedrock-mantle), Amazon Bedrock (bedrock-runtime) e Claude Models on Google Cloud (Google managed).
Claude Code utilizza la Claude API, anche quando accedi con un piano Claude, quindi le date di questa pagina si applicano. Se Claude Code è configurato per un’altra piattaforma o per un gateway, le date sono quelle della piattaforma che gestisce le sue richieste.
Migrazione verso le sostituzioni
Una volta che un modello è deprecato, migra tutto l’utilizzo verso una sostituzione adeguata prima della data di ritiro. Una volta che il modello è ritirato, le richieste a esso falliscono.
Per aiutarti a misurare le prestazioni dei modelli sostitutivi sulle tue attività, considera di testare a fondo le tue applicazioni con i nuovi modelli ben prima della data di ritiro.
Per istruzioni specifiche sulla migrazione ai modelli Claude più recenti, consulta le Guide alla migrazione.
Se usi Claude Code, aggiornalo prima, perché un modello più recente può richiedere una versione più recente di Claude Code. Poi, verifica quale modello stai usando, anche se non hai impostato alcun modello o usi un alias di Claude Code come sonnet. Se quel modello è deprecato o ritirato, imposta la sua sostituzione consigliata come tuo modello. Inoltre, cambia il vecchio modello ovunque imposti un modello, incluse le definizioni dei “subagent” (subagenti), e chiedi al tuo amministratore di cambiare qualsiasi modello da lui impostato.
Notifiche
Anthropic avvisa i clienti con deployment attivi per i modelli con ritiri imminenti, fornendo un preavviso di almeno 60 giorni prima del ritiro del modello per i modelli rilasciati pubblicamente.
Verifica dell’utilizzo dei modelli
Per aiutarti a identificare l’utilizzo di modelli deprecati, puoi accedere a un audit del tuo utilizzo dell’API. Segui questi passaggi:
- Vai alla pagina Utilizzo nella Claude Console.
- Fai clic su Esporta.
- Esamina il CSV scaricato per vedere l’utilizzo suddiviso per chiave API e modello.
Questo audit ti aiuta a individuare tutti i casi in cui la tua applicazione utilizza ancora modelli deprecati, consentendoti di dare priorità agli aggiornamenti verso modelli più recenti prima della data di ritiro.
Best practice
- Controlla regolarmente la documentazione per aggiornamenti sulle deprecazioni dei modelli.
- Testa le tue applicazioni con modelli più recenti ben prima della data di ritiro del tuo modello attuale.
- Aggiorna il tuo codice per utilizzare il modello sostitutivo consigliato il prima possibile.
- Contatta il team di supporto se hai bisogno di aiuto con la migrazione o hai domande.
Svantaggi della deprecazione e mitigazioni
Anthropic attualmente depreca e ritira i modelli per garantire capacità per i nuovi rilasci di modelli. Questo comporta degli svantaggi:
- Gli utenti che apprezzano modelli specifici devono migrare a nuove versioni.
- I ricercatori perdono l’accesso ai modelli per studi in corso e comparativi.
- Il ritiro dei modelli introduce rischi legati alla sicurezza e al benessere dei modelli.
A un certo punto, Anthropic spera di rendere nuovamente disponibili al pubblico i modelli passati. Nel frattempo, Anthropic si è impegnata nella conservazione a lungo termine dei pesi dei modelli e in altre misure per aiutare a mitigare questi impatti. Per maggiori dettagli, consulta Commitments on Model Deprecation and Preservation.
Stato dei modelli
I modelli attuali e quelli ritirati di recente sono elencati nella tabella seguente con il loro stato:
| Nome del modello API | Stato attuale | Deprecato | Data di ritiro provvisoria |
|---|---|---|---|
claude-fable-5-2 | Attivo | N/D | Non prima della data 9 novembre 2027 |
claude-mythos-5-2 | Attivo | N/D | Non prima della data 9 novembre 2027 |
claude-fable-5-1 | Attivo | N/D | Non prima della data 1 settembre 2027 |
claude-mythos-5-1 | Attivo | N/D | Non prima della data 1 settembre 2027 |
claude-fable-5 | Attivo | N/D | Non prima della data 9 giugno 2027 |
claude-mythos-5 | Attivo | N/D | Non prima della data 9 giugno 2027 |
claude-mythos-preview | Deprecato | 9 giugno 2026 | Da annunciare |
claude-opus-5-5 | Attivo | N/D | Non prima della data 22 settembre 2027 |
claude-opus-5 | Attivo | N/D | Non prima della data 24 luglio 2027 |
claude-opus-4-8 | Attivo | N/D | Non prima della data 28 maggio 2027 |
claude-opus-4-7 | Attivo | N/D | Non prima della data 16 aprile 2027 |
claude-opus-4-6 | Attivo | N/D | Non prima della data 5 febbraio 2027 |
claude-opus-4-5-20251101 | Attivo | N/D | Non prima della data 24 novembre 2026 |
claude-opus-4-1-20250805 | Ritirato | 5 giugno 2026 | 5 agosto 2026 |
claude-opus-4-20250514 | Ritirato | 14 aprile 2026 | 15 giugno 2026 |
claude-sonnet-5-5 | Attivo | N/D | Non prima della data 28 settembre 2027 |
claude-sonnet-5 | Attivo | N/D | Non prima della data 30 giugno 2027 |
claude-sonnet-4-6 | Attivo | N/D | Non prima della data 17 febbraio 2027 |
claude-sonnet-4-5-20250929 | Deprecato | 30 settembre 2026 | 30 novembre 2026 |
claude-sonnet-4-20250514 | Ritirato | 14 aprile 2026 | 15 giugno 2026 |
claude-3-7-sonnet-20250219 | Ritirato | 28 ottobre 2025 | 19 febbraio 2026 |
claude-haiku-5-5 | Attivo | N/D | Non prima della data 7 ottobre 2027 |
claude-haiku-4-5-20251001 | Attivo | N/D | Non prima della data 15 ottobre 2026 |
claude-3-5-haiku-20241022 | Ritirato | 19 dicembre 2025 | 19 febbraio 2026 |
claude-3-haiku-20240307 | Ritirato | 19 febbraio 2026 | 20 aprile 2026 |
Cronologia delle deprecazioni
Tutte le deprecazioni sono elencate nelle sezioni seguenti, con gli annunci più recenti per primi.
2026-09-30: Modello Claude Sonnet 4.5
Il 30 settembre 2026, Anthropic ha notificato agli sviluppatori che utilizzano Claude Sonnet 4.5 il suo imminente ritiro sulla Claude API.
| Data di ritiro | Modello deprecato | Sostituzione consigliata |
|---|---|---|
| 30 novembre 2026 | claude-sonnet-4-5-20250929 | claude-sonnet-5-5 |
Questo ritiro include claude-sonnet-4-5, l’ID dello stesso modello senza data.
Se usi Claude Code, consulta Panoramica per sapere quali date si applicano e Migrazione verso le sostituzioni per sapere cosa modificare. Una volta che questo modello è ritirato, Claude Code sulla Claude API mostra un errore che inizia con There's an issue with the selected model. Se imposti una “fallback model chain” (catena di modelli di fallback), Claude Code passa invece al modello successivo nella catena. Claude Code riprova Claude Sonnet 4.5 al tuo messaggio successivo.
2026-06-05: Modello Claude Opus 4.1
Il 5 giugno 2026, Anthropic ha notificato agli sviluppatori che utilizzano Claude Opus 4.1 il suo imminente ritiro sulla Claude API.
| Data di ritiro | Modello deprecato | Sostituzione consigliata |
|---|---|---|
| 5 agosto 2026 | claude-opus-4-1-20250805 | claude-opus-4-8 |
2026-04-14: Modelli Claude Sonnet 4 e Claude Opus 4
Il 14 aprile 2026, Anthropic ha notificato agli sviluppatori che utilizzano i modelli Claude Sonnet 4 e Claude Opus 4 il loro imminente ritiro sulla Claude API.
| Data di ritiro | Modello deprecato | Sostituzione consigliata |
|---|---|---|
| 15 giugno 2026 | claude-sonnet-4-20250514 | claude-sonnet-5-5 |
| 15 giugno 2026 | claude-opus-4-20250514 | claude-opus-4-8 |
2026-02-19: Modello Claude Haiku 3
Il 19 febbraio 2026, Anthropic ha notificato agli sviluppatori che utilizzano Claude Haiku 3 il suo imminente ritiro sulla Claude API.
| Data di ritiro | Modello deprecato | Sostituzione consigliata |
|---|---|---|
| 20 aprile 2026 | claude-3-haiku-20240307 | claude-haiku-4-5-20251001 |
2025-12-19: Modello Claude Haiku 3.5
Il 19 dicembre 2025, Anthropic ha notificato agli sviluppatori che utilizzano Claude Haiku 3.5 il suo imminente ritiro sulla Claude API.
| Data di ritiro | Modello deprecato | Sostituzione consigliata |
|---|---|---|
| 19 febbraio 2026 | claude-3-5-haiku-20241022 | claude-haiku-4-5-20251001 |
2025-10-28: Modello Claude Sonnet 3.7
Il 28 ottobre 2025, Anthropic ha notificato agli sviluppatori che utilizzano Claude Sonnet 3.7 il suo imminente ritiro sulla Claude API.
| Data di ritiro | Modello deprecato | Sostituzione consigliata |
|---|---|---|
| 19 febbraio 2026 | claude-3-7-sonnet-20250219 | claude-sonnet-5-5 |
2025-08-13: Modelli Claude Sonnet 3.5
Il 13 agosto 2025, Anthropic ha notificato agli sviluppatori che utilizzano i modelli Claude Sonnet 3.5 il loro imminente ritiro.
| Data di ritiro | Modello deprecato | Sostituzione consigliata |
|---|---|---|
| 28 ottobre 2025 | claude-3-5-sonnet-20240620 | claude-sonnet-5-5 |
| 28 ottobre 2025 | claude-3-5-sonnet-20241022 | claude-sonnet-5-5 |
2025-06-30: Modello Claude Opus 3
Il 30 giugno 2025, Anthropic ha notificato agli sviluppatori che utilizzano Claude Opus 3 il suo imminente ritiro.
| Data di ritiro | Modello deprecato | Sostituzione consigliata |
|---|---|---|
| 5 gennaio 2026 | claude-3-opus-20240229 | claude-opus-4-8 |
2025-01-21: Modelli Claude 2, Claude 2.1 e Claude Sonnet 3
Il 21 gennaio 2025, Anthropic ha notificato agli sviluppatori che utilizzano i modelli Claude 2, Claude 2.1 e Claude Sonnet 3 i loro imminenti ritiri.
| Data di ritiro | Modello deprecato | Sostituzione consigliata |
|---|---|---|
| 21 luglio 2025 | claude-2.0 | claude-opus-4-8 |
| 21 luglio 2025 | claude-2.1 | claude-opus-4-8 |
| 21 luglio 2025 | claude-3-sonnet-20240229 | claude-sonnet-5-5 |
2024-09-04: Modelli Claude 1 e Instant
Il 4 settembre 2024, Anthropic ha notificato agli sviluppatori che utilizzano i modelli Claude 1 e Instant i loro imminenti ritiri.
| Data di ritiro | Modello deprecato | Sostituzione consigliata |
|---|---|---|
| 6 novembre 2024 | claude-1.0 | claude-haiku-4-5-20251001 |
| 6 novembre 2024 | claude-1.1 | claude-haiku-4-5-20251001 |
| 6 novembre 2024 | claude-1.2 | claude-haiku-4-5-20251001 |
| 6 novembre 2024 | claude-1.3 | claude-haiku-4-5-20251001 |
| 6 novembre 2024 | claude-instant-1.0 | claude-haiku-4-5-20251001 |
| 6 novembre 2024 | claude-instant-1.1 | claude-haiku-4-5-20251001 |
| 6 novembre 2024 | claude-instant-1.2 | claude-haiku-4-5-20251001 |
Deprecazioni dei parametri API
Anthropic depreca occasionalmente parametri di richiesta che non si applicano più ai modelli attuali. Un nuovo modello può rifiutare un parametro deprecato e una nuova versione dell’API può rimuoverlo per tutti i modelli.
| Parametro | Stato | Comportamento | Sostituzione consigliata |
|---|---|---|---|
temperature, top_p, top_k | Rimossi nella versione dell’API 2026-10-21 | Restituisce un errore 400. Le versioni precedenti dell’API lo restituiscono quando impostati su un valore non predefinito sui modelli Claude 4.7 e successivi e su Claude Mythos Preview. | Omettilo e usa il prompting per guidare il comportamento del modello. |
Per i passaggi di migrazione, consulta le Guide alla migrazione.
Questa pagina ti è stata utile?