Saltar al contenido
ConsultoriaNet
IA y automatización

La API de Claude cambia: qué revisar

Anthropic lanzó una versión nueva de la API de Claude y de sus librerías. Qué deja de funcionar y qué pedirle a tu equipo técnico antes de actualizar.

Por · 30 de octubre de 2026 · 8 min de lectura
Iconos de línea verde menta sobre fondo azul: dos piezas de engranaje que encajan, una etiqueta de versión y una lista de verificación con un pequeño punto ámbar
En esta página

Si tu negocio usa Claude, la IA de Anthropic, dentro de un chatbot o de una automatización (para clasificar consultas, resumir correos o preparar borradores), esa conexión funciona a través de la API: el canal por el que un programa le envía un texto a Claude y recibe la respuesta. Y casi siempre hay en medio una librería de programación, lo que en la jerga se llama SDK, que facilita ese envío.

El 21 de octubre de 2026, Anthropic publicó una versión nueva de la API y versiones nuevas de sus librerías que la usan por defecto. Tu automatización no se rompe sola por eso. Se puede romper el día en que alguien actualice la librería sin revisar antes. Te contamos qué cambió, qué deja de funcionar y qué conviene pedirle a quien mantiene la integración.

En 30 segundos
  • Anthropic lanzó la versión 2026-10-21 de la API y librerías nuevas (por ejemplo, Python 2.0.0) que la usan por defecto. Las librerías anteriores siguen enviando la versión de 2023.
  • Con la versión nueva, algunas solicitudes que antes funcionaban devuelven un error: por ejemplo, las que fijan la «temperatura» de la respuesta. La automatización se detiene en ese paso.
  • Antes de actualizar, pide un inventario de dónde se usa Claude, una prueba con casos reales y un plan para volver atrás. Anthropic no ha anunciado una fecha de retiro de la versión anterior.

Qué anunció Anthropic

Las notas de versión oficiales de Claude, consultadas el 30 de octubre de 2026, dicen en la entrada del 21 de octubre que Anthropic publicó la versión 2026-10-21 de la API y versiones nuevas de sus librerías que la envían por defecto. La guía oficial de migración explica qué cambia y en qué orden actualizar.

Conviene separar tres cosas que suelen mezclarse:

  • La aplicación de chat de Claude, la que usas en el navegador o el teléfono. Este cambio no la afecta.
  • La API, el canal entre tus sistemas y Claude. Es lo que cambia de versión.
  • Las librerías (SDK), el código que tu equipo usa para hablar con la API. Las versiones nuevas son las que pasan a usar la API nueva.

Estas son las primeras versiones de cada librería que usan la API nueva, según las notas oficiales:

Librerías que envían la versión 2026-10-21 por defecto
Lenguaje o herramientaPrimera versión con la API nueva
Python2.0.0
TypeScript1.0.0
C#13.0.0
Go2.0.0
Java3.0.0
PHP1.0.0
Ruby2.0.0
CLI «ant» (herramienta de línea de comandos)2.0.0

Según la guía, cada librería usa la versión de la API que estaba vigente cuando salió su versión principal. Por eso, mientras tu integración siga con una librería anterior, sigue enviando la versión 2023-06-01. Si la integración no usa librería y llama a la API directamente, la versión se elige con un dato que viaja en cada solicitud (la cabecera anthropic-version).

Qué deja de funcionar

Con la versión nueva, algunas solicitudes que antes se aceptaban devuelven un error 400: la API las rechaza y no responde. En una automatización, eso significa que el paso que llama a Claude falla y lo que venía después no ocurre.

Cambio 1
La «temperatura» ya no se acepta. Es un ajuste que controla cuánto varía la respuesta de una vez a otra. Si la solicitud envía temperature, top_p o top_k, falla, aunque el valor sea el de por defecto.
Cambio 2
Documentos en el lugar equivocado. Un documento colocado directamente en un mensaje de Claude (y no del usuario) provoca un error. También las citas dentro de textos que envía el usuario.
Cambio 3
La clave viaja en otra cabecera. Las librerías nuevas envían la clave de acceso de otra forma. La API acepta las dos, pero un intermediario (un proxy o una pasarela) que solo mira la antigua puede bloquear las solicitudes.

El primero es el que más se va a notar. La guía aclara que, sin esos parámetros, la respuesta usa los valores por defecto. En los modelos más nuevos (Claude 4.7 y posteriores) no cambia nada, porque ya trabajaban así. Pero en modelos anteriores, como Claude Sonnet 4.6, si tu integración bajaba la temperatura para que las respuestas fueran más parecidas entre sí, ese efecto se pierde y no hay otro ajuste que lo reemplace. La guía da dos salidas: dejar de enviar el parámetro o mantener esa solicitud en la versión anterior.

Hay más cambios que afectan sobre todo al código: nombres de campos en los informes de uso y administración, la forma de construir los mensajes en algunas librerías y que cada cliente admite una sola credencial. También cambia la licencia de las librerías (de MIT a Apache 2.0), algo que solo importa si tu empresa lleva registro de las licencias del software que usa. Todo eso está en la guía y es trabajo para tu equipo técnico.

No todo se actualiza solo

Que la librería tenga versión nueva no quiere decir que tu automatización la use mañana. Depende de cómo esté hecha:

  • Código propio. Cambia cuando alguien actualiza las dependencias. Ahí está el riesgo: una actualización rutinaria puede arrastrar la librería nueva sin que nadie revise los parámetros.
  • Herramientas como n8n o Make. Usan su propia integración con Claude. Si cambian o no depende de cada herramienta y de su versión. Lo que corresponde es revisar sus notas de versión, no suponer que ya se actualizó ni que nunca lo hará.
  • Claude a través de Amazon Bedrock. La guía dice que ahí la versión nueva solo está disponible para Claude 4.7 y posteriores. Si usas un modelo anterior en Bedrock, la indicación es quedarte con la librería actual, o pasar primero a un modelo más nuevo.

Un detalle que da algo de margen: las notas y la guía no anuncian una fecha de retiro de la versión 2023-06-01, ni dicen que haya que migrar de inmediato. Es una buena razón para hacerlo con calma, no para dejarlo indefinidamente.

Un ejemplo de cómo se rompe

Este ejemplo es ilustrativo, no un caso real. Una empresa usa una automatización que lee cada consulta del formulario de su web, le pide a Claude que la clasifique (presupuesto, soporte, otra cosa) y la manda al equipo que corresponde. Para que la clasificación fuera estable, quien la montó fijó la temperatura en cero.

Meses después, alguien actualiza las dependencias del servidor por un tema de seguridad. Entra la librería nueva, que usa la API nueva. Desde ese momento, cada consulta provoca un error 400 en el paso de clasificación. Si nadie recibe un aviso cuando falla la automatización, las consultas se acumulan sin repartir y el equipo se entera cuando un cliente llama para preguntar por qué no le respondieron.

Nada de eso pasa si la actualización se prueba antes con consultas reales, y si hay una alerta que avisa cuando un paso empieza a fallar.

Qué pedirle a tu equipo técnico

No necesitas saber programar para pedir lo correcto. Estos son los pasos, en orden:

Plan de revisión antes de actualizar
PasoQué pedirPara qué
1. InventarioUna lista de cada lugar donde se usa Claude: qué proceso, qué librería y versión, y qué versión de la API envíaSaber qué puede verse afectado antes de tocar nada
2. ParámetrosBuscar en el código y en las automatizaciones si se envía temperatura, documentos o citas como describe la guíaDetectar las solicitudes que van a fallar
3. IntermediariosComprobar si algún proxy, pasarela o filtro lee la clave en la cabecera antiguaEvitar que se bloqueen solicitudes que la API sí aceptaría
4. PruebaProbar la versión nueva con solicitudes reales, quitando antes los datos personales, y comparar las respuestasVer si fallan y si la calidad se mantiene, sobre todo sin temperatura
5. PublicaciónSubir la librería nueva junto con las correcciones, no por separadoQue no haya un período en que la integración falle
6. Vuelta atrásDejar fijada la versión anterior de la librería y saber cómo volver a ellaSi algo falla en producción, recuperar el servicio en minutos

Si todavía no tienes una alerta para cuando falla una automatización, este es buen momento para pedirla. Sirve para este cambio y para el próximo. Ya pasó algo parecido con los nodos obsoletos de n8n: los cambios de los proveedores llegan con aviso, pero alguien tiene que leerlo.

Lo que no conviene hacer

Actualizar directamente en producción. Es la forma más rápida de descubrir el problema a través de un cliente.

Fijar la librería vieja para siempre. Quedarse en la versión anterior es razonable mientras preparas la prueba, pero la guía no dice hasta cuándo se mantendrá. Anota la decisión y revísala.

Dar por hecho que la respuesta será igual. En los modelos anteriores a Claude 4.7, quitar la temperatura puede hacer que las respuestas varíen más. Si la automatización toma decisiones (clasificar, aprobar, filtrar), revisa una muestra de resultados después del cambio.

Si estás pensando en sumar IA a más procesos, en automatizar procesos con IA explicamos qué conviene dejarle y qué no. Y si usas también Gemini, revisa qué cambió en cómo guarda tus solicitudes.

Auditoría gratuita

¿Quieres que lo revisemos en tu sitio?

Auditoría inicial gratuita, con respuesta en 24 horas laborables.

Respuesta en 24 hSin compromisoEspañol e inglés

También puedes escribir a hola@consultorianet.com.

Si todavía no tienes web, déjalo vacío y cuéntanos el proyecto.
Objetivo, plazo y lo que ya hayas probado. Cuanto más concreto, más útil será la respuesta.

También puedes escribir a hola@consultorianet.com.