Para usar Claude Sonnet 5.5 en Claude Code, actualice a la v2.1.284 o posterior, luego inicie con claude --model claude-sonnet-5-5 o selecciónelo con /model. Necesita un plan de pago de Claude (Pro, Max, Team o Enterprise) o una clave API de Anthropic; el plan Gratuito no incluye Claude Code. El modelo predeterminado sigue siendo Opus 5.5 en todos ellos, por lo que Sonnet 5.5 solo se ejecuta cuando lo selecciona. A las tarifas de API cuesta la mitad: $2/$10 por millón de tokens de entrada/salida frente a $4/$20 para Opus 5.5.
A continuación: configuración, la trampa del alias sonnet, esfuerzo, hábitos a dirigir, costo y cuándo Opus 5.5 sigue ganando. Para el modelo en sí, vea qué es Claude Sonnet 5.5. Si su código llama a APIs, Apidog contiene los escenarios de prueba que Claude Code puede ejecutar contra sus cambios.
Claude Sonnet 5.5 en Claude Code de un vistazo
| Configuración | Sonnet 5.5 |
|---|---|
| Versión mínima | v2.1.284 |
| Planes | Pro, Max, Team, Enterprise, clave API; no Gratuito |
| Modelo predeterminado | Opus 5.5, así que seleccione Sonnet 5.5 usted mismo |
Alias sonnet |
Sonnet 5.5 solo en la API de Anthropic |
| Contexto | 1M nativo |
| Esfuerzo predeterminado | medium; el pensamiento no se puede desactivar |
| Modo rápido | No disponible |
Fuentes: la documentación de configuración del modelo de Claude Code y el artículo de lanzamiento de Anthropic.
Paso 1: actualice Claude Code y verifique su plan
Sonnet 5.5 llegó a Claude Code v2.1.284 el 28 de septiembre de 2026, y las compilaciones anteriores no pueden ejecutarlo:
claude update
Según claude.com/pricing, Pro cuesta $17 al mes facturados anualmente o $20 mensuales, y Max comienza en $100. Los usuarios gratuitos pueden chatear con Sonnet 5.5 en Claude.ai, pero no en Claude Code; nuestra guía de acceso gratuito cubre lo que funciona.
Paso 2: cambie el modelo a Sonnet 5.5
claude --model claude-sonnet-5-5
Dentro de una sesión, /model claude-sonnet-5-5 lo cambia y lo guarda como su predeterminado. Ejecute /model solo para abrir el selector, donde s cambia solo para esta sesión. ANTHROPIC_MODEL o una clave "model" en un archivo de configuración también funcionan, y /status muestra lo que está activo. Un cambio de /model también afecta a los subagentes que heredan el modelo principal, y una sesión reanudada mantiene el modelo con el que se guardó. Si fijó claude-sonnet-5 para nuestra guía de Claude Code para Sonnet 5, actualícelo: un ID completo no se mueve cuando lo hace el alias.
El alias sonnet no significa Sonnet 5.5 en todas partes
sonnet apunta a Sonnet 5.5 solo en la API de Anthropic:
| Proveedor | sonnet se resuelve a |
|---|---|
| API de Anthropic | Sonnet 5.5 |
| Plataforma Claude en AWS | Sonnet 4.6 |
| Amazon Bedrock, Plataforma de Agentes de Google Cloud | Sonnet 4.5 |
| Microsoft Foundry | Sonnet 4.5 |
En un proveedor de la nube, establezca ANTHROPIC_DEFAULT_SONNET_MODEL al ID de Sonnet 5.5 de su proveedor: claude-sonnet-5-5 en Google Cloud y Claude Platform en AWS, su nombre de implementación en Foundry, su perfil de inferencia en Bedrock. La misma variable establece el modelo con el que se ejecuta opusplan.
Omita sonnet[1m]: la documentación dice que no tiene efecto una vez que sonnet es Sonnet 5.5, cuya ventana de 1M es nativa.
Paso 3: elija un nivel de esfuerzo (el pensamiento permanece activo)
Sonnet 5.5 comienza en medium en Claude Code, un nivel por debajo de su valor predeterminado high en la API de la Plataforma Claude. Los niveles son low, medium, high, xhigh, max:
claude --model claude-sonnet-5-5 --effort high
En una sesión, /effort high guarda un nivel para el modelo actual, /effort abre un deslizador y /effort auto lo borra. CLAUDE_CODE_EFFORT_LEVEL lo establece desde el entorno. Cambiar el esfuerzo a mitad de la conversación puede invalidar la caché de prompts, por lo que Claude Code puede advertirle primero.
Aquí no se puede desactivar el pensamiento. El interruptor Option+T (Alt+T), alwaysThinkingEnabled y MAX_THINKING_TOKENS=0 no tienen efecto en Sonnet 5.5. La guía de prompts de Anthropic añade que desde medium en adelante, piensa antes de casi cada respuesta, y pedirle que “piense menos” no funciona de manera fiable. En su lugar, reduzca el esfuerzo o añada ultrathink a un prompt para un turno más profundo.
Lo que cada nivel ofrece en CursorBench
Cursor midió estas puntuaciones de CursorBench 4.0 en su propio arnés; los costos por tarea provienen de los gráficos de lanzamiento de Anthropic.
| Esfuerzo | Sonnet 5.5 | Opus 5.5 |
|---|---|---|
low |
35.8% a $0.50 | 43.7% a $1.17 |
medium |
39.2% a $0.70 | 52.5% a $2.91 |
high |
47.8% a $1.67 | 56.0% a $3.97 |
xhigh |
53.1% a $3.88 | 56.0% a $6.98 |
max |
55.5% a $9.67 | 57.8% a $13.43 |
De low a high, Sonnet 5.5 cuesta menos de la mitad que Opus 5.5 al mismo nivel. Sin embargo, mire a través de los niveles: Opus 5.5 en medium ($2.91) supera a Sonnet en high y se acerca a un punto de Sonnet en xhigh, que cuesta $3.88. Si está llevando Sonnet 5.5 a xhigh o max, pruebe Opus 5.5 en medium primero.
Dirija los hábitos que aparecen en una sesión de codificación
La guía de prompts de Sonnet 5.5 de Anthropic señala comportamientos importantes en Claude Code:
- Revisa temprano en
lowymediumen tareas agenciales largas. - Añade pruebas, documentación y archivos pequeños que no solicitó, en cada nivel de esfuerzo.
- En
xhighymaxinicia rondas de revisión adicionales o subagentes revisores. Anthropic lo vincula a una puntuación de FrontierCode más baja enmax(46.2%) que enxhigh(52.1%). - En
lowpuede omitir la verificación e informar que el código está listo sin ejecutar pruebas.
La guía contiene párrafos de prompts sugeridos por Anthropic; uno redujo el costo de la sesión en aproximadamente un tercio en max en las pruebas de Anthropic. Aquí hay un conjunto más corto con nuestras propias palabras para adaptar a su CLAUDE.md:
## Cómo trabajar en este repositorio
- Siga trabajando hasta que la tarea esté terminada. Deténgase a preguntar solo si está bloqueado o a punto de eliminar datos.
- Cambie solo lo que la tarea necesite. No añada nuevas pruebas, documentos o archivos a menos que se lo pida.
- Antes de decir que una tarea está terminada, ejecute las pruebas relevantes y muestre el comando y el resultado.
- No inicie subagentes revisores a menos que le pida una revisión.
Modo rápido, opusplan y mezcla de modelos
El modo rápido es solo para Opus: Opus 5.5, Opus 5 y Opus 4.8, según la documentación del modo rápido. Ejecutar /fast en Sonnet 5.5 cambia la sesión a Opus. La velocidad de Sonnet proviene del modelo, que Anthropic dice que se ejecuta "un 30% más rápido" que Sonnet 5.
claude --model opusplan usa Opus en modo de planificación y Sonnet para la ejecución. Se adapta a trabajos donde el diseño es difícil y las ediciones son rutinarias. Kevin Ngo de Creator, citado en la página de lanzamiento de Anthropic, dijo que dejaría que Sonnet 5.5 construyera una arquitectura de juego que Opus 5.5 estableció. También puede mantener Opus como modelo principal y establecer CLAUDE_CODE_SUBAGENT_MODEL=claude-sonnet-5-5 para los subagentes. Nuestra guía de flujos de trabajo de Claude Code tiene más patrones.
Cuándo mantener Opus 5.5
Anthropic dice que Opus 5.5 “sigue siendo claramente más fuerte en trabajos complejos y de final abierto”, siendo Sonnet 5.5 el mejor en tareas bien definidas y corrección de errores. La tarjeta del sistema (gestionada por Anthropic) está de acuerdo: SWE-Bench Pro 81.3 vs 89.9 con esfuerzo máximo, y ProgramBench, una prueba de contexto largo, 79.7 vs 91.2.
Conserve Opus 5.5 para errores ambiguos, decisiones de arquitectura, sesiones con bases de código grandes y modo rápido. Elija Sonnet 5.5 para correcciones específicas, características especificadas, pruebas, documentación y trabajos de subagentes. Sonnet sí lidera en Terminal-Bench 4.0 (70.6% en max vs 66.4% en xhigh), pero Anthropic lo ejecutó, y el retroceso afectó al 10% de los intentos de Opus frente al 1.5% de Sonnet. Detalles: Sonnet 5.5 vs Opus 5.5.
Lo que cuesta en una sesión
Con una clave API, Claude Code factura el precio de lista: $2/$10 por MTok para Sonnet 5.5, $4/$20 para Opus 5.5, $0.20 por lecturas de caché en ambos. Anthropic también afirma “hasta un 30% menos por tarea” que Sonnet 5.
En Pro, Max, Team o Enterprise, las sesiones utilizan los límites de uso de su plan, y /usage muestra su situación. No encontramos una cifra publicada sobre cómo se compara cada modelo con esos límites, así que mídelo en sus propias tareas.
Observe max: Simon Willison informó en Hacker News que su prueba de pelícano en max consumió 128,000 tokens de pensamiento en unos 15 minutos y se agotó antes de producir el SVG. Más información: Precios de Sonnet 5.5.
Migrar un proyecto de API desde Claude Code
Si su aplicación llama a Sonnet 5 a través de la API, Claude Code puede migrarla:
/claude-api migrate this project to claude-sonnet-5-5
Espere cambios importantes reales: thinking: {"type": "disabled"} devuelve un 400 y se convierte en between_tools, el tool_choice forzado da paso a auto más herramientas strict: true, y temperature, top_p o top_k no predeterminados devuelven un 400. Sonnet 5.5 vs Sonnet 5 cubre cada corrección.
Luego, pruebe contra la API en vivo. Guarde la solicitud antigua y la nueva como un par en Apidog, mantenga ANTHROPIC_API_KEY en una variable de entorno y aserte en stop_reason y usage, para que un rechazo o un salto en los tokens de salida aparezca como una prueba fallida.
Ejecute sus pruebas de API con la CLI de Apidog
Dado que Sonnet 5.5 en low puede omitir las pruebas, déle una prueba para ejecutar. La CLI de Apidog ejecuta sus escenarios de prueba de Apidog guardados desde la terminal, para que Claude Code pueda iniciar una ejecución, leer los resultados, arreglar el manejador y volver a ejecutar. Añada una regla a CLAUDE.md:
- Después de cambiar un endpoint de API, ejecute su escenario de prueba de Apidog con la CLI de Apidog e informe los recuentos de aprobados y fallidos.
La configuración está en CLI de Apidog en Claude Code, y la versión de Copilot está en CLI de Apidog en GitHub Copilot. Descargue Apidog para construir los escenarios.
Sonnet 5.5 en GitHub Copilot y Cursor
GitHub Copilot. Según el registro de cambios de GitHub, Sonnet 5.5 se lanzó a disponibilidad general el 28 de septiembre para Copilot Pro, Pro+, Max, Business y Enterprise, facturado a precios de lista del proveedor. Está en VS Code, JetBrains, Copilot CLI, el agente de codificación y más, con un despliegue gradual. Copilot Free y Student no lo obtienen; esos planes están limitados a la selección automática de modelos, que no incluye Sonnet 5.5.
Cursor. La página de modelos de Cursor lista claude-sonnet-5-5 con un contexto predeterminado de 200k y un máximo de 1M, facturado desde el pool de Otros Modelos en Pro y superiores a las mismas tarifas de $2/$10. Los endpoints solo para EE. UU. cuestan un 10% más. Cursor aún no ha publicado una entrada de registro de cambios al respecto.
Preguntas frecuentes
¿Es Sonnet 5.5 el modelo predeterminado en Claude Code? No. default es Opus 5.5 en Pro, Max, Team, Enterprise y la API de Anthropic. Seleccione Sonnet 5.5 con --model o /model.
¿Puedo usarlo en Claude Code con el plan Gratuito? No, Claude Code es solo de pago. Los usuarios gratuitos pueden chatear con él en Claude.ai; vea cómo usar Sonnet 5.5 gratis.
¿Por qué /model sonnet me da un modelo más antiguo? Está en un proveedor de la nube (Bedrock, Google Cloud, Foundry, Claude Platform en AWS) o en una versión anterior a la v2.1.284. Fije el ID completo.
¿Cuánto más barato es que Opus 5.5? La mitad a los precios de lista de la API. Vea el desglose de precios.
Su próximo paso
Ejecute claude update, inicie su próxima tarea específica con claude --model claude-sonnet-5-5, y deje el esfuerzo en medium durante unos días. Añada las reglas de CLAUDE.md, envíe el trabajo con mucho diseño a través de opusplan, y mantenga Opus 5.5 a un /model de distancia. Si el trabajo involucra APIs, integre la CLI de Apidog para que cada “terminado” tenga una ejecución de prueba detrás. Apidog es gratis para empezar.