Una versión de API fija el contrato del servidor; el SDK decide qué contrato y autenticación utiliza el cliente.
Claude API estrena versión y obliga a revisar SDK, parámetros y pasarelas
La versión 2026-10-21 llega con nuevas generaciones de los SDK y cambios incompatibles: elimina parámetros de muestreo, endurece el formato de mensajes y modifica campos administrativos.
Contexto esencialCómo se relacionan una versión de API, el SDK que la selecciona y el código que debe adaptarse antes de actualizar.Minimizar
La API y el SDK evolucionan por separado
La versión de API define el contrato que acepta el servidor: campos, respuestas y errores. El SDK es una biblioteca cliente que construye esas peticiones. En esta actualización, las nuevas versiones principales de los SDK eligen 2026-10-21 por defecto; por eso una actualización de dependencia puede activar simultáneamente el nuevo contrato y cambios propios de la biblioteca.
Un cambio incompatible debe localizarse por uso
No todas las aplicaciones envían parámetros de muestreo, documentos desde el rol assistant o citas desde el rol user. Tampoco todas consumen los campos administrativos renombrados. La revisión útil consiste en buscar cada patrón afectado en el código y en las pruebas, en vez de modificar solicitudes que no dependen de él.
Cabeceras y pasarelas forman parte de la integración
Una llamada directa puede seguir autenticándose con X-Api-Key, pero los SDK nuevos usan Authorization Bearer. Un proxy, una puerta de enlace o una regla de observabilidad que solo reconoce la cabecera antigua podría bloquear o dejar de registrar las solicitudes. La migración debe incluir esos componentes intermedios, no solo el cliente.
Ejemplo razonado de migración gradual
Un servicio con dos rutas puede actualizar primero la que usa parámetros predeterminados. Fija un entorno de prueba a 2026-10-21, elimina campos rechazados y comprueba respuestas, métricas y pasarela. La ruta que depende de temperature reducido puede permanecer temporalmente en 2023-06-01 porque la nueva versión no ofrece sustituto. Después se decide si rediseñarla o mantenerla separada.
Anthropic ha publicado la versión 2026-10-21 de Claude API y nuevas versiones principales de sus SDK: Python 2.0, TypeScript 1.0, C# 13, Go 2, Java 3, PHP 1, Ruby 2 y ant CLI 2. Estas versiones envían la nueva cabecera de API por defecto y cambian su licencia de MIT a Apache 2.0.
La migración contiene incompatibilidades deliberadas. Los parámetros temperature, top_p y top_k dejan de aceptarse y producen un error 400; tampoco se admiten bloques document directamente en mensajes assistant ni citas no vacías dentro de mensajes user. Los equipos que dependan de valores de muestreo no predeterminados pueden mantener esas llamadas en la versión 2023-06-01.
También cambian nombres y estructuras de respuesta en Admin API y Enterprise Analytics. Por ejemplo, las claves dejan workspace_id en favor de scope, que distingue una clave limitada a un espacio de trabajo de otra válida para toda la organización. Los tipos de mensajes de los SDK se separan por rol.
Los SDK nuevos envían la clave mediante Authorization Bearer. La API directa admite ese encabezado y X-Api-Key, pero una pasarela o proxy que solo reenvíe el formato anterior puede romperse. Anthropic recomienda actualizar el código afectado, probar contra la nueva versión y publicar el cambio junto con las correcciones.
A tener en cuenta
Amazon Bedrock solo ofrece 2026-10-21 con Claude 4.7 o posterior; no existe sustituto para los valores no predeterminados de muestreo.