IDs de modelo y versionado

Cada ID de modelo de Claude identifica una versión fija del modelo. Cuando usas un ID de modelo en una solicitud a la API, el modelo subyacente permanece constante durante toda la vida útil de ese ID. Esta garantía cubre los IDs de modelo, no los alias de conveniencia que la Claude API acepta para algunos modelos anteriores (consulta Antes de la generación 4.6).

Formato del ID de modelo

Los IDs de modelo de Claude siguen un esquema de nomenclatura versionado.

La generación 4.6 y posteriores

A partir de la generación Claude 4.6, los IDs de modelo usan un formato sin fecha:

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

Los lanzamientos de versión mayor, como Claude Sonnet 5 y Claude Opus 5, omiten el segmento de versión menor.

Por ejemplo: claude-sonnet-4-6, claude-sonnet-5, claude-opus-4-6, claude-opus-4-7, claude-opus-4-8 y claude-opus-5

En Amazon Bedrock, el formato correspondiente es:

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

Por ejemplo: 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 es el último ID de modelo de Bedrock que incluye el sufijo -v1 (anthropic.claude-opus-4-6-v1). Anthropic eliminó el sufijo a partir de Claude Sonnet 4.6.

En Google Cloud, el formato coincide con el de la Claude API.

Antes de la generación 4.6

Los modelos anteriores a la generación 4.6 incluyen una fecha de "snapshot" (instantánea) en el ID:

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

Por ejemplo: claude-sonnet-4-5-20250929, claude-haiku-4-5-20251001

En Amazon Bedrock, estos usan el formato:

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

Por ejemplo: anthropic.claude-sonnet-4-5-20250929-v1:0

En Google Cloud, la fecha se separa con @:

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

Por ejemplo: claude-haiku-4-5@20251001

En la Claude API, estos modelos también tienen alias más cortos (por ejemplo, claude-sonnet-4-5) que apuntan a la instantánea con fecha más reciente de esa versión menor.

Los IDs sin fecha son instantáneas fijas

Una idea errónea común es que los IDs de modelo sin fecha, como claude-sonnet-4-6, se comportan como punteros permanentes que dirigen a la versión más reciente o de mejor rendimiento. Ese no es el caso.

Para la generación 4.6 y posteriores, el ID sin fecha es el ID de modelo canónico de ese lanzamiento. Corresponde a una única instantánea fija del modelo. Anthropic no actualiza los pesos ni la configuración de un ID de modelo existente. Cuando hay una versión actualizada disponible, se publica bajo un nuevo ID de modelo.

Esto difiere de los alias sin fecha que existen en la Claude API para modelos anteriores. Un alias como claude-sonnet-4-5 es un puntero de conveniencia que se resuelve en la instantánea con fecha más reciente de esa versión menor. Un ID de la generación 4.6 como claude-sonnet-4-6 no es un alias. Es la instantánea.

Cada ID de modelo, ya sea con fecha o sin fecha, tiene su propio calendario de obsolescencia y retiro.

Pesos del modelo frente a infraestructura de servicio

Los "model weights" (pesos del modelo) son fijos para un ID determinado, pero la "serving infrastructure" (infraestructura de servicio) que rodea al modelo puede cambiar con el tiempo. Esta infraestructura incluye componentes como el enrutador de solicitudes, los clasificadores de seguridad y la lógica de muestreo.

Ocasionalmente, las actualizaciones de infraestructura producen diferencias menores en el comportamiento observable, incluso cuando el ID de modelo y los pesos no han cambiado. Si notas diferencias de comportamiento inesperadas en un ID de modelo que antes era estable, la causa más probable es una actualización de infraestructura.

IDs de modelo actuales

Para ver la lista completa de IDs de modelo actuales y sus equivalentes en Amazon Bedrock y Google Cloud, consulta Descripción general de los modelos.