---
title: Guía de migración a Claude Haiku 5.5
url: https://platform.claude.com/docs/es/models/haiku-5-5/migration-guide
description: 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.
---

<Note>
  Esta guía cubre la migración de código de la [Messages API](https://platform.claude.com/docs/es/build-with-claude/working-with-messages). Si usas [Claude Managed Agents](https://platform.claude.com/docs/es/managed-agents/overview), no se requieren cambios más allá de actualizar el nombre del modelo.
</Note>

Deja que Claude Code migre tu código por ti

```text
/claude-api migrate este proyecto a claude-haiku-5-5
```

Esta 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](https://platform.claude.com/docs/es/models/haiku-5-5/migration-guide#migrating-from-haiku-35). Para pasar en cambio a un modelo Sonnet u Opus, consulta [Guías de migración](https://platform.claude.com/docs/es/about-claude/models/migration-guide). Para saber durante cuánto tiempo seguirá disponible Claude Haiku 4.5, consulta [Obsolescencia de modelos](https://platform.claude.com/docs/es/about-claude/model-deprecations).

## 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

1. 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](https://platform.claude.com/docs/es/models/haiku-5-5/migration-guide#use-the-claude-haiku-5-5-model-id).
2. Vuelve a contar los tokens de tus prompts y revisa los límites de `max_tokens` y 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](https://platform.claude.com/docs/es/models/haiku-5-5/migration-guide#recount-tokens).
3. Si tus solicitudes envían `thinking: {"type": "enabled", "budget_tokens": N}`, cambia `thinking` a `{"type": "adaptive"}`. Consulta [Configurar el pensamiento](https://platform.claude.com/docs/es/models/haiku-5-5/migration-guide#configure-thinking).
4. Si tu código lee el primer bloque de contenido como la respuesta, selecciona los bloques por `type` en su lugar. Consulta [Configurar el pensamiento](https://platform.claude.com/docs/es/models/haiku-5-5/migration-guide#configure-thinking).
5. Elimina `temperature`, `top_p` y `top_k` de tus solicitudes. Consulta [Eliminar los parámetros de muestreo](https://platform.claude.com/docs/es/models/haiku-5-5/migration-guide#remove-sampling-parameters).
6. Si tus solicitudes terminan `messages` con 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](https://platform.claude.com/docs/es/models/haiku-5-5/migration-guide#replace-assistant-prefill).
7. Si usas la herramienta de uso de computadora, reemplaza `computer_20250124` con el conjunto de herramientas `computer_toolset_20260801`. En Amazon Bedrock, `computer_20251124` también funciona. Consulta [Migrar el uso de computadora al conjunto de herramientas](https://platform.claude.com/docs/es/models/haiku-5-5/migration-guide#computer-use-toolset).
8. 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](https://platform.claude.com/docs/es/models/haiku-5-5/migration-guide#replay-thinking-blocks-through-the-producing-account).
9. Si tu código cambia `system`, `tools` o `messages` anteriores 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](https://platform.claude.com/docs/es/models/haiku-5-5/migration-guide#keep-earlier-turns-unchanged).
10. 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](https://platform.claude.com/docs/es/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#safeguard-refusals).
11. 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ía `reasoning_extraction`. Consulta [Rechazos de las salvaguardas](https://platform.claude.com/docs/es/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#safeguard-refusals).

Si tu organización tiene un compromiso de [Priority Tier](https://platform.claude.com/docs/es/api/service-tiers#supported-models) 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

1. 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](https://platform.claude.com/docs/es/models/haiku-5-5/migration-guide#migrating-from-haiku-35).
2. Si usas la herramienta `code_execution_20250522`, pasa a `code_execution_20250825` o posterior.
3. Si usas la herramienta de editor de texto, pasa a `text_editor_20250728`.
4. Maneja los motivos de detención `refusal` y `model_context_window_exceeded`.
5. 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.
6. 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 `usage` y los resultados del [conteo de tokens](https://platform.claude.com/docs/es/build-with-claude/token-counting) son mayores para el mismo texto.
* Una cantidad determinada de tokens contiene menos texto.
* Un límite de `max_tokens` ajustado 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](https://platform.claude.com/docs/es/about-claude/pricing) y [Precios de contexto largo](https://platform.claude.com/docs/es/about-claude/pricing#long-context-pricing).

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](https://platform.claude.com/docs/es/build-with-claude/vision#evaluate-image-size).

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:

```json
{
  "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:

```json
{
  "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](https://platform.claude.com/docs/es/build-with-claude/effort) 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](https://platform.claude.com/docs/es/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#use-effort-to-control-thinking). 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](https://platform.claude.com/docs/es/build-with-claude/effort) 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](https://platform.claude.com/docs/es/build-with-claude/context-editing#thinking-block-clearing). Consulta [Conservación de bloques de pensamiento por modelo](https://platform.claude.com/docs/es/build-with-claude/thinking#thinking-block-preservation-by-model).

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](https://platform.claude.com/docs/es/build-with-claude/preserved-thinking#switching-models). Para cambios que no involucran a Claude Haiku 5.5, consulta [Qué cambios de modelo conservan el razonamiento en la API de Claude](https://platform.claude.com/docs/es/build-with-claude/preserved-thinking#which-model-switches-keep-reasoning).

## 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](https://platform.claude.com/docs/es/build-with-claude/structured-outputs), 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](https://platform.claude.com/docs/es/agents-and-tools/tool-use/computer-use-tool) 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`](https://platform.claude.com/docs/es/agents-and-tools/tool-use/computer-use-tool#migrate-from-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](https://platform.claude.com/docs/es/agents-and-tools/tool-use/browser-use-tool) (`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](https://platform.claude.com/docs/es/build-with-claude/preserved-thinking#account-bound-thinking).

## 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)](https://platform.claude.com/docs/es/build-with-claude/preserved-thinking/prefix-checks#prefix-check) puede o no dar lugar a un [error 400](https://platform.claude.com/docs/es/api/errors#thinking-block-conversation-mismatch). Para identificar y manejar ambos casos, consulta [Verificaciones de prefijo en bloques de pensamiento](https://platform.claude.com/docs/es/build-with-claude/preserved-thinking/prefix-checks).

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](https://platform.claude.com/docs/es/build-with-claude/preserved-thinking/prefix-checks#what-to-check).

## 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](https://platform.claude.com/docs/es/about-claude/model-deprecations).

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 alias `claude-3-5-haiku-latest` o `claude-3-haiku-20240307` por `claude-haiku-5-5`. En Claude Models on Google Cloud (Google managed), reemplaza `claude-3-5-haiku@20241022` por `claude-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](https://platform.claude.com/docs/es/models/haiku-5-5/migration-guide#use-the-claude-haiku-5-5-model-id).
* **Ejecución de código:** Claude Haiku 5.5 acepta `code_execution_20250825` y versiones posteriores. Si usas la versión solo para Python `code_execution_20250522`, pasa a una de ellas. Consulta [Actualizar a la versión más reciente de la herramienta](https://platform.claude.com/docs/es/agents-and-tools/tool-use/code-execution-tool#upgrade-to-latest-tool-version).
* **Editor de texto:** Si usas la herramienta de editor de texto, pasa a `text_editor_20250728` (nombre de herramienta `str_replace_based_edit_tool`), que no tiene el comando `undo_edit`. Consulta [Herramienta de editor de texto](https://platform.claude.com/docs/es/agents-and-tools/tool-use/text-editor-tool).
* **Motivos de detención:** Maneja `refusal` y `model_context_window_exceeded`. Consulta [Razones de detención y fallback](https://platform.claude.com/docs/es/build-with-claude/handling-stop-reasons).
* **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](https://platform.claude.com/docs/es/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5) y [Mejores prácticas de prompts](https://platform.claude.com/docs/es/build-with-claude/prompt-engineering/claude-prompting-best-practices).
