Qué cambia en 2026-10-21
La publicación de ClaudeDevs del 21 de octubre de 2026 enumera tres roturas: temperature, top_p y top_k salen de la API Messages; los documentos en turnos de assistant y las citations en turnos de usuario devuelven un 400; y se sustituyen algunos campos en desuso de Admin y de Enterprise Analytics. La guía de migración aplica las reglas de Messages a POST /v1/messages, al recuento de tokens y a cada petición de un Message Batch creado con 2026-10-21.
Enviar temperature, top_p o top_k devuelve un 400, incluso en el valor predeterminado del parámetro. Sin ellos, una petición muestrea con los valores predeterminados, incluido temperature 1.0, igual que una petición de 2023-06-01 que los omite. Claude 4.7 y posteriores ya aceptan solo esos valores predeterminados y muestrean como antes. En los modelos que aceptan otros valores, el ejemplo de la guía es Claude Sonnet 4.6: un temperature más bajo pierde ese efecto, ningún otro ajuste lo sustituye y esa petición puede quedarse en 2023-06-01.
Un bloque de documento colocado directamente en un mensaje de assistant devuelve un 400. Envía los documentos en mensajes de usuario. Un documento anidado dentro de otro bloque, como el resultado de una herramienta web-fetch que devolvió Claude, se sigue aceptando. Un bloque de texto de un mensaje de usuario con un array citations no vacío devuelve un 400, incluidas las citations dentro de bloques search_result. Las citations en el texto de un mensaje de assistant, como respuestas anteriores que se reenvían, se siguen aceptando, y también "citations": {"enabled": true} en documentos y resultados de búsqueda.
Las respuestas de la Admin API y de la Claude Enterprise Analytics API ya no incluyen los nombres antiguos de la tabla. En las claves de API, workspace_id desaparece y quien llama lee scope. Una clave vinculada a un espacio de trabajo, incluida una clave vinculada al Default Workspace, pone el ID real de ese espacio en scope.workspace_id. Una clave para todos los espacios de trabajo tiene scope {"type": "organization"} y no tiene workspace_id. La guía dice que, en 2023-06-01, workspace_id era null tanto para el Default Workspace como para una clave de todos los espacios. El código que trataba null como Default debe comparar scope.workspace_id con el espacio de trabajo llamado Default, obtenido con List Workspaces e include_default=true. El parámetro de consulta group_type en los endpoints de lista de límites de tasa y el filtro workspace_id en el endpoint de lista de claves de API no cambian.
| Endpoints | Nombre antiguo | Nombre nuevo |
|---|---|---|
| Grupos RBAC: crear, listar, obtener y actualizar | roles | role_ids |
| Miembros de grupos RBAC: listar, añadir y la respuesta al quitar un miembro | group_id | rbac_group_id |
| Roles RBAC: listar y obtener | name | display_name |
| Límites de tasa de la organización y del espacio de trabajo: listar, y la respuesta al fijar los límites de un espacio de trabajo | group_type | group.type |
| Claves de API: listar, obtener y actualizar | workspace_id | scope (valores distintos) |
| Informes de uso y coste por usuario | actor.email | actor.email_address |
| Resúmenes de actividad | summaries | data |
Quién tiene que cambiar un cliente
ClaudeDevs dice que las nuevas versiones major de los SDK de Anthropic y de la CLI ant salieron el día de la publicación, el 21 de octubre de 2026, y que usan 2026-10-21 de forma predeterminada. La guía de migración no fecha esa publicación de clientes. Dice que un SDK envía la versión de API que estaba vigente cuando se publicó su major, y que las versiones mostradas para cada lenguaje son las primeras que envían 2026-10-21, incluidos sus clientes de Amazon Bedrock y de Google Cloud. Las versiones anteriores del SDK y de la CLI enviaban anthropic-version 2023-06-01. La actualización de Python que nombra la guía es anthropic 2.0.0. Para los demás lenguajes, la guía señala la versión que aparece en la pestaña de ese lenguaje.
En Amazon Bedrock, 2026-10-21 solo está disponible para Claude 4.7 y posteriores. Las llamadas a modelos de Bedrock más antiguos, listados en Claude on Amazon Bedrock como Opus 4.6 y anteriores, se quedan en la versión del SDK que usas hoy, o en la cabecera de versión que envías hoy, hasta que esas llamadas usen un modelo Claude 4.7 o posterior. La misma guía dice que los clientes de Google Cloud de esas versiones del SDK envían 2026-10-21.
El SDK y la CLI envían la clave de API como Authorization: Bearer en lugar de X-Api-Key. La API de Claude acepta una clave en cualquiera de las dos cabeceras, así que un programa que habla directamente con la API no necesita cambios por este intercambio. Un proxy o una pasarela que lee o fija X-Api-Key debe usar Authorization, o quien llama puede seguir enviando X-Api-Key. La guía dice que AnthropicFoundry sigue enviando su clave como x-api-key.
Una clave de API y un token de autenticación comparten ahora una cabecera, así que un cliente del SDK guarda una sola credencial. En Python, dos o más en el constructor, o en una sola llamada a copy() o with_options(), lanzan ValueError. Pasar None no cuenta como credencial. Para enviar un token de pasarela y una clave de API, pasa el token como auth_token, pon X-Api-Key en default_headers y haz que la pasarela quite su cabecera Authorization antes de reenviar, porque la API de Claude espera una credencial en cada petición. En los SDK de Python, TypeScript, Go, PHP y Ruby, un extra_headers que omite X-Api-Key ya no deja la clave fuera de la petición. El reemplazo de Python que da la guía es extra_headers={"Authorization": omit}.
La CLI ant quita --api-key y --auth-token, porque el valor de una opción queda visible en el historial del shell y en los listados de procesos. Ambas opciones imprimen un aviso de desuso desde v1.27.0. Un comando que todavía pasa cualquiera de las dos se detiene con "flag provided but not defined." Para una clave, usa ANTHROPIC_API_KEY, --api-key-stdin o ant auth login. Para un token, usa ANTHROPIC_AUTH_TOKEN o --auth-token-stdin.
- Text Completions desaparece de los SDK de TypeScript, Go, Java y Ruby y de la CLI, incluido ant completions create. La guía dice que se use la API Messages.
- Los ejecutores de herramientas de TypeScript y Ruby dejan la compactación en el cliente a favor de la compactación en el servidor. El disparador de tokens de entrada debe ser de al menos 50,000. La llamada manual es compactBeforeNextTurn().
- Los métodos Models que no son beta ya no aceptan betas, y los comandos ant models ya no aceptan --beta. Las cabeceras beta pasan por client.beta.models o ant beta:models, que devuelven BetaModelInfo.
- MessageParam es ahora una unión de UserMessageParam, AssistantMessageParam y SystemMessageParam. BetaMessageParam se divide del mismo modo. El JSON que envía el SDK conserva los mismos campos y valores. En Python, un literal de dict como {"role": "user", "content": "Hello"} no necesita cambios. Llamar a MessageParam() o a BetaMessageParam(), o crear una subclase de cualquiera de esos nombres, lanza TypeError. Hay que crear la subclase del tipo del rol, como UserMessageParam.
- En los SDK de C#, Go, Java, PHP y Ruby, un campo obligatorio que solo puede contener un valor es ahora una constante, y desaparece su tipo enum de un solo miembro. El JSON que el SDK envía y lee sigue igual. En la CLI, --type es opcional en ant beta:sessions:resources add, file es el único valor y un comando que todavía pasa --type file sigue funcionando.
Cómo cambiar
Quien llama sin un SDK pone la cabecera anthropic-version en 2026-10-21. Quien usa un SDK actualiza a las versiones que la guía muestra para su lenguaje. El paso que la guía nombra para Python es anthropic 2.0.0. El orden de la guía es cambiar la versión, actualizar el código para cada cambio incompatible que aplique y para lo que exija el SDK o la CLI nuevos, y probar la integración contra 2026-10-21 antes de publicar. Publica la actualización de versión junto con esas correcciones.
ClaudeDevs remite a la habilidad /claude-api de Claude Code o a la guía de migración. Claude Code 2.1.307, con fecha del 21 de octubre de 2026, añade /claude-api api-version para llevar el código de la API de Claude a la versión de API 2026-10-21.
Estas versiones del SDK y de la CLI tienen la Apache License 2.0. Las versiones anteriores siguen en MIT. La guía dice que el cambio de licencia no exige cambios de código; actualiza la entrada de licencia de la dependencia si llevas una. Las publicaciones 1.0.0 son el cambio de licencia de los paquetes de plataforma de TypeScript y de los demás paquetes de C#. El cambio de Java cubre cada artefacto com.anthropic. El anclaje de versión de API de Python en la guía sigue siendo anthropic 2.0.0.
Qué sigue abierto
La publicación de ClaudeDevs y la guía de migración no dan precio, cambio de cuota ni fecha de cierre para 2023-06-01 ni para 2026-10-21. ClaudeDevs dice que 2023-06-01 no está en desuso. La instrucción relacionada de la guía es dejar una petición en 2023-06-01 cuando necesita un valor de muestreo distinto del predeterminado. El plan de ClaudeDevs de publicar versiones con más frecuencia no nombra calendario, id de la próxima versión ni un modelo que vaya a exigir una versión posterior.
Fuente
También de
Fuentes y criterio editorial
Este resumen se apoya en la publicación de ClaudeDevs del 21 de octubre de 2026, en la guía de migración de Anthropic para la versión de API 2026-10-21 y en la entrada del registro de cambios de Claude Code para 2.1.307, fechada el 21 de octubre de 2026. La guía y el registro se consultaron el 22 de octubre de 2026. La disponibilidad, la descripción de primera versión oficial desde 2023, el plan de publicar versiones con más frecuencia, la frase de que 2023-06-01 no está en desuso y la publicación el mismo día del SDK y de la CLI ant son afirmaciones de ClaudeDevs. El comportamiento de las peticiones y de los clientes es lo que dice la guía de migración. No se cubrieron precios, cuotas, ninguna fecha de cierre, llamadas reales a la API ni la lista aparte de modelos de Bedrock. La guía nombra anthropic 2.0.0 para Python y, para los demás lenguajes, señala las versiones que aparecen en cada uno.