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

  1. Has creado una clave de API y has guardado la clave completa.
  2. Tienes un ID de modelo del catálogo de modelos.
  3. Tu versión de Cursor admite modelos personalizados (Ajustes → Models muestra un botón «Add Model»).

Configuración

  1. Abre los ajustes: ⌘⇧J (macOS) / Ctrl⇧J (Windows, Linux), o ⌘⇧P → Cursor Settings.

  2. Ve a Models → Model Names → + Add Model, escribe el ID de modelo que quieras y pulsa Intro.

  3. En la misma página, en API Keys → OpenAI API Key, haz clic en + y pega tu clave de OLETOKEN.

  4. Activa Override OpenAI Base URL e introduce la dirección compatible con OpenAI incluido /v1:

    https://<your-base-url>/v1
    

    Cursor le añade /chat/completions, así que /v1 no es opcional.

  5. 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.

  6. De vuelta en el editor, pulsa ⌘L / Ctrl+L para 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íntomaCausa y solución
Verify fallaFalsa alarma con nombres de modelo que no son de OpenAI: pruébalo en el Chat
401La clave se pegó incompleta o está deshabilitada; cópiala otra vez
404A Override OpenAI Base URL le falta /v1
Falta el modelo nuevo en el ChatEl ID de modelo está mal escrito, o no lo has seleccionado en el desplegable de modelos del Chat
Insufficient balanceRecarga primero