Migración a Claude 4.5

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 razonamiento de clase mundial, capacidades de codificación y agentes de larga duración
• Claude Haiku 3.5 → Claude Haiku 4.5: Nuestro modelo Haiku más rápido e inteligente con rendimiento cercano a la frontera para aplicaciones en tiempo real y procesamiento inteligente de alto volumen

Ambas migraciones implican cambios disruptivos 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 disruptivos 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.

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 clase mundial para razonamiento, codificación y agentes autónomos de larga duración. Esta migración incluye varios cambios disruptivos 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 disruptivo desde 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 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 disruptivo 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"}]

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

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 .

10. Prueba tu implementación

Prueba en un entorno de desarrollo antes de desplegar a producción para asegurar que todos los cambios disruptivos se manejen correctamente.

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

• Actualiza el ID del modelo a claude-sonnet-4-5-20250929
• DISRUPTIVO: Actualiza los parámetros de muestreo para usar solo temperature O top_p, no ambos
• Maneja la nueva razón de parada refusal en tu aplicación
• DISRUPTIVO: Actualiza la herramienta de editor de texto a text_editor_20250728 y str_replace_based_edit_tool (si aplica)
• DISRUPTIVO: Elimina cualquier código que use el comando undo_edit (si aplica)
• Actualiza la herramienta de ejecución de código a code_execution_20250825 (si aplica)
• Elimina el encabezado beta (si aplica)

Características eliminadas de Claude Sonnet 3.7

• Uso de herramientas eficiente en tokens: El encabezado beta token-efficient-tools-2025-02-19 solo funciona con Claude 3.7 Sonnet y no se admite en modelos Claude 4 (consulta el paso 6)
• Salida extendida: El encabezado beta output-128k-2025-02-19 no se admite (consulta el paso 7)

Ambos encabezados pueden incluirse en solicitudes de Claude 4 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 cercano a la frontera, 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 disruptivos que requieren actualizaciones en tu implementación.

Para una descripción general completa de las nuevas capacidades, consulta Novedades en Claude 4.5.

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 disruptivo desde Claude Haiku 3.5.

   Haiku 4.5 solo admite 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"}]

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

• Actualiza el ID del modelo a claude-haiku-4-5-20251001
• DISRUPTIVO: Actualiza las versiones de herramientas a las más recientes (por ejemplo, text_editor_20250728, code_execution_20250825) - versiones heredadas no admitidas
• DISRUPTIVO: Elimina cualquier código que use el comando undo_edit (si aplica)
• DISRUPTIVO: Actualiza los parámetros de muestreo para usar solo temperature O top_p, no ambos
• Revisa y ajusta para nuevos límites de velocidad (separados de Haiku 3.5)
• Maneja la nueva razón de parada refusal en tu aplicación
• Considera habilitar el pensamiento extendido para tareas complejas de razonamiento (nueva capacidad)

Elegir entre Sonnet 4.5 y Haiku 4.5

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

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

• Razonamiento y análisis complejos: Inteligencia de clase mundial para tareas sofisticadas
• Agentes autónomos de larga duración: Rendimiento superior para agentes que trabajan independientemente durante 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 capacidad máxima: Cuando la inteligencia y la precisión son las principales prioridades

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

• Aplicaciones en tiempo real: Tiempos de respuesta rápidos para experiencias de usuario interactivas con rendimiento cercano a la frontera
• Procesamiento inteligente de alto volumen: Inteligencia rentable a escala con velocidad mejorada
• Despliegues sensibles a costos: Rendimiento cercano a la frontera a precios más bajos
• Arquitecturas de subagenetes: Agentes rápidos e inteligentes para sistemas multiagente
• 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 cercana a la frontera

Recomendaciones de pensamiento extendido

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é.

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, es posible que estés migrando desde otros modelos Claude a Claude 4.5. Esta sección cubre esos escenarios.

Migración de Claude Sonnet 4 → Sonnet 4.5

Cambio disruptivo: No se puede especificar tanto temperature como top_p en la misma solicitud.

Todas las otras llamadas a 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 disruptivos. Todas las llamadas a 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.

Migración de Claude Opus 4.1 → Opus 4.5

Sin cambios disruptivos. Todas las llamadas a 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.

Migración entre modelos Claude 4.5

Sin cambios disruptivos. Todas las llamadas a API funcionarán sin modificación.

Simplemente actualiza tu ID de modelo.

¿Necesitas ayuda?

• Consulta nuestra documentación de API para especificaciones detalladas
• Revisa las capacidades del modelo para comparaciones de rendimiento
• Revisa las notas de lanzamiento de API para actualizaciones de API
• Contacta al soporte si encuentras problemas durante la migración