IDs de modelos y versionado

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



Formato del ID de modelo

Los IDs de modelos 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 modelos 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 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 API de Claude.



Antes de la generación 4.6

Los modelos anteriores a la generación 4.6 incluyen una fecha de snapshot 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 API de Claude, estos modelos también tienen alias más cortos (por ejemplo, claude-sonnet-4-5) que apuntan al snapshot con fecha más reciente para esa versión menor.



Los IDs sin fecha son snapshots fijados

Una idea errónea común es que los IDs de modelos 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 para ese lanzamiento. Se asigna a un único snapshot de modelo fijo. 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 API de Claude para modelos anteriores. Un alias como claude-sonnet-4-5 es un puntero de conveniencia que se resuelve al snapshot con fecha más reciente para esa versión menor. Un ID de la generación 4.6 como claude-sonnet-4-6 no es un alias. Es el snapshot.

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



Pesos del modelo versus infraestructura de servicio

Los pesos del modelo son fijos para un ID determinado, pero la infraestructura de servicio alrededor del 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 del modelo y los pesos no han cambiado. Si notas diferencias de comportamiento inesperadas en un ID de modelo previamente estable, una actualización de infraestructura es la causa más probable.



IDs de modelos actuales

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