Cómo pasar Claude Code a Sonnet 5.5 (y cuándo usar Opus)
· 7 min de lectura
Para pasar Claude Code a Sonnet 5.5, actualiza a la versión 2.1.284, que ya lo pone como Sonnet por defecto en la API de Anthropic, y elígelo con el comando /model. Si programas contra la API, revisa antes los cinco cambios que rompen código, como el error 400 del tool use forzado. Quédate con Opus 5.5 para el trabajo complejo y abierto.
Claude Sonnet 5.5 salió el 28 de septiembre de 2026 y ese mismo día Claude Code publicó la versión 2.1.284, que lo pone como Sonnet por defecto en la API de Anthropic. Esta guía te lleva por los pasos para usarlo, lo que cambia si programas contra la API y cómo decidir cuándo quedarte con Opus 5.5.
Qué necesitas antes de empezar
Claude Code actualizado. Los cambios de esta guía llegan con la versión 2.1.284.
Saber dónde lo usas. No es lo mismo usar Claude Code en la terminal que tener código propio que llama a la API. La parte de cambios que rompen solo aplica a lo segundo.
Una tarea de prueba que repitas seguido. El ahorro que promete Anthropic es "hasta un 30 %" por tarea y varía mucho. Sin una tarea tuya para comparar, no vas a saber cuánto ahorras.
Paso 1: actualiza Claude Code y comprueba la versión
Actualiza Claude Code y corre `claude --version`. Tiene que decir 2.1.284 o superior.
Según el changelog, esa versión añade Claude Sonnet 5.5 (`claude-sonnet-5-5`) como el Sonnet por defecto en la API de Anthropic, con 1M de contexto y los mismos precios de Sonnet 5: 2 dólares por millón de tokens de entrada, 10 de salida y 0,20 en lecturas de caché.
Ojo: "Sonnet por defecto" aplica a la API. No des por hecho que la app lo cambió igual.
Paso 2: elige Sonnet 5.5 en tu sesión
Dentro de Claude Code, escribe `/model` y elige Sonnet 5.5. Si prefieres fijarlo al abrir la sesión, arranca con `claude --model claude-sonnet-5-5`.
Después corre tu tarea de prueba y fíjate en dos cosas: cuánto tarda y cuántos tokens gasta. Anthropic dice que Sonnet 5.5 responde más de un 30 % más rápido que Sonnet 5 y que necesita muchos menos tokens para el mismo trabajo. Compruébalo con tu tarea, no con la de ellos.
Paso 3: revisa el auto mode y el effort
La versión 2.1.284 trae dos cambios que vas a notar al abrir una sesión nueva:
El auto mode arranca por defecto en todos los planes y proveedores. Antes era solo en Pro, Max y Team; ahora llega también a Enterprise, a las API keys y a Bedrock, Vertex y Foundry. Solo aplica si no tienes un permission mode configurado: si tu settings trae `permissions.defaultMode`, ese valor sigue mandando.
Ultracode es un interruptor aparte dentro de `/effort`. Se activa con Tab o con `/effort ultracode on`, ya no fuerza el effort xhigh y se queda encendido en cualquier nivel.
Un dato para elegir el effort: según Anthropic, con effort medio (el que traen por defecto las apps de Claude) Sonnet 5.5 ya supera la mejor marca de Sonnet 5 en Terminal-Bench por menos de una décima parte del costo por tarea.
Si trabajas con varios servidores MCP, la misma versión añade `/mcp reconnect all`, que reintenta de una vez todos los que no conectaron o piden autenticación.
Paso 4: si programas contra la API, revisa los 5 cambios que rompen
Las release notes de la plataforma lo dicen sin rodeos: el código escrito para Sonnet 5 se puede romper en Sonnet 5.5 de cinco maneras. Estos son los que más vas a notar:
Tool use forzado. `tool_choice` con tipo `any` o `tool` devuelve un error 400. Si tu agente obliga a Claude a llamar una herramienta, cambia esa lógica antes de migrar.
Apagar el thinking inicial. Ya no se manda `"disabled"`: se manda `thinking: {"type": "between_tools"}`, con effort `high` o menor.
Computer use viejo. En la API de Claude y en Google Cloud ya no se acepta la herramienta `computer_20251124`.
Thinking atado a la cuenta. Los bloques de thinking que genera Sonnet 5.5 solo funcionan en la cuenta que los produjo o en una vinculada. Si otra cuenta los envía, la API los descarta antes de que el modelo los vea y la petición igual responde bien. No se cae, pero ese contexto se pierde.
Si usas claude.ai o Claude Code sin código propio contra la API, nada de esto te toca. Anthropic lo resume así: la mayoría de los desarrolladores no va a notar el cambio.
Paso 5: decide cuándo quedarte con Opus 5.5
Sonnet 5.5 no reemplaza a Opus 5.5. Anthropic escribe que Opus 5.5 sigue siendo claramente más fuerte en el trabajo complejo y abierto que requiere criterio sostenido.
Una regla práctica con los números publicados:
| Tipo de trabajo | Modelo | Por qué |
|---|---|---|
| Tareas de terminal y agentes de código que repites | Sonnet 5.5 | 70,6 % en Terminal-Bench 4.0, por encima del 66,4 % de Opus 5.5 |
| Trabajo abierto, arquitectura, decisiones con criterio | Opus 5.5 | 54,4 % en FrontierCode 1.1 contra 46,2 % de Sonnet 5.5 |
| Volumen alto con definición clara de terminado | Sonnet 5.5 | mismo precio por token y menos tokens por tarea |
Errores comunes
Decir que es más barato. El precio por token es el mismo. Lo que baja es el costo por tarea.
Migrar código de API sin probar. El error 400 del tool use forzado aparece en la primera llamada.
Contar con Haiku 5.5. Anthropic dice que llega en las próximas semanas; hoy no está.
Suponer que está en tu plan. Ninguna fuente oficial dice qué planes de Claude lo incluyen. Revisa el selector de modelo de tu cuenta.
Preguntas frecuentes
¿Cómo cambio Claude Code a Sonnet 5.5?
Actualiza Claude Code a la versión 2.1.284 o superior, comprueba con claude --version y dentro de la sesión escribe /model para elegir Sonnet 5.5. También puedes abrir la sesión con claude --model claude-sonnet-5-5. En la API de Anthropic, esa versión ya lo pone como el Sonnet por defecto.
¿Qué se rompe al pasar de Sonnet 5 a Sonnet 5.5 en la API?
Anthropic lista cinco cambios. Los más visibles: el tool use forzado con tool_choice any o tool devuelve error 400, para apagar el thinking inicial se manda between_tools en vez de disabled, la herramienta computer_20251124 ya no se acepta en la API ni en Google Cloud, y el thinking solo vale en la cuenta que lo generó.
¿Cuándo conviene usar Opus 5.5 en vez de Sonnet 5.5?
Cuando el trabajo es complejo y abierto y exige criterio sostenido, como decisiones de arquitectura. Anthropic dice que ahí Opus 5.5 sigue siendo claramente más fuerte, y en FrontierCode 1.1 saca 54,4 % contra 46,2 % de Sonnet 5.5. Para tareas de terminal repetidas, Sonnet 5.5 rinde más y gasta menos por tarea.
¿El auto mode de Claude Code es nuevo en la versión 2.1.284?
No. El auto mode por defecto existe desde agosto de 2026, pero solo en Pro, Max y Team. Lo nuevo de la 2.1.284 es que arranca por defecto en todos los planes y proveedores, incluidos Enterprise, API keys, Bedrock, Vertex y Foundry, siempre que no tengas configurado un permission mode propio.