Esta guía cubre dos rutas de migración clave a los modelos Claude 4.5:
Ambas migraciones implican cambios importantes que requieren actualizaciones en tu implementación. Esta guía te guiará a través de cada ruta de migración con instrucciones paso a paso y cambios importantes claramente marcados.
Antes de comenzar tu migración, te recomendamos revisar Novedades en Claude 4.5 para entender las nuevas características y capacidades disponibles en estos modelos, incluyendo pensamiento extendido, conciencia de contexto y mejoras de comportamiento.
Claude Sonnet 4.5 es nuestro modelo más inteligente, ofreciendo rendimiento de clase mundial para razonamiento, codificación y agentes autónomos de larga duración. Esta migración incluye varios cambios importantes que requieren actualizaciones en tu implementación.
Actualiza el nombre de tu modelo:
# Antes (Claude Sonnet 3.7)
model="claude-3-7-sonnet-20250219"
# Después (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"Actualiza los parámetros de muestreo
Este es un cambio importante respecto a Claude Sonnet 3.7.
Usa solo temperature O top_p, no ambos:
# Antes (Claude Sonnet 3.7) - Esto causará error en Sonnet 4.5
response = client.messages.create(
model="claude-3-7-sonnet-20250219",
temperature=0.7,
top_p=0.9, # No puedes usar ambos
...
)
# Después (Claude Sonnet 4.5)
response = client.messages.create(
model="claude-sonnet-4-5-20250929",
temperature=0.7, # Usa temperature O top_p, no ambos
...
)Maneja la nueva razón de parada refusal
Actualiza tu aplicación para manejar razones de parada refusal:
response = client.messages.create(...)
if response.stop_reason == "refusal":
# Maneja el rechazo apropiadamente
passActualiza la herramienta de editor de texto (si aplica)
Este es un cambio importante respecto a Claude Sonnet 3.7.
Actualiza a text_editor_20250728 (tipo) y str_replace_based_edit_tool (nombre). Elimina cualquier código que use el comando undo_edit.
# Antes (Claude Sonnet 3.7)
tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]
# Después (Claude Sonnet 4.5)
tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]Consulta la documentación de la herramienta de editor de texto para más detalles.
Actualiza la herramienta de ejecución de código (si aplica)
Actualiza a code_execution_20250825. La versión heredada code_execution_20250522 aún funciona pero no se recomienda. Consulta la documentación de la herramienta de ejecución de código para instrucciones de migración.
Elimina el encabezado beta de uso de herramientas eficiente en tokens
El uso de herramientas eficiente en tokens es una característica beta que solo funciona con Claude 3.7 Sonnet. Todos los modelos Claude 4 tienen uso de herramientas eficiente en tokens integrado, por lo que ya no debes incluir el encabezado beta.
Elimina el encabezado beta token-efficient-tools-2025-02-19 de tus solicitudes:
# Antes (Claude Sonnet 3.7)
client.messages.create(
model="claude-3-7-sonnet-20250219",
betas=["token-efficient-tools-2025-02-19"], # Elimina esto
...
)
# Después (Claude Sonnet 4.5)
client.messages.create(
model="claude-sonnet-4-5-20250929",
# Sin encabezado beta de herramientas eficientes en tokens
...
)Elimina el encabezado beta de salida extendida
El encabezado beta output-128k-2025-02-19 para salida extendida solo está disponible en Claude Sonnet 3.7.
Elimina este encabezado de tus solicitudes:
# Antes (Claude Sonnet 3.7)
client.messages.create(
model="claude-3-7-sonnet-20250219",
betas=["output-128k-2025-02-19"], # Elimina esto
...
)
# Después (Claude Sonnet 4.5)
client.messages.create(
model="claude-sonnet-4-5-20250929",
# Sin encabezado beta de salida-128k
...
)Actualiza tus indicaciones para cambios de comportamiento
Claude Sonnet 4.5 tiene un estilo de comunicación más conciso y directo y requiere dirección explícita. Revisa las mejores prácticas de ingeniería de indicaciones de Claude 4 para orientación de optimización.
Considera habilitar el pensamiento extendido para tareas complejas
Habilita el pensamiento extendido para mejoras significativas de rendimiento en tareas de codificación y razonamiento (deshabilitado por defecto):
response = client.messages.create(
model="claude-sonnet-4-5-20250929",
max_tokens=16000,
thinking={"type": "enabled", "budget_tokens": 10000},
messages=[...]
)El pensamiento extendido impacta la eficiencia del almacenamiento en caché de indicaciones.
Prueba tu implementación
Prueba en un entorno de desarrollo antes de desplegar en producción para asegurar que todos los cambios importantes se manejan correctamente.
claude-sonnet-4-5-20250929temperature O top_p, no ambosrefusal en tu aplicacióntext_editor_20250728 y str_replace_based_edit_tool (si aplica)undo_edit (si aplica)code_execution_20250825 (si aplica)token-efficient-tools-2025-02-19 (si aplica)output-128k-2025-02-19 (si aplica)model_context_window_exceeded (específica de Sonnet 4.5)token-efficient-tools-2025-02-19 solo funciona con Claude 3.7 Sonnet y no es compatible con modelos Claude 4 (ver paso 6)output-128k-2025-02-19 no es compatible (ver paso 7)Ambos encabezados pueden incluirse en solicitudes de Claude 4 pero no tendrán efecto.
Claude Haiku 4.5 es nuestro modelo Haiku más rápido e inteligente con rendimiento cercano a la frontera, ofreciendo calidad de modelo premium con rendimiento en tiempo real para aplicaciones interactivas y procesamiento inteligente de alto volumen. Esta migración incluye varios cambios importantes que requieren actualizaciones en tu implementación.
Para una descripción general completa de las nuevas capacidades, consulta Novedades en Claude 4.5.
Precios de Haiku 4.5: $1 por millón de tokens de entrada, $5 por millón de tokens de salida. Consulta Precios de Claude para más detalles.
Actualiza el nombre de tu modelo:
# Antes (Haiku 3.5)
model="claude-3-5-haiku-20241022"
# Después (Haiku 4.5)
model="claude-haiku-4-5-20251001"Actualiza las versiones de herramientas (si aplica)
Este es un cambio importante respecto a Claude Haiku 3.5.
Haiku 4.5 solo soporta las versiones más recientes de herramientas:
# Antes (Haiku 3.5)
tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]
# Después (Haiku 4.5)
tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]text_editor_20250728 y str_replace_based_edit_toolcode_execution_20250825undo_editActualiza los parámetros de muestreo
Este es un cambio importante respecto a Claude Haiku 3.5.
Usa solo temperature O top_p, no ambos:
# Antes (Haiku 3.5) - Esto causará error en Haiku 4.5
response = client.messages.create(
model="claude-3-5-haiku-20241022",
temperature=0.7,
top_p=0.9, # No puedes usar ambos
...
)
# Después (Haiku 4.5)
response = client.messages.create(
model="claude-haiku-4-5-20251001",
temperature=0.7, # Usa temperature O top_p, no ambos
...
)Revisa los nuevos límites de velocidad
Haiku 4.5 tiene límites de velocidad separados de Haiku 3.5. Consulta la documentación de límites de velocidad para más detalles.
Maneja la nueva razón de parada refusal
Actualiza tu aplicación para manejar razones de parada de rechazo.
Considera habilitar el pensamiento extendido para tareas complejas
Habilita el pensamiento extendido para mejoras significativas de rendimiento en tareas de codificación y razonamiento (deshabilitado por defecto):
response = client.messages.create(
model="claude-haiku-4-5-20251001",
max_tokens=16000,
thinking={"type": "enabled", "budget_tokens": 5000},
messages=[...]
)El pensamiento extendido impacta la eficiencia del almacenamiento en caché de indicaciones.
Explora nuevas capacidades
Consulta Novedades en Claude 4.5 para detalles sobre conciencia de contexto, capacidad de salida aumentada (64K tokens), mayor inteligencia y velocidad mejorada.
Prueba tu implementación
Prueba en un entorno de desarrollo antes de desplegar en producción para asegurar que todos los cambios importantes se manejan correctamente.
claude-haiku-4-5-20251001text_editor_20250728, code_execution_20250825) - versiones heredadas no soportadasundo_edit (si aplica)temperature O top_p, no ambosrefusal en tu aplicaciónTanto Claude Sonnet 4.5 como Claude Haiku 4.5 son modelos Claude 4 poderosos con diferentes fortalezas:
Los modelos Claude 4, particularmente Sonnet y Haiku 4.5, muestran mejoras significativas de rendimiento cuando se usa el pensamiento extendido para tareas de codificación y razonamiento complejo. El pensamiento extendido está deshabilitado por defecto pero recomendamos habilitarlo para trabajo exigente.
Importante: El pensamiento extendido impacta la eficiencia del almacenamiento en caché de indicaciones. Cuando se agrega contenido que no es resultado de herramienta a una conversación, los bloques de pensamiento se eliminan del caché, lo que puede aumentar costos en conversaciones de múltiples turnos. Recomendamos habilitar el pensamiento cuando los beneficios de rendimiento superan el compromiso de almacenamiento en caché.
Las rutas de migración primarias cubiertas arriba (Sonnet 3.7 → 4.5 y Haiku 3.5 → 4.5) representan las actualizaciones más comunes. Sin embargo, es posible que estés migrando desde otros modelos Claude a Claude 4.5. Esta sección cubre esos escenarios.
Cambio importante: No puedes especificar tanto temperature como top_p en la misma solicitud.
Todas las otras llamadas a la API funcionarán sin modificación. Actualiza tu ID de modelo y ajusta los parámetros de muestreo si es necesario:
# Antes (Claude Sonnet 4)
model="claude-sonnet-4-20250514"
# Después (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"Sin cambios importantes. Todas las llamadas a la API funcionarán sin modificación.
Simplemente actualiza tu ID de modelo:
# Antes (Claude Opus 4.1)
model="claude-opus-4-1-20250805"
# Después (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"Claude Sonnet 4.5 es nuestro modelo más inteligente con razonamiento de clase mundial, capacidades de codificación y agentes de larga duración. Ofrece rendimiento superior en comparación con Opus 4.1 para la mayoría de casos de uso.
Sin cambios importantes. Todas las llamadas a la API funcionarán sin modificación.
Simplemente actualiza tu ID de modelo:
# Antes (Claude Opus 4.1)
model="claude-opus-4-1-20250805"
# Después (Claude Opus 4.5)
model="claude-opus-4-5-20251101"Claude Opus 4.5 es nuestro modelo más inteligente, combinando capacidad máxima con rendimiento práctico. Presenta mejoras de cambio de paso en visión, codificación y uso de computadora a un precio más accesible que Opus 4.1. Ideal para tareas especializadas complejas e ingeniería de software profesional.
Para bases de código con muchas referencias de modelo, hay disponible un complemento de código Claude para automatizar la migración a Opus 4.5.
Sin cambios importantes. Todas las llamadas a la API funcionarán sin modificación.
Simplemente actualiza tu ID de modelo.