Esta guía cubre dos rutas de migración clave a los modelos Claude 4.5:
  • Claude Sonnet 3.7 → Claude Sonnet 4.5: Nuestro modelo más inteligente con capacidades de razonamiento, codificación y agentes de larga duración de primera clase
  • Claude Haiku 3.5 → Claude Haiku 4.5: Nuestro modelo Haiku más rápido e inteligente con rendimiento casi fronterizo para aplicaciones en tiempo real y procesamiento inteligente de alto volumen
Ambas migraciones involucran 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, recomendamos revisar Qué hay de nuevo en Claude 4.5 para entender las nuevas características y capacidades disponibles en estos modelos, incluyendo pensamiento extendido, conciencia del contexto y mejoras de comportamiento.

​
Migración de Claude Sonnet 3.7 a Claude Sonnet 4.5

Claude Sonnet 4.5 es nuestro modelo más inteligente, ofreciendo rendimiento de primera clase 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.

​
Pasos de migración

  1. 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"
  2. Actualiza los parámetros de muestreo
    Este es un cambio importante desde Claude Sonnet 3.7.
    Usa solo temperature O top_p, no ambos: 
    # Antes (Claude Sonnet 3.7) - Esto dará error en Sonnet 4.5
response = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    temperature=0.7,
    top_p=0.9,  # No se pueden 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
    ...
)
  3. 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
    pass
  4. Actualiza la herramienta de editor de texto (si aplica)
    Este es un cambio importante desde 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.
  5. 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.
  6. Elimina el encabezado beta de uso eficiente de herramientas El uso eficiente de herramientas es una característica beta en Claude 3.7. Todos los modelos Claude 4 tienen uso eficiente de herramientas incorporado, 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 token-efficient-tools
    ...
)
  7. 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 output-128k
    ...
)
  8. Actualiza tus prompts 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 prompts de Claude 4 para orientación de optimización.
  9. 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 prompts.
  10. Prueba tu implementación
Prueba en un entorno de desarrollo antes de desplegar a producción para asegurar que todos los cambios importantes se manejen correctamente.

​
Lista de verificación de migración Sonnet 3.7 → 4.5

  • Actualizar ID del modelo a claude-sonnet-4-5-20250929
  • IMPORTANTE: Actualizar parámetros de muestreo para usar solo temperature O top_p, no ambos
  • Manejar nueva razón de parada refusal en tu aplicación
  • IMPORTANTE: Actualizar herramienta de editor de texto a text_editor_20250728 y str_replace_based_edit_tool (si aplica)
  • IMPORTANTE: Eliminar cualquier código que use el comando undo_edit (si aplica)
  • Actualizar herramienta de ejecución de código a code_execution_20250825 (si aplica)
  • Eliminar encabezado beta token-efficient-tools-2025-02-19 (si aplica)
  • Eliminar encabezado beta output-128k-2025-02-19 (si aplica)
  • Revisar y actualizar prompts siguiendo las mejores prácticas de Claude 4
  • Considerar habilitar pensamiento extendido para tareas de razonamiento complejas
  • Manejar razón de parada model_context_window_exceeded (específico de Sonnet 4.5)
  • Considerar habilitar herramienta de memoria para agentes de larga duración (beta)
  • Considerar usar limpieza automática de llamadas de herramientas para edición de contexto (beta)
  • Probar en entorno de desarrollo antes del despliegue en producción

​
Características eliminadas de Claude Sonnet 3.7

  • Uso eficiente de herramientas: El encabezado beta token-efficient-tools-2025-02-19 no es compatible (ver paso 6)
  • Salida extendida: El encabezado beta output-128k-2025-02-19 no es compatible (ver paso 7)
Ambos encabezados pueden incluirse en las solicitudes pero no tendrán efecto.

​
Migración de Claude Haiku 3.5 a Claude Haiku 4.5

Claude Haiku 4.5 es nuestro modelo Haiku más rápido e inteligente con rendimiento casi fronterizo, entregando 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 completa de las nuevas capacidades, consulta Qué hay de nuevo en Claude 4.5.
Precios de Haiku 4.5: 1pormilloˊndetokensdeentrada,1 por millón de tokens de entrada, 5 por millón de tokens de salida. Consulta precios de Claude para más detalles.

​
Pasos de migración

  1. 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"
  2. Actualiza las versiones de herramientas (si aplica)
    Este es un cambio importante desde 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"}]
    • Editor de texto: Usa text_editor_20250728 y str_replace_based_edit_tool
    • Ejecución de código: Usa code_execution_20250825
    • Elimina cualquier código que use el comando undo_edit
  3. Actualiza los parámetros de muestreo
    Este es un cambio importante desde Claude Haiku 3.5.
    Usa solo temperature O top_p, no ambos: 
    # Antes (Haiku 3.5) - Esto dará error en Haiku 4.5
response = client.messages.create(
    model="claude-3-5-haiku-20241022",
    temperature=0.7,
    top_p=0.9,  # No se pueden 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
    ...
)
  4. 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.
  5. Maneja la nueva razón de parada refusal Actualiza tu aplicación para manejar razones de parada de rechazo.
  6. 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 prompts.
  7. Explora las nuevas capacidades Consulta Qué hay de nuevo en Claude 4.5 para detalles sobre conciencia del contexto, mayor capacidad de salida (64K tokens), mayor inteligencia y velocidad mejorada.
  8. Prueba tu implementación Prueba en un entorno de desarrollo antes de desplegar a producción para asegurar que todos los cambios importantes se manejen correctamente.

​
Lista de verificación de migración Haiku 3.5 → 4.5

  • Actualizar ID del modelo a claude-haiku-4-5-20251001
  • IMPORTANTE: Actualizar versiones de herramientas a las más recientes (ej., text_editor_20250728, code_execution_20250825) - versiones heredadas no compatibles
  • IMPORTANTE: Eliminar cualquier código que use el comando undo_edit (si aplica)
  • IMPORTANTE: Actualizar parámetros de muestreo para usar solo temperature O top_p, no ambos
  • Revisar y ajustar para nuevos límites de velocidad (separados de Haiku 3.5)
  • Manejar nueva razón de parada refusal en tu aplicación
  • Considerar habilitar pensamiento extendido para tareas de razonamiento complejas (nueva capacidad)
  • Aprovechar la conciencia del contexto para mejor gestión de tokens en sesiones largas
  • Prepararse para respuestas más grandes (salida máxima aumentada de 8K a 64K tokens)
  • Revisar y actualizar prompts siguiendo las mejores prácticas de Claude 4
  • Probar en entorno de desarrollo antes del despliegue en producción

​
Elegir entre Sonnet 4.5 y Haiku 4.5

Tanto Claude Sonnet 4.5 como Claude Haiku 4.5 son modelos Claude 4 poderosos con diferentes fortalezas:

​
Elige Claude Sonnet 4.5 (más inteligente) para:

  • Razonamiento y análisis complejos: Inteligencia de primera clase para tareas sofisticadas
  • Agentes autónomos de larga duración: Rendimiento superior para agentes que trabajan independientemente por períodos extendidos
  • Tareas avanzadas de codificación: Nuestro modelo de codificación más fuerte con planificación avanzada e ingeniería de seguridad
  • Flujos de trabajo de contexto grande: Gestión de contexto mejorada con herramienta de memoria y capacidades de edición de contexto
  • Tareas que requieren máxima capacidad: Cuando la inteligencia y precisión son las principales prioridades

​
Elige Claude Haiku 4.5 (Haiku más rápido e inteligente) para:

  • Aplicaciones en tiempo real: Tiempos de respuesta rápidos para experiencias de usuario interactivas con rendimiento casi fronterizo
  • Procesamiento inteligente de alto volumen: Inteligencia rentable a escala con velocidad mejorada
  • Despliegues sensibles al costo: Rendimiento casi fronterizo a precios más bajos
  • Arquitecturas de sub-agentes: Agentes rápidos e inteligentes para sistemas multi-agente
  • Uso de computadora a escala: Automatización rentable de escritorio y navegador autónoma
  • Tareas que requieren velocidad: Cuando la baja latencia es crítica mientras se mantiene inteligencia casi fronteriza

​
Recomendaciones de pensamiento extendido

Los modelos Claude 4, particularmente Sonnet y Haiku 4.5, muestran mejoras significativas de rendimiento cuando usan 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 prompts. Cuando se agrega contenido que no es resultado de herramientas a una conversación, los bloques de pensamiento se eliminan del caché, lo que puede aumentar los costos en conversaciones de múltiples turnos. Recomendamos habilitar el pensamiento cuando los beneficios de rendimiento superen el intercambio de almacenamiento en caché.

​
Otros escenarios de migración

Las rutas de migración principales cubiertas arriba (Sonnet 3.7 → 4.5 y Haiku 3.5 → 4.5) representan las actualizaciones más comunes. Sin embargo, puedes estar migrando de otros modelos Claude a Claude 4.5. Esta sección cubre esos escenarios.

​
Migración de Claude Sonnet 4 → Sonnet 4.5

Cambio importante: No se pueden especificar tanto temperature como top_p en la misma solicitud. Todas las demás llamadas 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"

​
Migración de Claude Opus 4.1 → Sonnet 4.5

Sin cambios importantes. Todas las llamadas 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 capacidades de razonamiento, codificación y agentes de larga duración de primera clase. Ofrece rendimiento superior comparado con Opus 4.1 para la mayoría de casos de uso.

​
¿Necesitas ayuda?