Si tu empresa tiene un chatbot, un lector de facturas o cualquier automatización que llama a la API de Claude, hay un cambio que no se nota hasta que truena. El 21 de octubre de 2026, Anthropic publicó la versión 2026-10-21 de su API, la primera desde 2023, y junto con ella nuevas versiones mayores de todos sus SDK. La más visible de sus rupturas: los parámetros temperature, top_p y top_k dejan de existir. Una petición que los mande recibe un error 400, en cualquier modelo y aunque lleven el valor por defecto.
No se rompe nada de golpe, pero basta con que alguien actualice dependencias para que una integración deje de responder. Y noviembre trae además dos apagados con fecha: Claude Sonnet 4.5 y el modo rápido de Opus 4.8, ambos el 30 de noviembre.
Cómo se elige la versión
La API recibe un encabezado anthropic-version en cada petición. Hasta ahora casi todo el mundo mandaba 2023-06-01. Según la guía de migración de Anthropic, si usas un SDK, tus peticiones van con la versión que estaba vigente cuando salió la versión mayor de tu SDK. Estas son las primeras que mandan 2026-10-21:
| Lenguaje / herramienta | Primera versión con 2026-10-21 |
|---|---|
Python (anthropic) | 2.0.0 |
TypeScript (@anthropic-ai/sdk) | 1.0.0 |
C# (Anthropic) | 13.0.0 |
Go (anthropic-sdk-go/v2) | 2.0.0 |
Java (anthropic-java) | 3.0.0 |
PHP (anthropic-ai/sdk) | 1.0.0 |
Ruby (anthropic) | 2.0.0 |
CLI ant | 2.0.0 |
Dos detalles prácticos: en PHP, composer update no salta solo a la versión 1.0.0 (hay que pedirla con composer require), y en Go el módulo cambia de ruta a /v2. Las versiones nuevas también pasan de licencia MIT a Apache 2.0.
Lo que da error en 2026-10-21
| Cambio | Qué pasa | Qué hacer |
|---|---|---|
temperature, top_p, top_k | Error 400 en cualquier modelo | Quitarlos de las peticiones y de los lotes (Message Batches) |
Bloque document en un mensaje del asistente | Error 400 | Mandar los documentos en mensajes del usuario |
Bloque de texto con citations en un mensaje del usuario | Error 400 | Quitar las citas de esos bloques |
Admin API: roles, group_id, name, group_type, workspace_id | Ya no vienen en la respuesta | Leer role_ids, rbac_group_id, display_name, group.type y scope.workspace_id |
Enterprise Analytics API: actor.email, summaries | Ya no vienen | Leer actor.email_address y data |
El caso de temperature, explicado sin código
temperature controla qué tan "creativa" o qué tan predecible es la respuesta. Muchas integraciones de negocio la bajaban a 0 o cerca para que, por ejemplo, un extractor de datos de facturas devolviera siempre lo mismo. Anthropic explica que, sin el parámetro, la petición usa los valores por defecto, con temperature de 1.0.
- En Claude 4.7 y modelos posteriores no cambia nada: ya solo aceptaban los valores por defecto. De hecho, con la versión anterior de la API ya daban error si les mandabas un valor distinto.
- En modelos que todavía aceptan otros valores, como Claude Sonnet 4.6, quitar el parámetro hace que pierdas ese efecto, y Anthropic dice que ningún otro ajuste lo reemplaza. Tienes dos opciones: dejar esa petición en
2023-06-01o guiar el comportamiento con instrucciones claras en el prompt y validar la salida (por ejemplo, con un formato JSON fijo).
Authorization: Bearer en lugar de X-Api-Key. La API de Claude acepta las dos, pero si tienes un proxy, un gateway, un filtro de logs o pruebas automáticas que leen X-Api-Key, hay que ajustarlos.Bedrock y Google Cloud, aparte
Si consumes Claude a través de Amazon Bedrock, la versión 2026-10-21 solo está disponible para Claude 4.7 y modelos posteriores. Si tu integración en Bedrock usa un modelo anterior (Opus 4.6 o más viejo), Anthropic recomienda quedarte en tu versión actual del SDK hasta cambiar de modelo. Recuerda además que en Bedrock y en Vertex AI las fechas de retiro de modelos son otras.
Fechas que vienen en la API de Anthropic
| Modelo o función | Estado al 4 de noviembre de 2026 | Fecha | Reemplazo recomendado |
|---|---|---|---|
Claude Sonnet 4.5 (claude-sonnet-4-5-20250929) | En retiro | 30 de noviembre de 2026 | claude-sonnet-5-5 |
| Modo rápido de Claude Opus 4.8 | En retiro (avisado el 30 de octubre) | 30 de noviembre de 2026 | Claude Opus 5.5 |
Claude Opus 4.5 (claude-opus-4-5-20251101) | Activo | Retiro "no antes del 24 de noviembre de 2026" | Sin aviso aún |
Claude Haiku 4.5 (claude-haiku-4-5-20251001) | Activo | "No antes del 15 de octubre de 2026" (fecha ya pasada) | Sin aviso aún |
Sobre Opus 4.5 y Haiku 4.5, un matiz: "no antes de" no es una fecha de apagado. Anthropic se compromete a avisar al menos 60 días antes de retirar un modelo público, y al 4 de noviembre ninguno de los dos tenía aviso. Del retiro de Sonnet 4.5 ya contamos el calendario completo, y si buscas un reemplazo económico, revisa precios de Claude Haiku 5.5 y la baja de precio de Opus 5.5.
Qué hacer este mes
- Haz inventario. Busca en tu código, y pregunta a tus proveedores, qué sistemas llaman a la API de Claude, con qué SDK y en qué versión, y qué modelo usan.
- Congela la versión mayor del SDK en tus archivos de dependencias hasta que hagas la migración, para que una actualización automática no te sorprenda.
- Busca
temperature,top_pytop_ken el código y decide caso por caso: quitarlos o dejar esa llamada en2023-06-01. - Prueba contra 2026-10-21 en un ambiente de pruebas antes de liberar, con documentos y casos reales de tu operación.
- Saca a Sonnet 4.5 de producción antes del 30 de noviembre. El reporte de uso de la consola de Claude se exporta a CSV con el consumo por llave y por modelo.
Contexto
Una integración con IA ya no se instala y se olvida: necesita un responsable, un inventario y una revisión mensual, igual que los parches de seguridad. Esta nota se basa en la documentación oficial de Anthropic revisada el 4 de noviembre de 2026: la página de versiones de la API, la guía "Migrating to API version 2026-10-21", la página de retiro de modelos (model deprecations) y las notas de versión de la plataforma.
Inteligencia artificial
Migra tu integración con Claude sin sustos
Hacemos el inventario de tus llamadas a la API, ajustamos el código a la versión 2026-10-21 y sacamos de producción los modelos que se retiran en noviembre.
