Cambiar claude-haiku-4-5 por claude-haiku-5-5 es la parte más pequeña de esta migración. Cinco patrones de solicitud que funcionaban con Haiku 4.5 ahora devuelven un error 400, y varios cambios más no fallan ninguna solicitud, pero alteran lo que recibes de vuelta, lo que cuesta o cómo se comporta el modelo dentro de un agente.
Anthropic afirma que los prompts existentes de Haiku 4.5 deberían funcionar bien en Haiku 5.5 sin cambios. El código de solicitudes que rodea a esos prompts es otra historia. Esta entrada enumera cada problema tal como lo encontrarás: qué verás, por qué ocurre y cómo solucionarlo, seguido de una lista de verificación. La referencia oficial es la guía de migración de Haiku 5.5 de Anthropic.
Diagnóstico: relaciona el síntoma
| Lo que ves | Causa | Solución |
|---|---|---|
| 400 en una solicitud con presupuesto de thinking | Se eliminó el thinking manual | Thinking adaptativo más effort |
| 400 con temperature, top_p o top_k | Parámetros de muestreo bloqueados | Elimínalos |
| 400 cuando los mensajes terminan en un turno del asistente | Se eliminó el prefill | Termina con un turno del usuario |
| 400 en uso de computadora | Se rechaza la herramienta de computadora antigua | Cambia al conjunto de herramientas de computadora |
| 400 después de editar turnos anteriores | El thinking está vinculado al historial | Mantén el historial solo en modo de adición |
| El analizador devuelve texto vacío o incorrecto | El bloque de thinking aparece primero | Selecciona los bloques por tipo |
| La respuesta se corta o falta | El thinking cuenta para el límite | Aumenta max_tokens o reduce el effort |
| Los tokens y la facturación suben alrededor de un 30% | Nuevo tokenizador | Vuelve a contar en el nuevo modelo |
| Respuesta con stop reason refusal | Nuevos clasificadores de seguridad | Gestiónalo en tu cliente |
Los primeros cinco fallan de forma evidente. Los demás fallan en silencio, lo que los hace más costosos de encontrar.
Los cinco fallos evidentes
1. Presupuestos de thinking manuales
Lo que verás: un 400 en cualquier solicitud que envíe thinking: {"type": "enabled", "budget_tokens": N}.
Por qué: Haiku 4.5 solo admitía razonamiento extendido manual con un presupuesto de tokens. Haiku 5.5 admite únicamente thinking adaptativo y controla la profundidad con effort.
Solución: envía {"type": "adaptive"} o omite thinking, y elige un nivel de effort. Cuando el presupuesto anterior era pequeño para ahorrar tokens, elige un nivel bajo.
# Before: Haiku 4.5
thinking={"type": "enabled", "budget_tokens": 8000}
# After: Haiku 5.5
thinking={"type": "adaptive"},
output_config={"effort": "medium"},
2. Parámetros de muestreo
Lo que verás: un 400 cuando una solicitud define temperature, top_p o top_k.
Por qué: Haiku 5.5 solo acepta los valores predeterminados: temperature de 1 y top_p de 0.99. Cualquier otro valor de cualquiera de los dos, cualquier top_k, o enviar temperature y top_p juntos devuelve un 400, tanto si se usa thinking como si no. Un top_p de 1 también se rechaza.
Solución: elimina los tres. El caso más común es temperature=0 en un clasificador, usado para obtener etiquetas estables. Reemplázalo por salida estructurada o por una herramienta cuya entrada sea un enum, de modo que el conjunto de etiquetas lo imponga el esquema y no el muestreo. Revisa también los wrappers de SDK y las pasarelas que añadan valores de muestreo predeterminados en tu nombre.
3. Prefill del asistente
Lo que verás: un 400 cuando la última entrada de messages es un turno del asistente, incluso con thinking desactivado.
Por qué: el prefill no es compatible con Haiku 5.5, igual que en el resto de la línea actual de Claude.
Solución: termina messages con un turno del usuario y sustituye el prefill por lo que se usaba para conseguir. El control del formato pasa a salida estructurada (output_config.format). Un preámbulo prefijado se convierte en una instrucción del prompt de sistema para responder directamente. La continuación de una respuesta interrumpida se traslada al mensaje del usuario: "Tu respuesta anterior terminó con [texto]. Continúa desde ahí".
4. Uso de computadora
Lo que verás: un 400 en la Claude API o en Google Cloud cuando la solicitud declara la herramienta computer_20250124.
Por qué: en esas plataformas, Haiku 5.5 solo admite uso de computadora mediante el conjunto de herramientas más reciente, computer_toolset_20260801.
Solución: elimina el encabezado beta computer-use-2025-01-24, reemplaza la entrada de herramienta por {"type": "computer_toolset_20260801"} y actualiza el bucle del agente: despacha según el name y el toolset_name de cada bloque tool_use, en lugar de hacerlo según input.action, gestiona todos esos bloques en un turno y repite toolset_name en los resultados. El zoom está activado por defecto; si tu entorno no lo implementa, desactívalo en la configuración del conjunto de herramientas. En Amazon Bedrock, revisa las notas de compatibilidad de la herramienta de uso de computadora antes de elegir una versión. La misma familia de conjuntos de herramientas también incluye uso de navegador, que Haiku 4.5 nunca tuvo.
5. Edición de turnos anteriores
Lo que verás: un 400 cuando una solicitud devuelve un bloque de thinking después de que haya cambiado algo anterior a él: el prompt de sistema, la lista de herramientas o un mensaje anterior.
Por qué: un bloque de thinking de Haiku 5.5 solo sigue siendo válido mientras no cambie nada de lo enviado antes. La comprobación se aplica por defecto a las cuentas creadas el 31 de agosto de 2026 o después, y en cuentas anteriores solo cuando una solicitud la activa.
Solución: mantén las conversaciones en modo de solo adición. Los culpables habituales son un prompt de sistema con una marca de tiempo, una lista de herramientas que crece cuando se conecta un plugin, el truncamiento en el cliente y los recordatorios insertados en el historial y eliminados en el turno siguiente. Para instrucciones por turno, Haiku 5.5 admite mensajes de sistema dentro de messages, sin encabezado beta, que añaden contexto sin editar lo que había antes.
Los fallos silenciosos
Los bloques de thinking van primero. El thinking está activado por defecto, así que una respuesta puede empezar con uno o más bloques thinking. El código que lee response.content[0].text como respuesta se rompe o devuelve texto vacío. Selecciona los bloques por type.
El texto del thinking está vacío por defecto. Haiku 4.5 devolvía el thinking resumido. Haiku 5.5 devuelve bloques thinking con el campo de texto vacío y solo una firma. Si tu interfaz mostraba resúmenes del razonamiento, configura thinking: {"type": "adaptive", "display": "summarized"}. En cualquier caso, devuelve los bloques de thinking sin cambios junto con los resultados de herramientas; un serializador que descarte bloques vacíos los elimina.
Ahora max_tokens tiene que cubrir el thinking. Un límite pensado para una respuesta corta puede agotarse con el thinking, terminando la respuesta con stop_reason: "max_tokens" antes de que aparezca cualquier texto. Aumenta el límite o reduce el effort.
El mismo texto son alrededor de un 30% más de tokens. El nuevo tokenizador cambia los campos de usage, los resultados de count_tokens, los presupuestos de contexto y cualquier max_tokens ajustado para Haiku 4.5. También desplaza el umbral de precio de 100K tokens a unos 77K tokens, tal como los contaba Haiku 4.5. Vuelve a contar tus prompts reales con el modelo configurado como claude-haiku-5-5 antes de fiarte de un panel de costes.
El effort por defecto es medium. Haiku 4.5 no tenía ajuste de effort. Haiku 5.5 usa medium por defecto, lo que puede suponer más thinking del que necesita una ruta sencilla. Configúralo explícitamente.
Los bloques de thinking pertenecen a la cuenta que los generó. Si tu servicio reproduce conversaciones almacenadas a través de una cuenta de API distinta, los bloques de thinking de Haiku 5.5 se descartan silenciosamente y la solicitud se ejecuta sin ese razonamiento. Reproduce cada conversación a través de la cuenta que la produjo.
Priority Tier no se traslada. Haiku 5.5 no admite Priority Tier, así que planifica la capacidad por separado si dependes de él con Haiku 4.5.
Cambios de comportamiento que importan a agentes con permisos reales
Los rechazos son nuevos y nada los detecta por ti. Haiku 5.5 ejecuta clasificadores de seguridad en cuatro categorías: ciberseguridad, bio, desarrollo de LLM de frontera y daños generales. Una negativa llega como un HTTP 200 normal con stop_reason: "refusal" y una categoría en stop_details. Haiku 5.5 no tiene un respaldo en el servidor: una lista de modelos de respaldo devuelve un 400, y el modo de respaldo predeterminado deja la solicitud rechazada. Comprueba stop_reason antes de leer content y decide en tu propio código si reformular, escalar a un modelo más grande o detenerte. Según la entrada de lanzamiento, las salvaguardas de ciberseguridad permiten una gama más amplia de trabajo defensivo que la de Sonnet 5.5, pero bloquean las pruebas de penetración.
El texto del usuario dentro de los resultados de herramientas puede ignorarse. Haiku 5.5 está entrenado para resistir la inyección de prompts a través de los resultados de herramientas. Si tu arnés entrega dentro de un bloque tool_result un mensaje que el usuario escribió a mitad de tarea, el modelo puede tratarlo como no fiable e ignorarlo. Coloca la entrada del usuario a mitad de turno en un bloque de texto posterior al último resultado de herramienta, y mantén los avisos del arnés en un mensaje de sistema aparte.
Con effort bajo, los agentes pueden detenerse pronto u omitir comprobaciones. Con un prompt de sistema largo de un agente de programación en low, Haiku 5.5 a veces devuelve la tarea antes de terminarla, y con low y medium a veces informa de que un cambio de código está hecho sin ejecutar una prueba. La guía de prompts de Haiku 5.5 de Anthropic incluye instrucciones breves para ambos casos. Para un agente que puede escribir archivos o ejecutar comandos, un "hecho" no verificado es el más peligroso de los dos.
Forzar una herramienta omite el thinking. El tool_choice forzado se sigue aceptando, pero el modelo llama a la herramienta sin razonar antes. Para herramientas con efectos secundarios, auto junto con una instrucción clara permite que el modelo razone antes de actuar.
Las herramientas de búsqueda necesitan la fecha de hoy. Cuando Haiku 5.5 tiene una herramienta de búsqueda, indícale la fecha actual en el prompt de sistema o en la descripción de la herramienta. En las pruebas de Anthropic, esto hizo que las respuestas se basaran en resultados recientes.
Una solicitud migrada a través de AIHubMix
Un clasificador de Haiku 4.5 que usaba temperature=0 y un { prefijado para JSON, reescrito para Haiku 5.5 en el endpoint nativo de Claude de AIHubMix:
import os
import anthropic
client = anthropic.Anthropic(
api_key=os.environ["AIHUBMIX_API_KEY"],
base_url="https://aihubmix.com",
)
r = client.messages.create(
model="claude-haiku-5-5",
max_tokens=2000, # room for thinking plus the JSON
output_config={
"effort": "low", # thinking is on by default; keep it light
"format": { # replaces the prefill and temperature=0
"type": "json_schema",
"schema": {
"type": "object",
"properties": {
"label": {"type": "string", "enum": ["billing", "bug", "other"]}
},
"required": ["label"],
"additionalProperties": False,
},
},
},
messages=[{"role": "user", "content": "Ticket: 'I was charged twice for October.'"}],
)
if r.stop_reason == "refusal":
raise RuntimeError(f"declined: {r.stop_details}")
text = next(b.text for b in r.content if b.type == "text")
print(text)
Conviene confirmar en la primera prueba si una pasarela reenvía sin cambios los campos de output_config y los encabezados beta más recientes. Cuando la ruta migrada supere tus evaluaciones, la lista de modelos de AIHubMix facilita apuntar el mismo código a Sonnet 5.5 para cualquier tipo de tarea que siga fallando en Haiku.
Lista de verificación de la migración
- Cambia el ID del modelo a claude-haiku-5-5, sin sufijo de fecha.
- Sustituye cada presupuesto de thinking por thinking adaptativo y un nivel de effort explícito.
- Elimina temperature, top_p y top_k, incluidos los valores predeterminados añadidos por los wrappers.
- Sustituye los prefills del asistente por salida estructurada, instrucciones de sistema o continuaciones en el turno del usuario.
- Mueve el uso de computadora al conjunto de herramientas de computer use y actualiza el bucle del agente.
- Haz que el historial de conversación sea solo de adición (append-only) si los bloques de thinking se reenvían.
- Lee el contenido de la respuesta según el tipo de bloque, y conserva los bloques de thinking vacíos al reenviarlos.
- Aumenta max_tokens en las rutas de respuestas cortas, o reduce el effort.
- Gestiona el stop reason de rechazo (refusal) antes de leer el contenido; no configures fallbacks del lado del servidor.
- Vuelve a contar los tokens del prompt en el nuevo modelo y restablece la línea base de los paneles de costos.
- Revisa qué prompts superan ahora los 100K tokens y recórtalos o divídelos.
- Configura display como summarized si los usuarios veían resúmenes del razonamiento.
- Entrega la entrada del usuario que llega a mitad de turno fuera de los resultados de las herramientas.
- Indica a los agentes con búsqueda la fecha de hoy.
- Vuelve a revisar los límites de tasa y las necesidades de Priority Tier antes de migrar el volumen.
Preguntas frecuentes
¿Mis prompts de Haiku 4.5 funcionarán en Haiku 5.5?
Anthropic indica que los prompts existentes deberían funcionar bien sin cambios. Lo que se rompe son los parámetros de la solicitud que los rodean: los presupuestos de thinking, la configuración de muestreo, los prefills y la antigua herramienta de computer use devuelven errores.
¿Por qué falla mi clasificador ahora que eliminé temperature 0?
No debería fallar, pero las etiquetas pueden variar más. Usa salida estructurada o una herramienta con un campo enum para que el esquema imponga las etiquetas permitidas. Eso es más fiable de lo que nunca fue temperature 0.
¿Todavía puedo desactivar el thinking?
Sí, con effort bajo, medio y alto. Con xhigh y max, desactivar el thinking devuelve un error. Anthropic recomienda usar un nivel de effort más bajo, porque el modelo puede omitir el thinking por sí mismo en solicitudes sencillas.
¿Qué debe hacer mi código cuando Haiku 5.5 rechaza una solicitud?
Revisa el stop reason antes de leer el contenido. Haiku 5.5 no tiene fallback del lado del servidor, así que tu código decide si reformula la solicitud, la envía a un modelo más grande o devuelve un error al usuario.
¿Por qué subió mi uso de tokens después de migrar?
Hay dos razones. El nuevo tokenizador cuenta alrededor de un 30% más de tokens para el mismo texto, y el thinking está activado por defecto, lo que añade tokens de salida. Reduce el effort y vuelve a contar los tokens de tus prompts en el nuevo modelo.
¿Necesito cambiar algo para el prompt caching?
Normalmente no, y resulta más sencillo: según la guía de migración de Anthropic, el prompt mínimo cacheable baja de 4,096 a 512 tokens, y los bloques de thinking de turnos anteriores permanecen en el prefijo cacheado por defecto. Evita editar turnos anteriores, porque ahora invalida tanto los bloques de thinking como la caché.
¿Puede una conversación pasar de Haiku 5.5 a un modelo más grande?
Sí, la conversación en sí se conserva. Que los bloques de thinking anteriores de Haiku 5.5 también se conserven depende del modelo de destino, así que consulta la documentación de Anthropic sobre thinking preservado antes de depender de ello.
Sigue leyendo: la serie Claude Haiku 5.5
- Antes de planificar la migración, conviene saber si el nuevo modelo cumple tu listón de calidad. Para ver los benchmarks frente a Haiku 4.5, GPT-6 Luna y Sonnet 5.5, lee Claude Haiku 5.5 vs Haiku 4.5: What Ten Cents Now Buys
- El paso 2 de la lista de verificación te pide elegir un nivel de effort. Para saber cuánto cuesta cada nivel en tokens y por dónde empezar, lee Claude Haiku 5.5 Effort Levels: Medium Is the Default, Low Is Often Enough
- El cambio de tokenizador mueve la línea de precios y también tus paneles. Para ver qué supone esto en una factura real, lee Claude Haiku 5.5 Pricing: The 100K Line Behind the 90% Cut
Fuentes
- Guía de migración de Claude Haiku 5.5 (Claude Platform Docs)
- Prompting Claude Haiku 5.5 (Claude Platform Docs)
- Introducing Claude Haiku 5.5 (Anthropic)
- Claude Haiku 5.5 en AIHubMix
- Claude Haiku 5.5 Is Out at $0.10 per Million Tokens. Read the 100K Rule Before You Migrate (Roo's Newsletter)



