ID dei modelli e versionamento

Ogni ID di modello Claude identifica una versione fissata del modello. Quando usi un ID di modello in una richiesta API, il modello sottostante rimane costante per tutta la durata di vita di quell'ID. Questa garanzia copre gli ID dei modelli, non gli alias di comodità che la Claude API accetta per alcuni modelli precedenti (vedi Prima della generazione 4.6).

Formato degli ID dei modelli

Gli ID dei modelli Claude seguono uno schema di denominazione versionato.

La generazione 4.6 e successive

A partire dalla generazione Claude 4.6, gli ID dei modelli usano un formato senza data:

claude-{name}-{major}[-{minor}]

I rilasci di versione principale come Claude Sonnet 5 e Claude Opus 5 omettono il segmento minore.

Ad esempio: claude-sonnet-4-6, claude-sonnet-5, claude-opus-4-6, claude-opus-4-7, claude-opus-4-8 e claude-opus-5

Su Amazon Bedrock, il formato corrispondente è:

anthropic.claude-{name}-{major}[-{minor}]

Ad esempio: anthropic.claude-sonnet-4-6, anthropic.claude-sonnet-5, anthropic.claude-opus-4-7, anthropic.claude-opus-4-8, anthropic.claude-opus-5

Claude Opus 4.6 è l'ultimo ID di modello Bedrock a includere il suffisso -v1 (anthropic.claude-opus-4-6-v1). Anthropic ha eliminato il suffisso a partire da Claude Sonnet 4.6.

Su Google Cloud, il formato corrisponde a quello della Claude API.

Prima della generazione 4.6

I modelli precedenti alla generazione 4.6 includono una data di "snapshot" (istantanea) nell'ID:

claude-{name}-{major}-{minor}-{YYYYMMDD}

Ad esempio: claude-sonnet-4-5-20250929, claude-haiku-4-5-20251001

Su Amazon Bedrock, questi usano il formato:

anthropic.claude-{name}-{major}-{minor}-{YYYYMMDD}-v1:0

Ad esempio: anthropic.claude-sonnet-4-5-20250929-v1:0

Su Google Cloud, la data è separata con @:

claude-{name}-{major}-{minor}@{YYYYMMDD}

Ad esempio: claude-haiku-4-5@20251001

Sulla Claude API, questi modelli hanno anche alias più brevi (ad esempio, claude-sonnet-4-5) che puntano allo snapshot datato più recente per quella versione minore.

Gli ID senza data sono snapshot fissati

Un'idea errata comune è che gli ID dei modelli senza data come claude-sonnet-4-6 si comportino come puntatori sempre aggiornati che instradano verso la versione più recente o con le migliori prestazioni. Non è così.

Per la generazione 4.6 e successive, l'ID senza data è l'ID di modello canonico per quel rilascio. Corrisponde a un singolo snapshot fisso del modello. Anthropic non aggiorna i pesi o la configurazione di un ID di modello esistente. Quando è disponibile una versione aggiornata, viene distribuita con un nuovo ID di modello.

Questo differisce dagli alias senza data che esistono sulla Claude API per i modelli precedenti. Un alias come claude-sonnet-4-5 è un puntatore di comodità che si risolve nello snapshot datato più recente per quella versione minore. Un ID della generazione 4.6 come claude-sonnet-4-6 non è un alias. È lo snapshot.

Ogni ID di modello, datato o senza data, ha il proprio calendario distinto di deprecazione e ritiro.

Pesi del modello rispetto all'infrastruttura di servizio

I "model weights" (pesi del modello) sono fissi per un dato ID, ma la "serving infrastructure" (infrastruttura di servizio) attorno al modello può cambiare nel tempo. Questa infrastruttura include componenti come il router delle richieste, i classificatori di sicurezza e la logica di campionamento.

Occasionalmente, gli aggiornamenti dell'infrastruttura producono lievi differenze nel comportamento osservabile anche quando l'ID del modello e i pesi non sono cambiati. Se noti differenze comportamentali inattese su un ID di modello precedentemente stabile, un aggiornamento dell'infrastruttura è la causa più probabile.

ID dei modelli attuali

Per l'elenco completo degli ID dei modelli attuali e dei loro equivalenti su Amazon Bedrock e Google Cloud, consulta la Panoramica dei modelli.