DEV Community

Cover image for Cómo usar Claude Sonnet 5 en Claude Code
Roobia
Roobia

Posted on • Originally published at apidog.com

Cómo usar Claude Sonnet 5 en Claude Code

Claude Sonnet 5 se lanzó el 30 de junio de 2026 y es uno de los valores predeterminados más potentes que puedes usar en Claude Code. Anthropic lo describe como “el modelo Sonnet más agéntico hasta la fecha”, y sus benchmarks de lanzamiento lo sitúan cerca de Opus 4.8 en tareas de uso de herramientas y codificación agéntica, pero a un coste menor.

Prueba Apidog hoy

En esta guía verás cómo seleccionar Sonnet 5 en Claude Code, qué cambia en su comportamiento, cómo usarlo en un flujo de trabajo realista y cuándo conviene cambiar a Opus 4.8. También verás cómo combinarlo con Apidog para construir una API y probar endpoints reales en lugar de confiar en suposiciones del modelo.

¿Por qué Sonnet 5 es una buena opción predeterminada para Claude Code?

Claude Code es una herramienta de codificación agéntica. El modelo no solo responde una vez: planifica, ejecuta comandos, lee salidas, edita archivos y repite el ciclo.

Ese flujo favorece a modelos que usan bien herramientas externas. Sonnet 5 está optimizado precisamente para ese patrón.

Benchmark de Claude Sonnet 5

Estos son los benchmarks de lanzamiento reportados por Anthropic. Tómalos como cifras reportadas, no como pruebas propias.

Punto de referencia Sonnet 5 Opus 4.8 Sonnet 4.6
SWE-bench Pro (codificación agéntica) 63.2% 69.2% 58.1%
Terminal-Bench 2.1 80.4% 82.7% n/a
OSWorld-Verified (uso de computadora) 81.2% 83.4% 78.5%

El patrón importante es este:

  • En tareas con herramientas en el bucle, Sonnet 5 queda a 1–3 puntos de Opus 4.8.
  • En razonamiento puro, Opus mantiene una ventaja más clara.
  • Claude Code trabaja casi siempre con herramientas: archivos, terminal, tests y edición incremental.

Por eso Sonnet 5 suele ser el modelo predeterminado más eficiente para sesiones largas de codificación.

En precios estándar, Sonnet 5 cuesta $3 por millón de tokens de entrada y $15 por millón de tokens de salida. Hasta el 31 de agosto de 2026 tiene una tarifa introductoria de $2 de entrada y $10 de salida. Opus 4.8 cuesta $5 de entrada y $25 de salida.

Si vas a usar Claude Code durante varias horas al día, esa diferencia importa. Puedes revisar los números completos en el desglose de precios de Claude Sonnet 5.

Seleccionar Sonnet 5 en Claude Code

Dentro de una sesión de Claude Code, abre el selector de modelos:

/model
Enter fullscreen mode Exit fullscreen mode

Elige Claude Sonnet 5 en la lista.

También puedes establecerlo directamente:

/model claude-sonnet-5
Enter fullscreen mode Exit fullscreen mode

Usa exactamente este ID:

claude-sonnet-5
Enter fullscreen mode Exit fullscreen mode

Ese es el ID del modelo API, sin sufijo de fecha. Si estás automatizando Claude Code o configurando un valor predeterminado para tu proyecto, usa esa cadena.

Sonnet 5 está disponible en Claude Code desde su lanzamiento. También es el modelo predeterminado en las aplicaciones gratuitas y Pro de Claude, y está disponible para Max, Team y Enterprise.

Para más contexto, consulta la guía de Claude Code y la referencia de comandos CLI de Claude Code.

Qué cambia en el comportamiento del modelo

Sonnet 5 es una actualización directa de Sonnet 4.6, pero hay cambios que notarás al trabajar en Claude Code.

El pensamiento adaptativo está activado por defecto

En Sonnet 4.6, una solicitud sin el campo thinking se ejecutaba sin pensamiento extendido.

En Sonnet 5, el pensamiento adaptativo está activado por defecto. El modelo decide cuánto razonar según la tarea:

  • Cambio de nombre simple: poco razonamiento.
  • Refactorización en varios archivos: más deliberación.
  • Depuración con fallos de tests: análisis más profundo.

En Claude Code no tienes que configurar esto manualmente como en una llamada API cruda. Claude Code gestiona la solicitud por ti.

Lo que verás en la práctica:

  1. El modelo se mueve rápido en tareas simples.
  2. Se detiene más en pasos complejos.
  3. Usa más razonamiento cuando el contexto lo exige.

La documentación de pensamiento adaptativo de Anthropic explica el mecanismo en detalle.

Sonnet 5 también admite un parámetro de esfuerzo con cuatro niveles:

  • bajo
  • medio
  • alto
  • muy alto (xhigh)

Úsalo cuando una tarea realmente necesite más deliberación. Más esfuerzo puede ayudar en problemas difíciles, pero también consume más tokens.

Desaparecen el pensamiento extendido manual y los parámetros de muestreo

Si tienes scripts personalizados alrededor de Claude, revisa estos cambios:

{
  "thinking": {
    "type": "enabled",
    "budget_tokens": 10000
  }
}
Enter fullscreen mode Exit fullscreen mode

Ese patrón de pensamiento extendido manual ahora devuelve un error 400.

En Sonnet 5 debes usar:

  • pensamiento adaptativo
  • parámetro de esfuerzo

También devuelven 400 los valores no predeterminados para:

  • temperature
  • top_p
  • top_k

En lugar de controlar el comportamiento con muestreo, usa:

  • prompts más precisos
  • instrucciones de sistema
  • contexto mejor delimitado
  • pruebas automatizadas

Claude Code ya gestiona esto por ti, pero cualquier integración escrita para Sonnet 4.6 necesita revisión. La lista completa está en la comparación de Sonnet 5 vs Sonnet 4.6.

El nuevo tokenizador afecta contexto y coste

Sonnet 5 usa un nuevo tokenizador. El mismo texto produce aproximadamente un 30% más de tokens que en Sonnet 4.6, alrededor de 1.3x.

Nada se rompe en tus solicitudes o respuestas, pero sí cambian dos cosas:

  1. La ventana de contexto de 1,000,000 de tokens contiene menos texto real.
  2. El coste de una solicitud equivalente puede ser mayor.

No reutilices estimaciones de tokens hechas para Sonnet 4.6. Si estás presupuestando una carga de trabajo, vuelve a contar con el endpoint de conteo de tokens de Anthropic.

Flujo de trabajo práctico con Claude Code y Sonnet 5

Sonnet 5 funciona mejor cuando lo dejas planificar antes de editar.

Un flujo recomendado:

  1. Describe la tarea a alto nivel.
  2. Pídele que lea los archivos relevantes.
  3. Exige un plan antes de permitir cambios.
  4. Revisa el plan.
  5. Corrige supuestos incorrectos.
  6. Deja que implemente.
  7. Haz que ejecute pruebas.
  8. Si fallan, deja que lea la salida e itere.

Ejemplo de prompt inicial:

Quiero refactorizar el flujo de autenticación para separar la lógica de validación del controlador.

Antes de editar archivos:
1. Lee los archivos relevantes.
2. Identifica dependencias y posibles riesgos.
3. Propón un plan paso a paso.
4. Espera mi confirmación antes de modificar código.
Enter fullscreen mode Exit fullscreen mode

Después de aprobar el plan:

Implementa el plan aprobado. Ejecuta los tests relacionados después de cada cambio importante. Si un test falla, lee la salida y corrige la causa raíz.
Enter fullscreen mode Exit fullscreen mode

Este patrón reduce ediciones innecesarias y hace que el modelo use mejor el contexto.

Aunque Sonnet 5 tiene una ventana grande, no conviene cargar todo el repositorio en cada turno. Dale rutas concretas:

Empieza revisando estos archivos:

- src/auth/controller.ts
- src/auth/service.ts
- src/auth/validators.ts
- tests/auth/signup.test.ts
Enter fullscreen mode Exit fullscreen mode

Luego deja que el modelo pida más contexto si lo necesita.

Construye una API y deja que Sonnet 5 la pruebe

Supón que estás construyendo una API REST con Claude Code.

El modelo puede crear rutas, controladores y tests, pero necesita validar el comportamiento contra un contrato real. Ahí es donde Apidog encaja en el flujo.

Un flujo práctico:

  1. Diseña la API en Apidog.
  2. Define endpoints, parámetros, cuerpos de solicitud y respuestas.
  3. Usa mocks para que frontend y tests puedan avanzar antes de terminar el backend.
  4. Expón la especificación al modelo mediante el servidor MCP de Apidog.
  5. Haz que Sonnet 5 implemente contra ese contrato.
  6. Ejecuta pruebas reales contra el endpoint.

Ejemplo de ejecución desde Claude Code:

# Sonnet 5 implementa el endpoint.
# Luego ejecuta la suite de pruebas de Apidog:
apidog run --access-token $APIDOG_TOKEN \
  --project-id $PROJECT_ID \
  --test-scenario "user-signup-flow"
Enter fullscreen mode Exit fullscreen mode

Cuando una prueba falla, el ciclo debe ser:

  1. Claude Code lee la salida.
  2. Identifica la aserción fallida.
  3. Revisa el handler o esquema relevante.
  4. Corrige la implementación.
  5. Vuelve a ejecutar la prueba.

Ejemplo de instrucción:

Ejecuta el escenario user-signup-flow con Apidog. Si falla, no cambies el contrato. Lee la salida, identifica qué parte de la implementación no cumple la especificación y corrige el código.
Enter fullscreen mode Exit fullscreen mode

Así evitas que el modelo “imagine” la API. El contrato vive en Apidog; Sonnet 5 escribe el código para cumplirlo.

Puedes descargar Apidog para configurar el proyecto localmente.

Cuándo cambiar a Opus 4.8

Sonnet 5 es una buena opción predeterminada para la mayoría de sesiones de Claude Code. Pero Opus 4.8 puede justificar su coste en tareas específicas.

Cambia a Opus 4.8 cuando:

  • La tarea sea principalmente razonamiento difícil, no uso de herramientas.
  • Estés diseñando lógica algorítmica compleja.
  • El cambio sea crítico y la calidad pese más que el coste.
  • Estés ejecutando trabajo autónomo largo donde pequeños errores pueden acumularse.

Quédate con Sonnet 5 cuando:

  • Estés leyendo archivos, editando, ejecutando comandos y probando.
  • El volumen de trabajo sea alto.
  • Necesites iterar rápido.
  • El coste sea un factor importante.

Cambiar de modelo es inmediato:

/model claude-opus-4-8
Enter fullscreen mode Exit fullscreen mode

Para volver a Sonnet 5:

/model claude-sonnet-5
Enter fullscreen mode Exit fullscreen mode

No necesitas comprometerte con un solo modelo durante toda la sesión. Usa Opus para el tramo difícil y vuelve a Sonnet para el trabajo agéntico estándar.

Para más detalle, lee la comparación de Sonnet 5 vs Opus 4.8. Si ya usaste Sonnet 4.5 en Claude Code o Fable 5 en Claude Code, el flujo te resultará familiar.

Consejos prácticos

  • Pide un plan antes de editar. Para cualquier tarea no trivial, obliga al modelo a leer, resumir y proponer un plan.
  • Delimita el contexto. Pasa archivos concretos en lugar de cargar todo el repositorio.
  • Ejecuta tests pronto. No esperes al final de una refactorización grande.
  • Usa contratos reales para APIs. Haz que Sonnet 5 implemente contra especificaciones y pruebas de Apidog.
  • Controla el coste. Sonnet 5 es más barato que Opus, pero una sesión larga sigue acumulando tokens.
  • No uses configuraciones antiguas de Sonnet 4.6 sin revisar. El pensamiento manual y los parámetros de muestreo no funcionan igual.
  • Sube el esfuerzo solo cuando haga falta. Para tareas simples, el pensamiento adaptativo suele ser suficiente.

Preguntas frecuentes

¿Está Claude Sonnet 5 disponible en Claude Code?

Sí. Sonnet 5 está disponible en Claude Code desde su lanzamiento el 30 de junio de 2026.

Puedes seleccionarlo con:

/model
Enter fullscreen mode Exit fullscreen mode

O directamente con:

/model claude-sonnet-5
Enter fullscreen mode Exit fullscreen mode

¿Necesito cambiar mi configuración para el pensamiento adaptativo?

No en Claude Code. Sonnet 5 tiene pensamiento adaptativo activado por defecto y Claude Code gestiona la solicitud.

El modelo decide cuánto razonar según la tarea. Esto cambia respecto a Sonnet 4.6, donde una solicitud sin campo de pensamiento se ejecutaba sin pensar. Consulta la comparación de Sonnet 5 vs Sonnet 4.6 para ver más cambios.

¿Sonnet 5 es suficiente para codificar o debería usar Opus 4.8?

Para la mayoría de codificación agéntica en Claude Code, Sonnet 5 es una opción predeterminada sólida.

Según los benchmarks de lanzamiento de Anthropic, queda cerca de Opus 4.8 en tareas de uso de herramientas como SWE-bench Pro y Terminal-Bench, a menor precio.

Usa Opus 4.8 para problemas de razonamiento puro más difíciles o trabajo autónomo de largo plazo.

¿Puedo usar Sonnet 5 en Claude Code gratis?

Sonnet 5 es el modelo predeterminado en las aplicaciones gratuitas y Pro de Claude, y está disponible en Claude Code.

El uso gratuito tiene límites de tasa y uso. Puedes revisar opciones y límites en la guía gratuita de Claude Sonnet 5.

¿Cómo afecta el nuevo tokenizador a mis sesiones de Claude Code?

El mismo texto produce aproximadamente un 30% más de tokens que en Sonnet 4.6.

Nada se rompe, pero:

  • la ventana de contexto de 1M contiene menos texto real;
  • el coste de texto equivalente puede subir;
  • tus estimaciones antiguas de tokens pueden quedar desactualizadas.

Vuelve a contar tokens con Sonnet 5 si estás presupuestando uso intensivo.

Top comments (0)