Novedades de Claude Haiku 5.5
Descripción general de las nuevas capacidades, los cambios incompatibles y los cambios de comportamiento en Claude Haiku 5.5, con un enlace a la guía de cada función y a la guía de migración para los cambios de código.
Claude Haiku 5.5 está diseñado para trabajo de alto volumen y sensible a la latencia, como clasificación, enrutamiento, extracción y tareas de subagentes. Admite “adaptive thinking” (pensamiento adaptativo) con el parámetro effort, una “context window” (ventana de contexto) de 1M tokens y hasta 128k tokens de salida. Usa el mismo tokenizador más reciente que Claude 4.7 y los modelos posteriores, por lo que el mismo texto cuenta como aproximadamente un 30 por ciento más de tokens que en Claude Haiku 4.5. Sus bloques de pensamiento funcionan solo en la cuenta que los produjo, o en una cuenta vinculada a ella.
Para los cambios de código, consulta la guía de migración. Para los ID de modelo, los precios y los límites, consulta la descripción general de Claude Haiku 5.5. Para obtener orientación sobre prompts, consulta Cómo escribir prompts para Claude Haiku 5.5.
Resumen de cambios respecto a Claude Haiku 4.5
Cada fila nombra un cambio, indica si es nuevo, modificado o incompatible, y qué debe hacer tu código.
| Cambio | Tipo | Acción necesaria |
|---|---|---|
| Pensamiento adaptativo y esfuerzo | Nuevo | Opcional: configura effort para equilibrar la calidad de la respuesta frente a la velocidad y el costo. |
| Ventana de contexto y salida más grandes | Nuevo | Ninguna. Los valores existentes de max_tokens siguen siendo válidos, pero los tokens de pensamiento cuentan para ellos. Los prompts largos se facturan a precios más altos; consulta Precios de contexto largo. |
| Herramienta de uso del navegador | Nuevo | Ninguna. |
| Los clasificadores de seguridad pueden rechazar una solicitud | Nuevo | Maneja stop_reason: "refusal" en tu cliente. El fallback del lado del servidor no está disponible. Elimina las instrucciones del prompt que le piden al modelo que escriba su razonamiento. |
| El pensamiento extendido manual devuelve un error | Incompatible | Reemplaza budget_tokens con pensamiento adaptativo. |
| Los parámetros de muestreo pueden devolver un error | Incompatible | Omite temperature, top_p y top_k. |
| El prellenado de mensajes del asistente devuelve un error | Incompatible | Termina messages con un turno del usuario. |
computer_20250124 devuelve un error | Incompatible | Reemplázalo con computer_toolset_20260801. En Amazon Bedrock, computer_20251124 también funciona. |
| Cambiar turnos anteriores invalida los bloques de pensamiento | Incompatible | Mantén las conversaciones en modo solo de anexar si devuelves bloques de pensamiento. |
| Las respuestas pueden comenzar con bloques de pensamiento | Modificado | Selecciona los bloques de contenido por type, no por posición. |
| El texto de pensamiento se omite de forma predeterminada | Modificado | Para recibir el pensamiento resumido, configura thinking.display como "summarized". |
| El mismo texto cuenta como más tokens | Modificado | Vuelve a contar los prompts y revisa max_tokens y las estimaciones de costo. |
| Reproducir bloques de pensamiento entre cuentas | Modificado | Si reproduces conversaciones almacenadas a través de una cuenta diferente, reproduce cada una a través de la cuenta que la generó. |
| Los bloques de pensamiento anteriores permanecen en el contexto | Modificado | Espera más tokens de entrada en conversaciones de múltiples turnos. Para eliminar bloques antiguos, usa borrado de bloques de pensamiento. |
| Se pueden almacenar en caché prompts más cortos | Modificado | Ninguna. La longitud mínima de prompt almacenable en caché es de 512 tokens, frente a 4,096 en Claude Haiku 4.5, por lo que un prompt intermedio que configure cache_control se almacena en caché en Claude Haiku 5.5. |
| No se inyectan etiquetas de conciencia de contexto | Modificado | Para darle al modelo un presupuesto explícito para un bucle agéntico, usa presupuestos de tareas (beta). |
Nuevas capacidades
Pensamiento adaptativo y esfuerzo
Con el pensamiento adaptativo, Claude Haiku 5.5 determina cuándo y cuánto pensar. El pensamiento adaptativo está activado de forma predeterminada. Aunque todavía puedes desactivar el pensamiento con thinking: {"type": "disabled"} con esfuerzo high o inferior, la mejor manera de equilibrar la calidad de la respuesta frente a la velocidad y el costo es usar el parámetro effort.
Ventana de contexto y salida más grandes
Claude Haiku 5.5 tiene una ventana de contexto de 1M de tokens y devuelve hasta 128k tokens de salida, frente a 200k y 64k en Claude Haiku 4.5. Los valores existentes de max_tokens siguen siendo válidos, pero los tokens de pensamiento cuentan para max_tokens, por lo que un límite pequeño puede detenerse después de un bloque thinking y antes de cualquier texto. Consulta Configura el pensamiento. Los prompts largos se facturan a precios más altos; consulta Precios de contexto largo.
Cambios de comportamiento
Las respuestas pueden comenzar con bloques de pensamiento
El pensamiento adaptativo está activado de forma predeterminada, por lo que una respuesta puede comenzar con uno o más bloques thinking incluso cuando la solicitud no menciona el pensamiento. El código que lee el primer bloque de contenido como la respuesta debe seleccionar los bloques por su campo type. Consulta Configurar el pensamiento en la guía de migración.
Los bloques de pensamiento anteriores permanecen en el contexto
Claude Haiku 5.5 mantiene en el contexto los bloques de pensamiento de todos los turnos anteriores del asistente, y estos cuentan como tokens de entrada. Claude Haiku 4.5 mantenía solo los bloques del turno más reciente. Por lo tanto, las conversaciones de varios turnos llevan más tokens de entrada de lo que explica el cambio de tokenizador por sí solo. Para eliminar bloques más antiguos, usa la eliminación de bloques de pensamiento. Consulta Preservación de bloques de pensamiento por modelo.
El mismo texto cuenta como más tokens
Claude Haiku 5.5 usa el mismo tokenizador más reciente que Claude 4.7 y los modelos posteriores. Como ocurre con todos los modelos que usan este tokenizador, el mismo texto de entrada produce aproximadamente un 30 por ciento más de tokens en Claude Haiku 5.5 que en Claude Haiku 4.5. El aumento exacto depende del contenido. La forma de las solicitudes y respuestas no depende del tokenizador, pero cualquier cosa que midas o presupuestes en tokens cambia. Consulta Volver a contar los tokens en la guía de migración.
Reproducir bloques de pensamiento entre cuentas
Los bloques de pensamiento de Claude Haiku 5.5 funcionan solo en la cuenta que los produjo o en una cuenta vinculada a ella. Esto solo importa si almacenas conversaciones y las reproduces a través de una cuenta diferente. Consulta Reproduce los bloques de pensamiento a través de la cuenta que los produjo.
¿Te resultó útil esta página?