Anthropic ha publicado una nueva versión de la API de Claude con el número 2026-10-21. Desde 2023, los desarrolladores escriben anthropic-version: 2023-06-01 en la cabecera de sus solicitudes; esta es la primera versión oficial nueva desde entonces.
El cambio más llamativo: los tres parámetros de muestreo temperature, top_p y top_k se eliminan de la Messages API. Según la documentación de migración, al enviar solicitudes con la nueva versión, si incluyen cualquiera de estos campos, aunque el valor sea el predeterminado, la API devuelve directamente un error 400. Si no se envían, la solicitud usa el muestreo por defecto, con temperature en 1.0, igual que ocurría en la versión anterior al no pasar parámetros.
La versión antigua no queda obsoleta. El consejo de la documentación es directo: la solicitud que dependa de valores de muestreo no predeterminados debe quitar los parámetros o seguir en 2023-06-01.
A quién afecta
Para los modelos de Claude 4.7 en adelante, retirar los parámetros apenas cambia nada en la práctica, porque, según la documentación, esos modelos ya solo aceptaban los valores por defecto. Los afectados son las aplicaciones que aún usan modelos más antiguos como Claude Sonnet 4.6 y que bajan la temperatura a propósito para obtener salidas más estables. La documentación lo deja claro: esas solicitudes pierden su efecto original tras la actualización, y ningún otro ajuste puede sustituirlo.
Además de los parámetros de muestreo, la Messages API tiene otros dos cambios que provocan un error 400:
- Colocar un bloque
documentdirectamente en un mensaje de assistant ahora da error; el documento debe ir en el mensaje de user; - Incluir
citationsno vacío en un bloque de texto de un mensaje de user también da error.
En el lado de administración también hay cambios de nombre. En la Admin API, el campo roles de los grupos RBAC pasa a ser role_ids, se elimina workspace_id de las claves de API y se lee scope en su lugar, y en la interfaz de analítica empresarial actor.email se convierte en actor.email_address. Con la nueva versión, los nombres antiguos de los campos ya no se devuelven.
Los SDK saltan juntos de versión mayor
Los SDK oficiales de todos los lenguajes han subido su versión mayor, y las nuevas versiones envían por defecto 2026-10-21: el paquete de Python anthropic pasa a 2.0.0, @anthropic-ai/sdk de TypeScript a 1.0.0, Go a v2 (la ruta de importación debe llevar /v2), Java a 3.0.0, C# a 13.0.0, PHP a 1.0.0 y Ruby a 2.0.0. La herramienta de línea de comandos ant sube a 2.0.0.
Los usuarios de Go deben tener un cuidado extra. La ruta del módulo de la CLI pasa a ser github.com/anthropics/anthropic-cli/v2; la documentación advierte de que, con la ruta antigua, go install seguirá instalando la última v1, sin error y sin ningún aviso.
En Amazon Bedrock, la nueva versión solo está disponible para los modelos de Claude 4.7 en adelante. Quien siga llamando a Opus 4.6 u otros modelos antiguos en Bedrock debe quedarse en la versión actual del SDK o cambiar primero de modelo y luego actualizar.
La clave cambia de cabecera
El cambio con mayor alcance para los desarrolladores en China quizá esté escondido en las modificaciones de los SDK. El nuevo SDK y la CLI dejan de poner la clave de API en la cabecera X-Api-Key y pasan a usar de forma unificada Authorization: Bearer <key>.
La propia API de Claude acepta ambas cabeceras, así que los programas que se conectan directamente a la interfaz oficial no se ven afectados. El problema está en las capas intermedias: los proxies inversos propios, las pasarelas de API y el middleware de conteo de cuota que leen la clave de X-Api-Key para autenticar o facturar dejarán de encontrarla en cuanto se actualice el SDK. La documentación ofrece dos caminos: modificar la pasarela para que lea Authorization, o volver a poner la clave manualmente en X-Api-Key desde el cliente.
Otro cambio derivado es que un cliente solo puede tener un tipo de credencial. Antes, pasar a la vez api_key y auth_token en Python enviaba ambas cabeceras; ahora se lanza directamente un ValueError.
Sobre un número de versión con más de dos años
El número 2023-06-01 abarcó toda la evolución de Claude, desde la era de Claude 2 hasta la serie Claude 5. Las capacidades añadidas por el camino, como la llamada a herramientas, el almacenamiento en caché de prompts y el pensamiento extendido, se fueron superponiendo en su mayoría mediante cabeceras beta y campos nuevos, sin que el número de versión se moviera.
La retirada de los parámetros de muestreo, en realidad, venía anunciándose. Desde Claude 4.7, los modelos solo aceptan los valores por defecto, y ajustar la temperatura en los modelos nuevos ya no tenía efecto. Ahora esa regla se escribe en el contrato de la interfaz, de modo que la solicitud falla en la entrada y quien llama no piense que el parámetro sigue funcionando.
En cuanto a cuánto tiempo se mantendrá la versión antigua, la documentación de migración no da un calendario, y Anthropic tampoco ha anunciado por ahora una fecha de retirada de 2023-06-01.
Fuentes: documentación de migración de la plataforma Claude, cuenta oficial de desarrolladores de Claude, CocoLoop; los números de versión de los SDK por lenguaje, las condiciones de error y el alcance de modelos en Bedrock se rigen por la documentación oficial de migración.