Claude Platform Docs
Modelli e prezziCiclo di vita e riferimento

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:

  1. Vai alla pagina Utilizzo nella Claude Console.
  2. Fai clic su Esporta.
  3. 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

  1. Controlla regolarmente la documentazione per aggiornamenti sulle deprecazioni dei modelli.
  2. Testa le tue applicazioni con modelli più recenti ben prima della data di ritiro del tuo modello attuale.
  3. Aggiorna il tuo codice per utilizzare il modello sostitutivo consigliato il prima possibile.
  4. 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 APIStato attualeDeprecatoData di ritiro provvisoria
claude-fable-5-2AttivoN/DNon prima della data 9 novembre 2027
claude-mythos-5-2AttivoN/DNon prima della data 9 novembre 2027
claude-fable-5-1AttivoN/DNon prima della data 1 settembre 2027
claude-mythos-5-1AttivoN/DNon prima della data 1 settembre 2027
claude-fable-5AttivoN/DNon prima della data 9 giugno 2027
claude-mythos-5AttivoN/DNon prima della data 9 giugno 2027
claude-mythos-previewDeprecato9 giugno 2026Da annunciare
claude-opus-5-5AttivoN/DNon prima della data 22 settembre 2027
claude-opus-5AttivoN/DNon prima della data 24 luglio 2027
claude-opus-4-8AttivoN/DNon prima della data 28 maggio 2027
claude-opus-4-7AttivoN/DNon prima della data 16 aprile 2027
claude-opus-4-6AttivoN/DNon prima della data 5 febbraio 2027
claude-opus-4-5-20251101AttivoN/DNon prima della data 24 novembre 2026
claude-opus-4-1-20250805Ritirato5 giugno 20265 agosto 2026
claude-opus-4-20250514Ritirato14 aprile 202615 giugno 2026
claude-sonnet-5-5AttivoN/DNon prima della data 28 settembre 2027
claude-sonnet-5AttivoN/DNon prima della data 30 giugno 2027
claude-sonnet-4-6AttivoN/DNon prima della data 17 febbraio 2027
claude-sonnet-4-5-20250929Deprecato30 settembre 202630 novembre 2026
claude-sonnet-4-20250514Ritirato14 aprile 202615 giugno 2026
claude-3-7-sonnet-20250219Ritirato28 ottobre 202519 febbraio 2026
claude-haiku-5-5AttivoN/DNon prima della data 7 ottobre 2027
claude-haiku-4-5-20251001AttivoN/DNon prima della data 15 ottobre 2026
claude-3-5-haiku-20241022Ritirato19 dicembre 202519 febbraio 2026
claude-3-haiku-20240307Ritirato19 febbraio 202620 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 ritiroModello deprecatoSostituzione consigliata
30 novembre 2026claude-sonnet-4-5-20250929claude-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 ritiroModello deprecatoSostituzione consigliata
5 agosto 2026claude-opus-4-1-20250805claude-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 ritiroModello deprecatoSostituzione consigliata
15 giugno 2026claude-sonnet-4-20250514claude-sonnet-5-5
15 giugno 2026claude-opus-4-20250514claude-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 ritiroModello deprecatoSostituzione consigliata
20 aprile 2026claude-3-haiku-20240307claude-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 ritiroModello deprecatoSostituzione consigliata
19 febbraio 2026claude-3-5-haiku-20241022claude-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 ritiroModello deprecatoSostituzione consigliata
19 febbraio 2026claude-3-7-sonnet-20250219claude-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 ritiroModello deprecatoSostituzione consigliata
28 ottobre 2025claude-3-5-sonnet-20240620claude-sonnet-5-5
28 ottobre 2025claude-3-5-sonnet-20241022claude-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 ritiroModello deprecatoSostituzione consigliata
5 gennaio 2026claude-3-opus-20240229claude-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 ritiroModello deprecatoSostituzione consigliata
21 luglio 2025claude-2.0claude-opus-4-8
21 luglio 2025claude-2.1claude-opus-4-8
21 luglio 2025claude-3-sonnet-20240229claude-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 ritiroModello deprecatoSostituzione consigliata
6 novembre 2024claude-1.0claude-haiku-4-5-20251001
6 novembre 2024claude-1.1claude-haiku-4-5-20251001
6 novembre 2024claude-1.2claude-haiku-4-5-20251001
6 novembre 2024claude-1.3claude-haiku-4-5-20251001
6 novembre 2024claude-instant-1.0claude-haiku-4-5-20251001
6 novembre 2024claude-instant-1.1claude-haiku-4-5-20251001
6 novembre 2024claude-instant-1.2claude-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.

ParametroStatoComportamentoSostituzione consigliata
temperature, top_p, top_kRimossi nella versione dell’API 2026-10-21Restituisce 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?