Cómo usar Claude Sonnet 5 en Cursor

Claude Sonnet 5 se lanzó el 30 de junio de 2026 y encaja muy bien con el uso habitual de Cursor: leer archivos, editar código, ejecutar comandos y repetir el ciclo hasta verificar el cambio. Anthropic lo describe como su modelo Sonnet más “agentic” hasta la fecha, con rendimiento de uso de herramientas cercano al de Opus 4.8 a un coste menor. En esta guía verá cómo habilitar Sonnet 5 en Cursor, cuándo usar su propia clave API de Anthropic, cómo trabajar mejor con el modo agente y cuándo conviene cambiar a un modelo más grande. Para una descripción completa, lea qué es Claude Sonnet 5, y el anuncio oficial de Anthropic cubre los detalles del lanzamiento.

Prueba Apidog hoy

También verá dónde encaja Apidog: cuando Cursor y Sonnet 5 construyen una API, Apidog es donde envía solicitudes, las guarda, simula respuestas y ejecuta pruebas automatizadas contra sus endpoints.

Por qué Sonnet 5 es un buen valor predeterminado en Cursor

El agente de Cursor trabaja mediante muchos pasos pequeños: abre archivos, busca en el código base, aplica ediciones, ejecuta comandos de terminal y revisa resultados. Ese es precisamente el tipo de flujo donde Sonnet 5 destaca.

Según los benchmarks de lanzamiento reportados por Anthropic, Sonnet 5 queda a pocos puntos de Opus 4.8 en tareas agentic:

Benchmark	Sonnet 5	Opus 4.8	Sonnet 4.6
SWE-bench Pro	63.2%	69.2%	58.1%
Terminal-Bench 2.1	80.4%	82.7%	—
OSWorld-Verified	81.2%	83.4%	—

Estos son números reportados por Anthropic, no pruebas propias. Para ver la tabla completa, consulte el desglose de los puntos de referencia de Claude Sonnet 5.

El patrón es claro: con herramientas en el bucle, Sonnet 5 se sitúa cerca de Opus 4.8. En razonamiento puro, Opus se adelanta más. Como Cursor casi siempre usa herramientas —archivos, terminal, edición y búsqueda—, Sonnet 5 suele ofrecer una relación calidad-coste más equilibrada.

El precio también importa. Sonnet 5 cuesta lo mismo por token que Sonnet 4.6: $3 por millón de tokens de entrada y $15 por millón de tokens de salida a tarifa estándar. Anthropic ofrece una tarifa introductoria de $2 por millón de entrada y $10 por millón de salida hasta el 31 de agosto de 2026. Opus 4.8 cuesta $5 por millón de entrada y $25 por millón de salida. En sesiones largas de agente, la diferencia se acumula rápido.

Dos formas de usar Sonnet 5 en Cursor

Cursor admite modelos Claude directamente y también permite usar su propia clave API de Anthropic, conocido como BYOK, si quiere facturar desde su cuenta de Anthropic. Los nombres exactos del menú pueden cambiar entre versiones de Cursor, pero el flujo general es el siguiente.

Opción 1: usar el selector de modelo integrado de Cursor

Use esta opción si su plan de Cursor ya incluye modelos Claude.

1. Abra Cursor.
2. Abra el selector de modelo desde el chat, Composer o Configuración.
3. Busque Claude Sonnet 5.
4. Selecciónelo como modelo activo.
5. Ejecute una tarea pequeña para confirmar que Cursor usa el modelo seleccionado.

Por ejemplo, pruebe con una tarea acotada:

Revisa routes/orders.js y sugiere una refactorización mínima para mejorar la validación de entrada.
No edites archivos todavía. Primero muéstrame el plan.

Si Sonnet 5 aún no aparece, actualice Cursor a la última versión y vuelva a revisar el selector. Para una configuración desde cero, consulte la guía de configuración de Cursor.

Opción 2: usar su propia clave API de Anthropic

BYOK es útil si necesita control directo sobre facturación, límites vinculados a su cuenta o acceso a un modelo que su plan de Cursor no incluye.

Pasos recomendados:

1. Abra la Consola de Claude.
2. Cree una clave API desde la sección de claves de su organización.
3. En Cursor, abra Settings.
4. Busque la sección de modelos, proveedores o claves API.
5. Pegue la clave en el campo de Anthropic.
6. Guarde la configuración.
7. Seleccione Claude Sonnet 5 como modelo activo.

El ID de modelo expuesto por Anthropic es:

claude-sonnet-5

Normalmente no necesita escribir este ID en la interfaz de Cursor, pero sí lo necesitará si llama directamente a la API. La guía de la API de Claude Sonnet 5 cubre el formato de solicitud, el ID del modelo y la estructura de respuesta.

No suba su clave API al repositorio. Use variables de entorno, el llavero del sistema operativo o el gestor de secretos de su entorno.

Ejemplo:

export ANTHROPIC_API_KEY="sk-ant-..."

Y en Node.js:

const apiKey = process.env.ANTHROPIC_API_KEY;

if (!apiKey) {
  throw new Error('ANTHROPIC_API_KEY is required');
}

Qué cambió internamente y por qué importa en Cursor

Sonnet 5 es un reemplazo directo de Sonnet 4.6 a nivel de API, pero hay cambios de comportamiento que conviene tener presentes.

Pensamiento adaptativo activado por defecto

En Sonnet 4.6, una solicitud sin el campo thinking se ejecutaba sin pensamiento extendido. En Sonnet 5, esa misma solicitud usa pensamiento adaptativo por defecto.

En Cursor, esto ayuda en tareas como:

• planificar cambios en varios archivos;
• entender dependencias antes de editar;
• revisar errores de terminal;
• decidir qué pruebas ejecutar después de un cambio.

La contrapartida es que las respuestas complejas pueden tardar más y usar más tokens de salida, porque los tokens de pensamiento cuentan.

Nuevo tokenizador

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

Las formas de solicitud y respuesta son iguales, así que nada debería romperse por esto. Pero sí afecta a:

• presupuestos por token;
• tamaño efectivo de contexto;
• estimaciones de coste;
• métricas comparadas con Sonnet 4.6.

Si mide el gasto de Cursor o de su integración BYOK, vuelva a medir con Sonnet 5 en lugar de reutilizar números anteriores.

Restricciones si usa la API directamente

Si programa contra la API de Anthropic, tenga en cuenta dos restricciones:

• El pensamiento extendido manual con budget_tokens devuelve error 400.
• Establecer temperature, top_p o top_k en valores no predeterminados también devuelve error 400.

En lugar de ajustar esos parámetros, dirija el comportamiento desde el prompt. Cursor maneja esto en sus llamadas internas, así que normalmente solo lo verá si integra la API directamente.

Usando Sonnet 5 en el modo agente de Cursor

El modo agente es donde Sonnet 5 resulta más útil. Le permite al modelo leer el proyecto, proponer un plan, editar varios archivos, ejecutar comandos y verificar el resultado.

Un flujo práctico:

1. Describa el resultado esperado, no cada paso.
2. Delimite el alcance.
3. Pida un plan antes de editar.
4. Revise el diff archivo por archivo.
5. Ejecute pruebas o comandos de verificación.
6. Itere con cambios pequeños.

Ejemplo de prompt para Cursor:

Necesito agregar un endpoint POST /orders en esta app Express.

Alcance:
- Revisa solo src/routes, src/app.js y tests.
- Crea la ruta si no existe.
- Valida que customerId exista.
- Valida que items sea un array no vacío.
- Devuelve 201 con el pedido creado.
- Agrega o actualiza pruebas.

Primero muéstrame el plan. No edites archivos hasta que lo confirme.

Después de revisar el plan, puede continuar:

El plan está bien. Implementa los cambios y ejecuta las pruebas relacionadas.
Si una prueba falla, muéstrame el error antes de intentar otra corrección.

Este patrón reduce cambios innecesarios y hace que los diffs sean más fáciles de revisar.

Un ejemplo realista: construir una API y luego probarla

Supongamos que le pide a Sonnet 5 en Cursor que genere una ruta de Express para crear un pedido y devolverlo como JSON.

// routes/orders.js
const express = require('express');
const router = express.Router();

router.post('/orders', (req, res) => {
  const { customerId, items } = req.body;

  if (!customerId || !Array.isArray(items) || items.length === 0) {
    return res.status(400).json({
      error: 'customerId and items are required',
    });
  }

  const order = {
    id: `order_${Date.now()}`,
    customerId,
    items,
    status: 'created',
  };

  return res.status(201).json(order);
});

module.exports = router;

Cursor y Sonnet 5 pueden generar la ruta, conectarla a la aplicación e incluso crear pruebas. Aun así, el endpoint debe verificarse con solicitudes reales. Ahí entra Apidog.

En Apidog puede probar el endpoint así:

1. Cree una nueva solicitud.
2. Seleccione el método POST.
3. Use la ruta:

/orders

1. Configure el cuerpo JSON:

{
  "customerId": "cus_123",
  "items": [
    {
      "sku": "book_001",
      "quantity": 2
    }
  ]
}

1. Envíe la solicitud.
2. Verifique que la respuesta sea 201.
3. Confirme que la respuesta tenga esta forma:

{
  "id": "order_...",
  "customerId": "cus_123",
  "items": [
    {
      "sku": "book_001",
      "quantity": 2
    }
  ],
  "status": "created"
}

También puede agregar aserciones como:

pm.test("status is 201", function () {
  pm.response.to.have.status(201);
});

pm.test("order status is created", function () {
  const json = pm.response.json();
  pm.expect(json.status).to.eql("created");
});

pm.test("order id exists", function () {
  const json = pm.response.json();
  pm.expect(json.id).to.exist;
});

En Apidog, este flujo le permite:

• enviar una solicitud POST /orders con cuerpo JSON;
• guardar la solicitud en una colección reutilizable;
• almacenar la URL base y claves como variables de entorno;
• evitar secretos hardcodeados;
• agregar aserciones automatizadas;
• ejecutar la suite en CI;
• simular el endpoint para que el frontend avance antes de que el backend esté terminado.

Cursor y Sonnet 5 escriben código rápido. Apidog le da una forma reproducible de confirmar que la API se comporta como espera. Si está migrando desde otras herramientas, este recorrido de pruebas de API sin Postman muestra el flujo completo. También puede descargar Apidog para probarlo con sus propios endpoints.

Notas sobre coste y uso

Cursor gestiona su propia facturación, límites y acceso a modelos. Esos detalles cambian, así que revise el plan actual directamente en Cursor.

Aun así, estos principios se mantienen:

• Sonnet 5 es más barato de ejecutar que Opus 4.8.
• Para codificación diaria, Sonnet 5 es un valor predeterminado razonable.
• El pensamiento adaptativo puede aumentar el coste en prompts difíciles.
• Los tokens de pensamiento cuentan como salida.
• El nuevo tokenizador puede hacer que el mismo código use más tokens que en Sonnet 4.6.
• Con BYOK, la factura de Anthropic refleja el uso real según sus tarifas.
• Mida cargas de trabajo reales en vez de asumir paridad con Sonnet 4.6.

Para comparar opciones dentro de Cursor, consulte la guía sobre el mejor modelo de Cursor.

Cuándo cambiar de modelo

Use Sonnet 5 como predeterminado para:

• implementar features;
• refactorizar código;
• escribir pruebas;
• ejecutar correcciones iterativas;
• trabajar con modo agente;
• revisar errores de terminal;
• generar endpoints y validaciones.

Cambie a Opus 4.8 cuando la tarea requiera razonamiento más profundo, por ejemplo:

• decisiones arquitectónicas complejas;
• depuración sutil;
• análisis de varios sistemas interdependientes;
• ejecuciones autónomas largas;
• situaciones donde la calidad importe más que el coste.

En razonamiento puro sin herramientas, Opus 4.8 supera a Sonnet 5 por unos seis puntos en los benchmarks reportados. Ese margen puede justificar el coste adicional en tareas difíciles.

Para el resto del trabajo diario en Cursor, Sonnet 5 ofrece rendimiento agentic cercano a Opus con un coste menor. Manténgalo como predeterminado y cambie a Opus solo cuando la tarea realmente lo necesite.

Preguntas frecuentes

¿Está Claude Sonnet 5 disponible en Cursor?

Cursor admite modelos Claude de Anthropic, y Sonnet 5 debería aparecer en el selector de modelos cuando su versión de Cursor lo soporte. Si no aparece, actualice Cursor. También puede usarlo con su propia clave API de Anthropic.

¿Necesito mi propia clave API para usar Sonnet 5 en Cursor?

No siempre. Si su plan de Cursor incluye modelos Claude, puede seleccionar Sonnet 5 sin clave propia. Use BYOK si quiere facturar desde su cuenta de Anthropic o necesita control directo sobre límites. La guía de la API de Claude Sonnet 5 explica cómo crear y usar una clave.

¿Es mejor Sonnet 5 u Opus 4.8 para codificar en Cursor?

Para la mayoría del trabajo en Cursor, Sonnet 5 es la mejor opción por relación rendimiento-coste. Se acerca a Opus 4.8 en codificación agentic, pero cuesta menos. Use Opus 4.8 para tareas de razonamiento más difíciles. La comparación Sonnet 5 vs Opus 4.8 desglosa la diferencia.

¿Por qué Sonnet 5 parece usar más tokens que Sonnet 4.6?

Sonnet 5 usa un nuevo tokenizador que produce aproximadamente un 30% más de tokens para el mismo texto. El precio por token no cambió respecto a Sonnet 4.6, pero solicitudes equivalentes pueden costar más. Mida sus cargas reales.

¿Puedo usar Sonnet 5 en Cursor gratis?

Depende del plan de Cursor. Sonnet 5 es el modelo predeterminado en el plan web y de aplicación gratuito de Claude, pero eso es independiente de Cursor. Consulte los detalles actuales del plan de Cursor para confirmar qué modelos incluye.