Cómo usar Claude Sonnet 5 en Cursor

Claude Sonnet 5 se lanzó el 30 de junio de 2026, y se ajusta muy bien a la forma en que la mayoría de la gente usa Cursor. Anthropic lo llama su modelo Sonnet más "agentic" hasta la fecha, con un rendimiento de uso de herramientas cercano al de Opus 4.8 a un precio mucho más bajo. Esto es importante en Cursor, donde el modelo pasa la mayor parte de su tiempo leyendo archivos, editando código y ejecutando comandos en un bucle. Esta guía le muestra cómo habilitar Sonnet 5 en Cursor, cuándo usar su propia clave API de Anthropic, cómo aprovechar al máximo el modo agente y cuándo cambiar a un modelo más grande. Para obtener una descripción completa del modelo, lea qué es Claude Sonnet 5, y el anuncio oficial de Anthropic cubre los detalles del lanzamiento.

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

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

El agente de Cursor realiza muchos pasos pequeños y guiados por herramientas. Abre archivos, aplica ediciones, busca en el código base y ejecuta comandos de terminal. Ese es exactamente el tipo de trabajo en el que Sonnet 5 destaca.

Los puntos de referencia de lanzamiento de Anthropic sitúan a Sonnet 5 a pocos puntos de Opus 4.8 en tareas "agentic". En SWE-bench Pro, un punto de referencia de codificación, las cifras reportadas fueron del 63.2% para Sonnet 5 y del 69.2% para Opus 4.8, frente al 58.1% de Sonnet 4.6. En Terminal-Bench 2.1, Sonnet 5 obtuvo un 80.4% frente al 82.7% de Opus 4.8. En OSWorld-Verified, un punto de referencia de uso de computadora, Sonnet 5 alcanzó el 81.2% frente al 83.4% de Opus 4.8. Estos son números reportados por Anthropic, no nuestras propias pruebas. Para ver la tabla completa, consulte el desglose de los puntos de referencia de Claude Sonnet 5.

El patrón es consistente. Con herramientas en el bucle, Sonnet 5 se sitúa entre uno y tres puntos de Opus 4.8. En el razonamiento puro, Opus se adelanta por unos seis puntos. Cursor casi siempre tiene herramientas en el bucle, por lo que obtiene la mayor parte de la calidad de primer nivel sin pagar el precio de primer nivel.

El precio es la otra mitad. 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 la tarifa estándar. Anthropic está ofreciendo 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 una sesión de agente larga, esa diferencia se acumula rápidamente.

Dos formas de usar Sonnet 5 en Cursor

Cursor admite los modelos Claude de Anthropic directamente, y también admite el uso de su propia clave (BYOK) si desea facturar a través de su propia cuenta de Anthropic. La redacción del menú cambia entre las versiones de Cursor, así que considere estos como la forma del flujo en lugar de pasos exactos.

Opción 1: Selector de modelo incorporado de Cursor

Si su plan de Cursor incluye modelos Claude, este es el camino más rápido.

1. Abra Cursor y presione el selector de modelo. Por lo general, se encuentra en la entrada del chat o del Compositor, o en Configuración.
2. Busque Claude Sonnet 5 en la lista de modelos.
3. Selecciónelo. Cursor ahora enruta sus solicitudes a través de Sonnet 5 para el chat, las ediciones y las ejecuciones del agente.

Los nuevos modelos pueden tardar un poco en aparecer en una determinada compilación de Cursor. Si aún no ve Sonnet 5, actualice Cursor a la última versión y luego verifique nuevamente. Para obtener más ayuda con la configuración, la guía de configuración de Cursor explica la configuración desde cero.

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

BYOK es útil cuando desea un control directo sobre la facturación, límites más altos vinculados a su cuenta o un modelo que su plan de Cursor no incluye.

1. Obtenga una clave API de Anthropic desde la Consola de Claude. Cree una clave en las claves API de su organización.
2. En Cursor, abra Configuración y busque la sección de modelo o claves API.
3. Pegue su clave de Anthropic en el campo del proveedor de Anthropic y guarde.
4. Seleccione Claude Sonnet 5 como su modelo activo.

El ID de modelo que expone Anthropic es claude-sonnet-5, una cadena exacta sin sufijo de fecha. Por lo general, no escribe el ID en la interfaz de usuario de Cursor, pero lo necesitará si programa algo contra la API usted mismo. Nuestra guía de la API de Claude Sonnet 5 cubre la forma de solicitud sin procesar, el ID del modelo y el formato de respuesta en detalle.

Mantenga su clave API fuera de su código base. Almacénela en una variable de entorno o en el llavero de su sistema operativo, y nunca la suba a git.

Qué cambió internamente (y por qué es importante para Cursor)

Sonnet 5 es un reemplazo directo de Sonnet 4.6 a nivel de API, pero vale la pena conocer algunos cambios de comportamiento incluso dentro de Cursor.

El pensamiento adaptativo ahora está activado por defecto. En Sonnet 4.6, una solicitud sin el campo thinking se ejecutaba sin pensar. En Sonnet 5, esa misma solicitud se ejecuta con pensamiento adaptativo. En Cursor, esto significa que el modelo razona más antes de actuar en una tarea difícil, que es lo que desea para planificar cambios en varios archivos. La salida puede incluir tokens de pensamiento, por lo que las respuestas pueden tardar un poco más y costar un poco más en indicaciones complejas.

Sonnet 5 también incluye un nuevo tokenizador. El mismo texto de entrada produce aproximadamente un 30% más de tokens que en Sonnet 4.6, aproximadamente 1.3 veces más. Las formas de solicitud y respuesta son idénticas, por lo que nada se rompe. Pero cualquier cosa que mida en tokens cambia. Su ventana de contexto de 1 millón de tokens contiene un poco menos de texto en promedio, y el costo de una solicitud equivalente puede ser mayor aunque la tarifa por token no cambie. Si rastrea el gasto de Cursor, vuelva a medir con Sonnet 5 en lugar de reutilizar sus números de 4.6.

Dos restricciones más importan si scripta directamente contra la API. El pensamiento extendido manual con budget_tokens devuelve un error 400. Establecer temperature, top_p o top_k en un valor no predeterminado también devuelve un error 400. Dirija el comportamiento a través de su prompt en su lugar. Cursor maneja esto dentro de sus propias llamadas de modelo, por lo que solo se encontrará con esto si construye contra la API de Anthropic usted mismo.

Usando Sonnet 5 en el modo agente de Cursor

El modo agente es donde Sonnet 5 se gana su lugar. Permite que el modelo lea su proyecto, planifique un cambio, edite varios archivos, ejecute comandos de terminal y luego verifique su propio trabajo.

Un flujo de trabajo que funciona bien:

1. Describa el resultado, no los pasos. Dígale a Sonnet 5 lo que quiere construir y qué archivos o carpetas están dentro del alcance.
2. Déjelo planificar primero. Con el pensamiento adaptativo activado, Sonnet 5 tiende a trazar un enfoque antes de editar. Lea el plan y corríjalo pronto si se desvía.
3. Mantenga las tareas delimitadas. Las tareas más pequeñas y bien definidas producen diferencias más limpias y cuestan menos que una única indicación gigante de final abierto.
4. Revise cada diferencia. El modelo es fuerte en la codificación de agentes, pero usted sigue siendo el responsable de la fusión.

Debido a que Cursor mantiene las herramientas en el bucle, la fuerza del agente de Sonnet 5 se manifiesta directamente. Maneja bien el ciclo de lectura, edición, ejecución y verificación sin que usted recurra a un modelo más caro para el trabajo rutinario.

Un ejemplo realista: construir una API y luego probarla

Supongamos que le pide a Sonnet 5 en Cursor que genere una ruta de Express que cree un pedido y lo devuelva 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 esto, conectarlo a su aplicación e incluso redactar una prueba. Pero el código generado aún necesita una verificación real con solicitudes reales. Ahí es donde entra Apidog.

En Apidog, puede:

• Enviar una solicitud POST /orders con un cuerpo JSON y confirmar que recibe un 201 y la forma de respuesta correcta.
• Guardar la solicitud en una colección para que todo su equipo la reutilice.
• Almacenar su URL base y cualquier clave como variables de entorno, para que nunca codifique secretos.
• Agregar aserciones automatizadas, por ejemplo, que status sea igual a created y que id esté presente, y luego ejecutar la suite en CI.
• Simular el endpoint para que su frontend pueda construirse con respuestas realistas antes de que el backend esté terminado.

Cursor y Sonnet 5 escriben el código rápidamente, y Apidog le brinda una forma reproducible de confirmar que la API se comporta. Si ha dejado otras herramientas, este recorrido de pruebas de API sin Postman muestra el flujo de pruebas de principio a fin. Descargue Apidog para seguirlo con sus propios endpoints.

Notas sobre el costo y el uso

Cursor gestiona su propia facturación, límites y acceso al modelo, y esos detalles específicos cambian con el tiempo, así que consulte directamente los detalles del plan actual de Cursor. Algunos principios se mantienen independientemente del plan:

• Sonnet 5 es más barato de ejecutar que Opus 4.8. Para la codificación diaria, eso lo convierte en un valor predeterminado sensato.
• El pensamiento adaptativo puede aumentar el costo en prompts difíciles porque los tokens de pensamiento cuentan para la salida. En muchas ediciones pequeñas, esa sobrecarga suele ser pequeña.
• El nuevo tokenizador significa que el mismo código y prompts consumen más tokens de los que lo hacían en Sonnet 4.6. Tenga esto en cuenta al presupuestar.
• Con BYOK, su factura de Anthropic refleja el uso real a las tarifas anteriores. Modele sus cargas de trabajo reales en lugar de asumir una paridad plana con los números anteriores de Sonnet.

Para una visión más amplia sobre la elección de un modelo dentro de Cursor, consulte la comparación del mejor modelo de Cursor.

Cuándo cambiar de modelo

Sonnet 5 cubre la mayor parte del trabajo de Cursor de manera eficiente. Cambie a Opus 4.8 para el razonamiento más difícil: decisiones arquitectónicas complejas, depuración sutil que requiere un razonamiento paso a paso profundo o ejecuciones autónomas a largo plazo donde la calidad importa más que el costo. En el razonamiento puro sin herramientas, Opus 4.8 supera a Sonnet 5 en aproximadamente seis puntos en los puntos de referencia reportados, y ese margen puede valer la prima en las tareas más difíciles.

Para todo lo demás, desde el trabajo de características hasta las refactorizaciones y la escritura y ejecución de pruebas, Sonnet 5 le brinda un rendimiento "agentic" cercano a Opus a un precio más bajo. Mantenga Sonnet 5 como su predeterminado y cambie a Opus 4.8 solo cuando una tarea realmente se detenga.

Preguntas frecuentes

¿Está Claude Sonnet 5 disponible en Cursor? Cursor admite los modelos Claude de Anthropic, y Sonnet 5 debería aparecer en el selector de modelos una vez que su compilación de Cursor lo admita. Si no aparece, actualice Cursor a la última versión. También puede agregarlo a través de 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 una clave. Use BYOK cuando desee facturar a través de su propia cuenta de Anthropic o necesite un control directo sobre los límites. La guía de la API de Claude Sonnet 5 explica cómo crear una clave.

¿Es Sonnet 5 u Opus 4.8 mejor para codificar en Cursor? Para la mayoría del trabajo con Cursor, Sonnet 5 es la mejor opción porque su rendimiento se acerca al de Opus 4.8 en la codificación de agentes a un precio más bajo. Recurra a Opus 4.8 para las tareas de razonamiento más difíciles. La comparación Sonnet 5 vs Opus 4.8 desglosa la compensación.

¿Por qué Sonnet 5 parece usar más tokens que Sonnet 4.6? Sonnet 5 utiliza un nuevo tokenizador que produce aproximadamente un 30% más de tokens para el mismo texto. El precio por token no ha cambiado, pero el costo de solicitudes equivalentes puede ser mayor. Mida sus cargas de trabajo reales en lugar de reutilizar los recuentos de tokens anteriores.

¿Puedo usar Sonnet 5 en Cursor de forma gratuita? Eso depende de su plan de Cursor, que Cursor controla. 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 del plan actual de Cursor para saber qué se incluye.