Guía de migración a Claude Haiku 5.5
Cambia a Claude Haiku 5.5 desde modelos Haiku anteriores con esta guía de migración. Las indicaciones para habilitar Claude Haiku 5.5 incluyen el nuevo ID de modelo, los ajustes que devuelven errores, los cambios en el pensamiento y una lista de verificación para cada modelo de partida.
Claude Code
Deja que Claude Code migre tu código por ti
/claude-api migrate este proyecto a claude-haiku-5-5Esta guía cubre cómo migrar código que llama a Claude Haiku 4.5 a Claude Haiku 5.5. Para código que llama a Claude Haiku 3.5 o Claude Haiku 3, realiza también los cambios de Migrar a Claude Haiku 5.5 desde Claude Haiku 3.5 y modelos Haiku anteriores. Para pasar en cambio a un modelo Sonnet u Opus, consulta Guías de migración. Para saber durante cuánto tiempo seguirá disponible Claude Haiku 4.5, consulta Obsolescencia de modelos.
Lista de verificación de migración por modelo de partida
Recorre los grupos de arriba hacia abajo y detente después del que menciona tu modelo actual. Si usas Claude Haiku 4.5, el primer grupo es la lista completa. Cada elemento es un cambio que debes hacer en tu código.
Todos los modelos de partida
- Reemplaza el ID del modelo con el ID de Claude Haiku 5.5 para tu plataforma. Consulta Usar el ID de modelo de Claude Haiku 5.5.
- Vuelve a contar los tokens de tus prompts y revisa los límites de
max_tokensy las estimaciones de costos, porque el mismo texto cuenta como más tokens y las imágenes grandes cuentan como más tokens visuales. Consulta Volver a contar los tokens. - Si tus solicitudes envían
thinking: {"type": "enabled", "budget_tokens": N}, cambiathinkinga{"type": "adaptive"}. Consulta Configurar el pensamiento. - Si tu código lee el primer bloque de contenido como la respuesta, selecciona los bloques por
typeen su lugar. Consulta Configurar el pensamiento. - Elimina
temperature,top_pytop_kde tus solicitudes. Consulta Eliminar los parámetros de muestreo. - Si tus solicitudes terminan
messagescon un turno del asistente para que el modelo lo continúe, termínalas con un turno del usuario en su lugar. Consulta Reemplazar el prellenado del asistente. - Si usas la herramienta de uso de computadora, reemplaza
computer_20250124con el conjunto de herramientascomputer_toolset_20260801. En Amazon Bedrock,computer_20251124también funciona. Consulta Migrar el uso de computadora al conjunto de herramientas. - Si reproduces conversaciones almacenadas a través de una cuenta diferente, reproduce cada una a través de la cuenta que la produjo. Consulta Reproducir los bloques de pensamiento a través de la cuenta que los produjo.
- Si tu código cambia
system,toolsomessagesanteriores entre solicitudes de una conversación y envía de vuelta bloques de pensamiento, mantén la conversación en modo “append-only” (de solo anexar). Consulta Mantener sin cambios los turnos anteriores. - Maneja
stop_reason: "refusal". Claude Haiku 5.5 ejecuta clasificadores de seguridad que pueden rechazar una solicitud, y no tiene un respaldo del lado del servidor. Consulta Rechazos de salvaguardas. - Si tus prompts le piden al modelo que escriba su razonamiento en la respuesta, por ejemplo en etiquetas
<thinking>o<reasoning>, elimina esas instrucciones. Claude Haiku 5.5 podría rechazar una solicitud que las incluya y devolver la categoríareasoning_extraction. Consulta Rechazos de las salvaguardas.
Si tu organización tiene un compromiso de Priority Tier en Claude Haiku 4.5, planifica la capacidad por separado: Priority Tier no es compatible con Claude Haiku 5.5.
Claude Haiku 3.5 o anterior
- Reemplaza el ID del modelo Claude Haiku 3.5 o Claude Haiku 3 por el ID de Claude Haiku 5.5 para tu plataforma. Consulta Migrar a Claude Haiku 5.5 desde Claude Haiku 3.5 y modelos Haiku anteriores.
- Si usas la herramienta
code_execution_20250522, pasa acode_execution_20250825o posterior. - Si usas la herramienta de editor de texto, pasa a
text_editor_20250728. - Maneja los motivos de detención
refusalymodel_context_window_exceeded. - Si tu código compara exactamente los parámetros de cadena de las llamadas a herramientas, ten en cuenta los saltos de línea finales.
- Revisa tus prompts.
Usar el ID de modelo de Claude Haiku 5.5
Reemplaza el ID de modelo de Claude Haiku 4.5 por el ID de Claude Haiku 5.5 para tu plataforma.
| Plataforma | Claude Haiku 4.5 | Claude Haiku 5.5 |
|---|---|---|
| Claude API | claude-haiku-4-5-20251001 o claude-haiku-4-5 | claude-haiku-5-5 |
| Amazon Bedrock | anthropic.claude-haiku-4-5 | anthropic.claude-haiku-5-5 |
| Claude Platform on AWS | claude-haiku-4-5 | claude-haiku-5-5 |
| Claude Models on Google Cloud (Anthropic managed) | claude-haiku-4-5-20251001 | claude-haiku-5-5 |
| Claude Models on Google Cloud (Google managed) | claude-haiku-4-5@20251001 | claude-haiku-5-5 |
| Microsoft Foundry | claude-haiku-4-5 | claude-haiku-5-5 |
claude-haiku-5-5 es un ID de modelo fijo sin sufijo de fecha y sin alias independiente.
Volver a contar los tokens
Claude Haiku 5.5 usa el mismo tokenizador que Claude 4.7 y los modelos posteriores. Como 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. Las solicitudes, las respuestas y los eventos de streaming mantienen la misma forma. Lo que cambia es todo lo que mides o presupuestas en tokens:
- Los campos de
usagey los resultados del conteo de tokens son mayores para el mismo texto. - Una cantidad determinada de tokens contiene menos texto.
- Un límite de
max_tokensajustado para Claude Haiku 4.5 podría cortar una salida equivalente. - Las estimaciones de costo hechas a partir de los conteos de tokens de Claude Haiku 4.5 deben volver a calcularse con los conteos y los precios de Claude Haiku 5.5, incluidos sus precios más altos para prompts largos. Consulta Precios y Precios de contexto largo.
Las imágenes grandes también pueden costar más tokens. Claude Haiku 5.5 usa el nivel de imagen de alta resolución, que reduce las imágenes de más de 2,576 píxeles en el lado largo o de más de 4,784 tokens visuales. Claude Haiku 4.5 y los modelos Haiku anteriores usan el nivel estándar, que reduce las imágenes de más de 1,568 píxeles en el lado largo o de más de 1,568 tokens visuales. Una imagen de 2,000 por 1,500 píxeles cuesta unas 2.5 veces más tokens visuales en Claude Haiku 5.5 que en Claude Haiku 4.5. Consulta Resolución y costo en tokens.
Cuenta los tokens de tus prompts con model establecido en claude-haiku-5-5 en lugar de reutilizar conteos medidos en Claude Haiku 4.5.
Configurar el pensamiento
Claude Haiku 5.5 configura el pensamiento de forma diferente a Claude Haiku 4.5. Un valor de thinking de {"type": "enabled", "budget_tokens": N} devuelve un error 400, por lo que una solicitud que lo envíe necesita un nuevo valor de thinking.
Antes, una solicitud a Claude Haiku 4.5 establecía thinking en enabled con un presupuesto de tokens:
{
"model": "claude-haiku-4-5",
"max_tokens": 16000,
"thinking": { "type": "enabled", "budget_tokens": 8000 },
"messages": [{ "role": "user", "content": "..." }]
}Después, la misma solicitud a Claude Haiku 5.5 usa el pensamiento adaptativo. El valor de thinking cambia, y output_config.effort establece cuánto piensa el modelo:
{
"model": "claude-haiku-5-5",
"max_tokens": 16000,
"thinking": { "type": "adaptive" },
"output_config": { "effort": "medium" },
"messages": [{ "role": "user", "content": "..." }]
}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 establece thinking. Deja thinking sin establecer o establécelo en {"type": "adaptive"}, y usa el esfuerzo como control: donde Claude Haiku 4.5 se ejecutaba sin pensamiento, o con un presupuesto pequeño para ahorrar tokens, elige un nivel de esfuerzo más bajo. Con un nivel más bajo, el modelo piensa menos y puede omitir el pensamiento por completo en solicitudes más simples. Para obtener orientación sobre prompts, consulta Usar el esfuerzo para controlar el pensamiento. Selecciona los bloques de contenido por su campo type en lugar de por su posición, y devuelve los bloques thinking sin modificar junto con los resultados de las herramientas.
Los tokens de pensamiento cuentan para max_tokens, por lo que una solicitud con un max_tokens pequeño puede detenerse con stop_reason: "max_tokens" después de un bloque thinking y antes de cualquier texto. Si estableciste un max_tokens pequeño para Claude Haiku 4.5, auméntalo para dejar espacio para el pensamiento, o elige un nivel de esfuerzo más bajo.
Los bloques de pensamiento de turnos anteriores del asistente permanecen en el contexto y cuentan como tokens de entrada, mientras que Claude Haiku 4.5 conserva solo los del turno más reciente. Por lo tanto, las conversaciones de varios turnos llevan más tokens de entrada de lo que explica solo el cambio de tokenizador. Para eliminar los bloques más antiguos, usa la eliminación de bloques de pensamiento. Consulta Conservación de bloques de pensamiento por modelo.
De forma predeterminada, Claude Haiku 5.5 devuelve cada bloque thinking con un campo thinking vacío y solo una signature, mientras que Claude Haiku 4.5 devuelve el pensamiento resumido. Para recibir el pensamiento resumido, establece thinking: {"type": "adaptive", "display": "summarized"}.
Claude Haiku 5.5 acepta un tool_choice forzado (any o una herramienta con nombre), pero la respuesta comienza con la llamada a la herramienta y no tiene bloque thinking. Para permitir que el modelo piense antes de llamar a una herramienta, usa tool_choice: {"type": "auto"} e indica en el prompt cuándo usar la herramienta.
Una conversación que cambies de Claude Haiku 4.5 a Claude Haiku 5.5 conserva su razonamiento. Para otros cambios, depende de los dos modelos:
| Cambio | Conserva su razonamiento |
|---|---|
| A Claude Haiku 5.5, desde Claude Haiku 4.5 o anterior, Claude Sonnet 5 o anterior, o Claude Opus 4.8 o anterior | Sí |
| A Claude Haiku 5.5, desde cualquier otro modelo | No. La API omite los bloques de pensamiento de ese modelo sin error. |
| Desde Claude Haiku 5.5, a Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5.2 o Claude Mythos 5.2 | Sí, solo en la Claude API y en Claude Models on Google Cloud (Google managed) |
| Desde Claude Haiku 5.5, a cualquier otro modelo | No |
Consulta Cambiar de modelo y volver. Para cambios que no involucran a Claude Haiku 5.5, consulta Qué cambios de modelo conservan el razonamiento en la API de Claude.
Eliminar los parámetros de muestreo
En Claude Haiku 5.5, omite temperature, top_p y top_k y usa los prompts para guiar el comportamiento del modelo en su lugar.
Reemplazar el prellenado del asistente
Un prellenado es un turno final del asistente en messages que el modelo continúa. Claude Haiku 4.5 lo acepta cuando el pensamiento está desactivado. Claude Haiku 5.5 lo rechaza con un error 400, incluso con el pensamiento desactivado. Termina messages con un turno del usuario y reemplaza cada prellenado según su propósito:
- Formato de salida: usa salidas estructuradas, o herramientas con campos enum para la clasificación.
- Preámbulos: pide en la indicación del sistema una respuesta directa.
- Continuaciones: muévelas al mensaje del usuario, por ejemplo: “Tu respuesta anterior se interrumpió y terminó con
[previous_response]. Continúa desde donde te quedaste.” - Recordatorios de contexto: colócalos en el turno del usuario.
Migrar el uso de computadora al conjunto de herramientas
Claude Haiku 4.5 admite el uso de computadora a través de la herramienta computer_20250124, con el encabezado beta computer-use-2025-01-24. Claude Haiku 5.5 admite el uso de computadora a través del conjunto de herramientas computer_toolset_20260801. Una solicitud a Claude Haiku 5.5 que declara computer_20250124 devuelve un error 400.
Para migrar una integración al conjunto de herramientas, omite el encabezado beta computer-use-2025-01-24 y reemplaza la entrada de tools con {"type": "computer_toolset_20260801"}. Luego realiza los demás cambios en la solicitud y en el bucle del agente descritos en Migra desde computer_20251124. Despacha según el name y el toolset_name de cada bloque tool_use miembro en lugar de según input.action. Maneja cada uno de esos bloques en un turno y repite toolset_name en los resultados. El zoom está activado de forma predeterminada en el conjunto de herramientas; si tu entorno no lo implementa, agrega "configs": {"zoom": {"enabled": false}}. Si envías el encabezado beta fine-grained-tool-streaming-2025-05-14, elimínalo. Junto con una entrada de conjunto de herramientas, devuelve un error 400.
En Amazon Bedrock, Claude Haiku 5.5 también acepta la herramienta computer_20251124 con el encabezado beta computer-use-2025-11-24.
Claude Haiku 5.5 admite la herramienta de uso del navegador (browser_toolset_20260801) para tareas dentro de páginas web. Claude Haiku 4.5 no la admite.
Reproducir los bloques de pensamiento a través de la cuenta que los produjo
Los bloques de pensamiento de Claude Haiku 5.5 funcionan solo en la cuenta que los produjo o en una cuenta vinculada a ella. Cuando otra cuenta envía uno de estos bloques, la API omite el bloque antes de que el modelo lo reciba, y la solicitud se completa correctamente sin ese razonamiento. Esto afecta al código que almacena conversaciones y las reproduce a través de una cuenta diferente, por ejemplo, un servicio que atiende a varios clientes desde un único almacén de conversaciones. Reproduce cada conversación a través de la cuenta que la produjo. Consulta Cuentas y plataformas en la nube.
Mantener sin cambios los turnos anteriores
Mantén las conversaciones en modo de solo anexar. Un bloque de pensamiento de Claude Haiku 5.5 sigue siendo válido solo mientras todo lo enviado antes de él permanezca sin cambios: la indicación del sistema system, las tools y cada mensaje anterior.
No superar la “prefix check” (verificación de prefijo) puede o no dar lugar a un error 400. Para identificar y manejar ambos casos, consulta Verificaciones de prefijo en bloques de pensamiento.
Para conocer los cambios que provocan el error y qué hacer en su lugar, consulta Si tu código cambia la indicación del sistema, las herramientas o el historial.
Migrar a Claude Haiku 5.5 desde Claude Haiku 3.5 y modelos Haiku anteriores
Claude Haiku 3.5 está retirado en la Claude API, en Amazon Bedrock y en Claude Models on Google Cloud (Google managed). Claude Haiku 3 está retirado en la Claude API y en Claude Models on Google Cloud (Google managed). Consulta Obsolescencia de modelos.
Desde cualquiera de los dos modelos, aplica primero todas las secciones anteriores y luego estos cambios:
- ID del modelo: Reemplaza
claude-3-5-haiku-20241022, su aliasclaude-3-5-haiku-latestoclaude-3-haiku-20240307porclaude-haiku-5-5. En Claude Models on Google Cloud (Google managed), reemplazaclaude-3-5-haiku@20241022porclaude-haiku-5-5. En Amazon Bedrock, usa el ID de Claude Haiku 5.5 de Usar el ID de modelo de Claude Haiku 5.5. - Ejecución de código: Claude Haiku 5.5 acepta
code_execution_20250825y versiones posteriores. Si usas la versión solo para Pythoncode_execution_20250522, pasa a una de ellas. Consulta Actualizar a la versión más reciente de la herramienta. - Editor de texto: Si usas la herramienta de editor de texto, pasa a
text_editor_20250728(nombre de herramientastr_replace_based_edit_tool), que no tiene el comandoundo_edit. Consulta Herramienta de editor de texto. - Motivos de detención: Maneja
refusalymodel_context_window_exceeded. Consulta Razones de detención y fallback. - Saltos de línea finales: Claude 4.5 y los modelos posteriores conservan los saltos de línea finales en los parámetros de cadena de las llamadas a herramientas. Si tu código compara esas cadenas exactamente, tenlos en cuenta.
- Prompts: Claude 4 y los modelos posteriores tienen un estilo de comunicación más conciso y directo, y necesitan instrucciones explícitas. Revisa tus prompts con base en Prompts para Claude Haiku 5.5 y Mejores prácticas de prompts.
¿Te resultó útil esta página?