Configurar Cursor: API Key, Base URL y modelos

Para conectar Cursor a BetterToken, prepara una API Key, introduce la Base URL indicada a continuación y elige un Model ID actual del model plaza.

Ajustes principales

Campo	Valor
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Model	Un Model ID actual del model plaza

Requisitos previos

• La versión actual de la herramienta está instalada
• Una BetterToken API Key: regístrate y obtén una
• Un Model ID del model plaza

Regístrate y obtén una BetterToken API Key→

¿Ya tienes una cuenta? Inicia sesión, recarga el saldo y crea una clave en la consola.

Requisitos adicionales

• Cursor instalado (descargar Cursor)

Instalación

Descarga e instala la versión actual desde el sitio web de Cursor. Inicia sesión con una cuenta de Cursor que admita modelos personalizados y continúa con los pasos siguientes.

Cursor solo permite configurar modelos personalizados a usuarios de un nivel avanzado de pago o superior. Si tu cuenta o versión del cliente no muestra opciones de modelos personalizados, API Key o Base URL, comprueba primero el plan de Cursor y la versión del cliente.

Las reglas de BYOK de Cursor limitan OpenAI BYOK a modelos de chat estándar sin razonamiento. La completación con Tab sigue usando los modelos integrados de Cursor. Las solicitudes pasan por el backend de Cursor para construir los prompts; la API Key se envía en cada solicitud y no se conserva al terminar. El tratamiento de datos de BYOK sigue la política del proveedor elegido, en lugar de la política de retención cero de datos de Cursor.

En los planes Teams y Enterprise, las solicitudes BYOK elegibles también consumen uso de Cursor mediante la Cursor Token Rate, y el proveedor del modelo cobra por separado el coste del modelo. Revisa los créditos, el uso bajo demanda y los límites de gasto de tu equipo: las solicitudes pueden detenerse cuando se agota la cuota. Los planes individuales tienen reglas de uso distintas; consulta los detalles de los planes.

Problema conocido: Override OpenAI Base URL es un ajuste global. Cuando está activado, afecta a todas las API Keys configuradas en Cursor, incluidas las claves Anthropic y GPT usadas por los modelos integrados de Cursor. La comunidad oficial de Cursor ha confirmado este comportamiento: configurar una Base URL afecta a todas las claves y modelos (hilo de la comunidad).

Si los modelos Claude / GPT integrados en Cursor dejan de funcionar después de activar Override OpenAI Base URL, desactiva Override OpenAI Base URL cuando no utilices BetterToken. Cursor no permite actualmente configurar una Base URL distinta para cada modelo; esta posibilidad sigue registrada como una solicitud de función (solicitud de función).

Configuración manual

Realiza esta configuración en la interfaz de ajustes de Cursor. No necesitas editar ningún archivo de configuración.

Campo de Cursor	Valor
Override OpenAI Base URL	Activado
Base URL	https://bettertoken.ai/v1
OpenAI API Key	Tu BetterToken API Key
Modelo personalizado	Un Model ID completo disponible

Configuración

Abre la página de ajustes de modelos

En Cursor, haz clic en Settings en la esquina inferior izquierda y abre Models. Desplázate hasta API Keys.

Introduce la Base URL y la API Key

En API Keys, configura los campos en este orden:

1. Activa Override OpenAI Base URL
2. Introduce https://bettertoken.ai/v1 en el campo Base URL
3. Pega tu BetterToken API Key en OpenAI API Key
4. Cuando hayas introducido la URL y la Key, activa el interruptor OpenAI API Key

Introduce la Key antes de activar el interruptor. De esta forma, Cursor mostrará el cuadro de confirmación de autenticación.

Activa la OpenAI API Key

En el cuadro de confirmación, haz clic en Enable OpenAI API Key.

Actualiza la lista de modelos y activa los modelos

De vuelta en Models, haz clic en el botón de actualización de la derecha antes de seleccionar un modelo. Espera a que termine la actualización de la lista.

Copia el Model ID exacto de la model plaza.

Vuelve al chat y desactiva Auto

Cuando termines la configuración, vuelve al chat de Cursor y abre el selector de modelos situado debajo del campo de entrada. Si Auto está activado, desactívalo primero.

Selecciona el modelo e inicia el chat

Elige el modelo que activaste y comienza a usar el chat.

Verificar la conexión

Envía un mensaje de prueba corto. Si la herramienta devuelve una respuesta sin errores de autenticación o de Model ID, la conexión funciona. Reinicia por completo la herramienta después de cambiar su configuración.

Límites del Cursor CLI

El Cursor CLI oficial (cursor-agent) usa la autenticación de la cuenta Cursor: CURSOR_API_KEY es una clave Cursor, no una BetterToken API Key. La opción --endpoint indica la dirección del servicio Cursor; las referencias oficiales de autenticación y parámetros no documentan una Base URL compatible con OpenAI. La configuración BYOK de escritorio de esta página no se aplica a Cursor CLI.

Cambiar de modelo

Abre el selector de modelos o cambia el campo Model de la configuración. Usa el Model ID exacto del model plaza y reinicia la sesión actual.

Errores frecuentes

Errores de API personalizada y API Key

Antes de cambiar modelos o claves, compara tus ajustes con la configuración de API OpenAI personalizada en Cursor.

Cursor no muestra los campos Custom API, API Key o Base URL

Comprueba el plan de Cursor y la versión del cliente. Los modelos personalizados solo están disponibles en los niveles de pago compatibles. Después de actualizar Cursor, abre de nuevo Settings → Models.

No se puede activar o verificar la API Key

Introduce la Base URL https://bettertoken.ai/v1 y la API Key antes de activar el interruptor OpenAI API Key. No añadas /chat/completions a la Base URL ni uses una Key del proveedor Claude.

El modelo no aparece después de actualizar

Copia el Model ID exacto de la model plaza.

Los modelos integrados de Cursor dejan de funcionar

Override OpenAI Base URL es un ajuste global. Cuando no utilices BetterToken, desactiva este interruptor para que Cursor vuelva a usar su propia Base URL.

El chat selecciona otro modelo

Abre el selector de modelos y desactiva Auto. Después, selecciona manualmente el modelo que activaste.

Preguntas relacionadas

• Configuración de API OpenAI personalizada en Cursor

• Cursor Rules, AGENTS.md y .cursorignore

• Cómo configurar MCP en Cursor

• Claude Code frente a Cursor para desarrollo local

• Configurar un proveedor personalizado en Codex CLI

• Configurar una API compatible con OpenAI en Cline

• API compatible con OpenAI frente a API compatible con Anthropic

• Compara todas las herramientas compatibles

• Errores de API, códigos de estado y límites de solicitudes

Detalles técnicos

Protocolo, endpoint y campos internos del proveedor

Esta configuración usa https://bettertoken.ai/v1. La herramienta añade la ruta del endpoint compatible con OpenAI. No añadas /chat/completions ni /responses salvo que un campo concreto lo exija expresamente.

Notas

• Copia el Model ID exacto de la model plaza.