Usa tu clave en Cursor
Anula la Base URL de OpenAI, añade modelos personalizados y averigua qué funciones de Cursor siguen usando su propio backend.
Cursor admite traer tu propia clave (BYOK): configura una base URL compatible con OpenAI junto con tu clave de OLETOKEN y las solicitudes del Chat se ejecutarán contra tu saldo de OLETOKEN.
Antes de empezar
- Has creado una clave de API y has guardado la clave completa.
- Tienes un ID de modelo del catálogo de modelos.
- Tu versión de Cursor admite modelos personalizados (Ajustes → Models muestra un botón «Add Model»).
Configuración
-
Abre los ajustes:
⌘⇧J(macOS) /Ctrl⇧J(Windows, Linux), o⌘⇧P→Cursor Settings. -
Ve a Models → Model Names → + Add Model, escribe el ID de modelo que quieras y pulsa Intro.
-
En la misma página, en API Keys → OpenAI API Key, haz clic en + y pega tu clave de OLETOKEN.
-
Activa Override OpenAI Base URL e introduce la dirección compatible con OpenAI incluido
/v1:https://<your-base-url>/v1Cursor le añade
/chat/completions, así que/v1no es opcional. -
Haz clic en Verify. Con nombres de modelo que no son de OpenAI, la verificación puede fallar: es una falsa alarma; envía un mensaje en el Chat para probarlo.
-
De vuelta en el editor, pulsa
⌘L/Ctrl+Lpara abrir el Chat y elige tu modelo en el desplegable de modelos.
Conviene saber
- Solo cubre Chat y Plan. Composer, el autocompletado con Tab e Inline Edit siguen ejecutándose en el backend propio de Cursor y no gastan tu saldo de OLETOKEN.
- Tus modelos Anthropic integrados pueden verse afectados. Con Override OpenAI Base URL activado, los modelos Claude incluidos en Cursor también pueden enrutarse a este sitio. Si aun así quieres los oficiales, añade los ID de modelo de Claude como modelos personalizados con + Add Model y selecciónalos en el desplegable.
- Para revertir: desactiva Override OpenAI Base URL. Las entradas de clave y modelo pueden quedarse.
- También puedes instalar la extensión Claude Code en Cursor (Cursor acepta el marketplace de VS Code); consulta usar VS Code. Esa vía habla el protocolo Anthropic Messages y no se limita a Chat / Plan.
Solución de problemas
| Síntoma | Causa y solución |
|---|---|
| Verify falla | Falsa alarma con nombres de modelo que no son de OpenAI: pruébalo en el Chat |
| 401 | La clave se pegó incompleta o está deshabilitada; cópiala otra vez |
| 404 | A Override OpenAI Base URL le falta /v1 |
| Falta el modelo nuevo en el Chat | El ID de modelo está mal escrito, o no lo has seleccionado en el desplegable de modelos del Chat |
| Insufficient balance | Recarga primero |

