Recuperamos un cambio del 21 de octubre de 2026, con impacto para aplicaciones que integran Claude: Anthropic publicó la versión de API 2026-10-21 y nuevas versiones principales de sus SDK, las bibliotecas con las que se llama al servicio. Se informa hoy, 23 de octubre; no es un lanzamiento de esta mañana.

Las notas oficiales de la plataforma indican que Python 2.0.0, TypeScript 1.0.0 y la herramienta de terminal ant 2.0.0 envían esa versión de API por defecto. Las nuevas bibliotecas y la herramienta pasan de MIT a Apache 2.0. Actualizar una dependencia merece revisar el contrato que termina enviándose al servidor.

El cambio que puede romper una petición válida

La guía de migración explica que temperature, top_p y top_k producen un error 400 en la nueva versión, incluso con sus valores predeterminados. Hay que retirarlos. La petición usa entonces los valores por defecto, incluida temperatura 1.0; si dependía de otra temperatura, no hay un ajuste equivalente y puede conservarse esa petición en 2023-06-01.

También se rechazan documentos directamente en mensajes del asistente y listas no vacías de citas en mensajes del usuario. Los documentos deben ir en mensajes del usuario; las citas de respuestas anteriores del asistente siguen admitidas. No hay que borrar indiscriminadamente el historial.

En Python, MessageParam pasa a ser una unión de tipos y deja de poder usarse como constructor; los diccionarios literales siguen siendo válidos. En Amazon Bedrock, la nueva versión requiere modelos Claude 4.7 o posteriores: los anteriores deben conservar su SDK o versión de API actuales, o cambiar antes de modelo.

Ejemplo: una actualización rutinaria del bot documental

Ejemplo hipotético, no ejecutado por Puntoes: un equipo mantiene un asistente que responde sobre documentos internos y envía temperatura cero. Al actualizar la biblioteca, convendría observar la versión real de la API en una petición de prueba. Un fallo 400 puede aparecer por el cambio de contrato, antes de que tenga sentido comparar la calidad de la respuesta.

Nuestra propuesta de trabajo sería conservar un conjunto pequeño de preguntas y documentos autorizados, registrar la versión anterior y ensayar el cambio en un entorno de pruebas. Después revisaríamos errores, citas y respuestas útiles; si el comportamiento no cumple los criterios del equipo, volveríamos a la configuración anterior. Temperatura cero tampoco demuestra exactitud factual.

Delimitar la migración

Esta noticia delimita Messages y Python. Para administración, analítica u otras bibliotecas, hay que revisar sus apartados específicos en la guía. Cambiar solo la cabecera no resuelve los cambios de tipos del SDK.

El antecedente sobre perfiles de clientes y webhooks de Claude trata otra función: tenerla integrada no acredita haber comprobado esta migración. No hemos ejecutado llamadas ni medido regresiones de la nueva API.

Fuentes

Sigue explorando