Cambia de Sonnet 4.5 a 5.5 sin romper nada

Las fechas

¿Te afecta?

¿Usas Amazon Bedrock o Google Cloud? Ponen sus propias fechas de retirada, que pueden ser distintas. Mira la tabla de modelos de tu plataforma.

Paso a paso

1. Descubre si lo estás usandoEn la Claude Console, entra en Usage y pulsa Export. El archivo CSV muestra el uso por clave de API y por modelo.
2. Busca el nombre del modelo en tu código y tus automatizacionesBusca este texto. Encuentra también la versión con fecha (claude-sonnet-4-5-20250929).

   claude-sonnet-4-5

   Copiar

   Mira también en archivos de configuración, variables de entorno y herramientas como n8n o Make donde hayas elegido el modelo a mano.
3. Cámbialo por el nuevoEl nombre nuevo no lleva fecha:

   claude-sonnet-5-5

   Copiar
4. O deja que Claude Code lo haga por tiEs el ejemplo de la guía oficial. Antes de tocar nada, te pregunta qué archivos o carpetas incluir. Cambia el modelo, ajusta lo que daría error y te deja una lista de cosas para comprobar a mano.

   /claude-api migrate this project to claude-sonnet-5-5

   Copiar
5. Revisa la lista de abajo y prueba antes del 30 de noviembreCambiar el nombre no siempre basta: varias opciones que Sonnet 4.5 aceptaba dan error en Sonnet 5.5.

Checklist: lo que da error al pasar de 4.5 a 5.5

Todo esto devuelve un error 400 en Sonnet 5.5. Marca cada punto cuando lo hayas revisado (las marcas no se guardan).

• Respuestas «pre-rellenadas» (el último mensaje de la conversación es del asistente)Ya no se acepta. Para forzar un formato, usa salidas estructuradas; para el resto, pon la instrucción en el prompt o en el mensaje del usuario.
• temperature, top_p o top_k con valores distintos a los de por defectoQuítalos.
• Pensamiento con presupuesto ("type": "enabled" con budget_tokens)Quítalo y elige un nivel de esfuerzo en output_config.effort.
• Pensamiento desactivado ("type": "disabled")Para que no piense antes de responder, usa "type": "between_tools" (con esfuerzo high o menos).
• Obligar a usar una herramienta (tool_choice de tipo any o tool)Usa auto, marca la herramienta con strict: true y di en el prompt cuándo usarla.
• output_formatPásalo a output_config.format.
• Cabeceras beta antiguasQuita la de ventana de contexto y interleaved-thinking-2025-05-14. Cambia fine-grained-tool-streaming-2025-05-14 por eager_input_streaming: true en cada herramienta.
• Uso del ordenador con computer_20250124Sonnet 5.5 no lo acepta. Mira la tabla de la guía oficial de migración.

Qué probar antes de la fecha

1. Que tu código lee bien la respuestaSonnet 5.5 piensa por defecto, así que la respuesta puede empezar con un bloque de pensamiento. Si tu código lee siempre el primer bloque como texto (content[0].text), se rompe: busca el bloque por su tipo. En bucles con herramientas, devuelve los bloques de pensamiento tal cual.
2. Que las respuestas no se cortanEl pensamiento cuenta dentro de max_tokens. Si lo tenías justo, súbelo.
3. El nivel de esfuerzoSonnet 4.5 no tenía este ajuste. Fíjalo tú en output_config.effort. Por defecto es high. Para agentes y tareas con herramientas, Anthropic recomienda empezar en medium; para chat y lo que necesite rapidez, medium o low.
4. El coste realEl mismo texto ocupa unos 30 % más tokens en Sonnet 5.5, y una imagen grande puede gastar unas 2,5 veces los tokens de antes. Además, el pensamiento se cobra como salida. Mide con tus peticiones reales antes de dar el coste por bueno.
5. Tus promptsLo que escribiste para modelos antiguos puede sobrar. Pásale /claude-api prompt-audit en Claude Code (tienes la guía en Limpia tus prompts).

Precio: más barato por token

Precios oficiales de la API de Claude. Ojo: el token es más barato, pero se usan más tokens (unos 30 % más para el mismo texto, más el pensamiento). Lo que pagues al final depende de tu uso.