OpenAI en Cursor: 12 de noviembre, BYOK, Codex y gateways

Para mantener OpenAI en Cursor, usa tu propia clave de API (BYOK) en las solicitudes locales compatibles de Chat y Agent. Elige la extensión de Codex para usar su agente de programación o acceder con una suscripción de ChatGPT admitida. Usa un gateway compatible si tu equipo ya gestiona allí el acceso a los modelos y la facturación.

Cada opción tiene requisitos de cuenta y límites de funciones distintos. Revísalos antes de comprar crédito para la API o cambiar el endpoint.

El 12 de noviembre sigue siendo una fecha propuesta

A fecha de 2026-10-27, el 12 de noviembre de 2026 sigue siendo una fecha de finalización propuesta. La guía actual de OpenAI sobre Cursor indica que ambas empresas aún deben confirmar la fecha definitiva. También señala que Cursor podría interrumpir el acceso antes.

La cronología tiene dos momentos relevantes:

2026-08-28: OpenAI anunció su intención de finalizar el contrato tras la adquisición de Cursor por SpaceX. Propuso el 12 de noviembre y afirmó que no incorporaría futuros modelos al acuerdo.
A fecha de 2026-10-27: la página de ayuda de OpenAI todavía presenta esa fecha como una propuesta. Documenta BYOK, la extensión de Codex y los gateways compatibles como alternativas de acceso.

OpenAI atribuyó su decisión a dudas sobre el cumplimiento de sus condiciones de uso. Esa es la explicación que dio OpenAI. Para planificar la migración, lo que importa es el acuerdo que permite a Cursor ofrecer su propio acceso a OpenAI.

Configura una alternativa antes de depender de la fecha propuesta. Estas instrucciones permiten conservar formas compatibles de trabajar dentro del editor; no mantienen todas las funciones de Cursor.

Revisa primero el plan, las funciones y la facturación

El BYOK integrado de Cursor cubre las solicitudes locales compatibles de Chat y Agent. No cubre Tab, Auto, Cloud o Background Agents, Automations, Cursor CLI ni Cursor API/SDK. Instalar la extensión de Codex no cambia esas funciones de Cursor.

También importa qué admite tu plan. A fecha de 2026-10-27, la documentación actual de planes de Cursor excluye expresamente las claves de API personales de Cursor Plus. La ayuda de BYOK contempla Premium, Super, Ultra y determinados planes anteriores. Comprueba los permisos de tu plan antes de cambiarlo.

En un espacio de trabajo Enterprise, el administrador puede restringir las claves personales. Los controles están en Team Settings → Models → Personal API Keys (BYOK). Un gateway configurado mediante los campos de OpenAI también necesita permiso para OpenAI BYOK.

Cada opción tiene su propia facturación:

Opción	Cuenta o saldo que paga el uso del modelo
Clave de OpenAI en Cursor	Tu cuenta de OpenAI API
Codex con inicio de sesión de ChatGPT	El uso incluido en tu plan de ChatGPT admitido y los créditos adicionales que correspondan
Codex con una clave de OpenAI API	Tu cuenta de OpenAI API
Gateway en Cursor	Tu cuenta del gateway o del proveedor de alojamiento

Los cargos de API son independientes de las suscripciones de Cursor y ChatGPT. Una suscripción de ChatGPT no incluye saldo para OpenAI API.

Teams y Enterprise tienen otro costo que revisar. A fecha de 2026-10-27, las solicitudes BYOK sujetas al cargo pagan la Cursor Token Rate de USD $0.25 por millón de tokens. Se aplica a los tokens de entrada, salida y caché, además de los cargos del proveedor. Los planes individuales no pagan esta tarifa, y las exenciones de modelos indicadas también se aplican a BYOK.

«Local» describe el trabajo desde la aplicación de escritorio. Según la documentación de BYOK de Cursor, las solicitudes siguen pasando por el backend de Cursor para construir el prompt. La política Zero Data Retention de Cursor no se aplica a BYOK. Revisa cómo trata los datos tu proveedor.

Opción 1: añade tu propia clave de OpenAI API

Elige esta opción si quieres usar la interfaz nativa de Chat y Agent de Cursor con un modelo de OpenAI compatible.

Cursor documenta actualmente OpenAI BYOK para modelos de chat estándar sin razonamiento. Añadir el ID de un modelo de razonamiento más reciente no garantiza que sea compatible. Elige un modelo que admitan tanto tu cliente actual como tu cuenta de API.

Sigue las instrucciones de OpenAI para configurar Cursor:

Configura la facturación de tu cuenta de OpenAI API.
Crea tu propia clave en la página de claves de OpenAI API.
Abre Cursor Settings → Models y busca los ajustes de la clave de OpenAI API.
Si antes configuraste un gateway, desactiva Override OpenAI Base URL antes de usar tu clave oficial de OpenAI.
Pega la clave en OpenAI API Key y pulsa Save. Activa Use OpenAI API Key si aparece ese interruptor.
Activa un modelo de OpenAI compatible en la lista de modelos.
Abre un nuevo Chat local, desactiva Auto y selecciona ese modelo de forma explícita.
Envía Reply with exactly: connection-ok.

El resultado esperado es una respuesta en Cursor Chat. Revisa el uso de API del proyecto correspondiente para confirmar qué cuenta recibió la solicitud. Después, prueba la operación de Agent que necesitas con la comprobación de edición que aparece más adelante.

Opción 2: instala la extensión de Codex para el IDE

Elige Codex si necesitas su agente de programación o quieres acceder desde Cursor con una suscripción de ChatGPT admitida. Codex funciona en su propia interfaz y no depende del selector nativo de modelos de OpenAI de Cursor.

Los planes de ChatGPT admitidos incluyen Plus, Pro, Business, Edu y Enterprise, sujetos a los permisos del espacio de trabajo. Consulta la disponibilidad actual de Codex por plan. ChatGPT Plus y Cursor Plus son suscripciones distintas.

Abre la página oficial de la extensión de Codex para el IDE.
En Install or enable Codex, elige Cursor y completa la instalación.
Abre un proyecto local y selecciona el icono de Codex en la Activity Bar.
Si no aparece, abre la Command Palette y ejecuta Codex: Open Codex Sidebar.
Elige Sign in with ChatGPT y completa el inicio de sesión en el navegador. Para facturación por API, elige Use API Key, introduce tu clave de OpenAI y selecciona OK.
Abre un archivo de código y añade una función seleccionada al contexto del prompt de Codex.
Pide a Codex que explique la función y un caso límite sin editar archivos.

Lee la respuesta en la conversación de Codex y compárala con el código seleccionado. Usa los controles de modelo y cuenta de Codex para comprobar la conexión.

Para ajustar el agente, selecciona el icono de engranaje de la barra lateral y después Codex Settings. La referencia de ajustes de la extensión de OpenAI distingue estos controles de los ajustes del editor. No configuran la página Models nativa de Cursor.

La documentación de autenticación confirma que el inicio de sesión con clave de API factura a tu cuenta de OpenAI Platform. Permite trabajar con Codex de forma local. Las funciones que necesitan un espacio de trabajo de ChatGPT o acceso a la nube pueden seguir sin estar disponibles.

Si eliges esta opción, envía las siguientes tareas desde el panel de Codex. Escribir en Cursor Chat sigue usando la configuración independiente de Cursor.

Opción 3: conecta un gateway compatible con OpenAI

Elige un gateway si ofrece la cuenta, el modelo y el formato de API que necesitas para trabajar en Cursor. OpenAI menciona Amazon Bedrock, Azure y otros proveedores compatibles como posibles opciones.

Azure y Bedrock tienen ajustes específicos de cada proveedor. Los siguientes pasos corresponden a un endpoint personalizado compatible con OpenAI. Sigue las instrucciones de despliegue del proveedor para obtener sus credenciales y los nombres de los modelos.

Para configurar OpenRouter, consulta la guía específica de Cursor y OpenRouter.

Obtén la clave de API del proveedor, su Base URL documentada y el ID exacto del modelo.
Confirma que el proveedor admite el formato de API y las herramientas que necesita el modelo elegido en Cursor.
Abre Cursor Settings → Models → API Keys.
En la sección de OpenAI, activa Override OpenAI Base URL e introduce la Base URL del proveedor.
Introduce la credencial del gateway en OpenAI API Key, activa Use OpenAI API Key y guarda los cambios.
Añade o activa el ID exacto del modelo que proporciona el proveedor.
Reinicia Cursor, abre un nuevo Chat local, desactiva Auto y selecciona ese modelo.
Envía la solicitud breve de conexión y revisa el registro de uso del proveedor.

El soporte de Cursor documenta estos controles en su guía para configurar modelos personalizados. Usa el ID de modelo del endpoint, incluido cualquier prefijo obligatorio. El nombre que muestra otro proveedor puede corresponder a una ruta distinta.

Por ejemplo, la guía de Cursor de BetterToken indica https://www.bettertoken.ai/v1 y tu propia clave de API de BetterToken. Su catálogo actual incluía gpt-6-luna el 2026-10-27. Esto confirma su presencia en el catálogo, no su compatibilidad con las funciones nativas de Cursor. Antes de seleccionarlo, comprueba el modo de API y las herramientas que admite el modelo. Ten especialmente en cuenta la restricción publicada de Cursor sobre modelos de razonamiento.

Conserva /v1 en el campo Base URL de BetterToken. No añadas /chat/completions ni /responses: son rutas de recursos, como explica su referencia de API.

Revisa la sustitución de Base URL cuando vuelvas a modelos gestionados por Cursor. En el hilo de soporte sobre el enrutamiento de Cursor, el soporte confirmó que también afecta a las selecciones de modelos OpenAI integrados. Desactívala al volver a la ruta gestionada por Cursor. Elegir un nombre de GPT conocido no selecciona por sí solo otro endpoint.

Comprueba todo el proceso de edición

Prueba la operación que necesitas antes de trasladar una sesión de programación a la nueva configuración. Una respuesta breve confirma la conectividad básica, pero no demuestra que funcionen las herramientas de edición.

Abre una carpeta de proyecto desechable. En el Agent local de Cursor o en la barra lateral de Codex, envía:

Create cursor-route-check.txt containing this single line:
connection-ok

Use your file-editing tool, then read the file back.
Do not use a shell command to create or modify the file.
Stop after confirming its contents.

El resultado esperado es un archivo que contenga connection-ok y una interacción completa de edición y lectura posterior. Inspecciona el archivo. Si usas una clave de API o un gateway, revisa también el modelo y el uso registrados por el proveedor.

Si el texto funciona pero la edición falla, investiga la compatibilidad de las herramientas antes de cambiar la clave. En un hilo de soporte de Cursor de julio de 2026, Harm Alhusen descubrió que su proxy descartaba las respuestas custom_tool_call, lo que impedía editar. El soporte de Cursor explicó que las herramientas personalizadas de OpenAI deben conservarse durante todo el recorrido de solicitud y respuesta.

Ese informe describe un fallo de integración diagnosticado. No explica la causa de todas las tareas de Agent que se interrumpen. Si el modelo que necesitas no supera la prueba mediante BYOK nativo, prueba Codex con una cuenta y un modelo compatibles.

Corrige el problema según el síntoma

Usa el síntoma para elegir la siguiente comprobación. Cambiar todos los ajustes a la vez dificulta aislar los errores de enrutamiento.

Síntoma	Comprobación y siguiente paso
No aparecen los campos de clave de API o Base URL	Revisa tu plan y el cliente de Cursor. En Enterprise, pide al administrador que revise las restricciones de claves personales. Vuelve a abrir Models después de habilitar el acceso.
Falla la autenticación	Confirma que la clave pertenece al proveedor del endpoint configurado y que la facturación de API está activa. Guarda la combinación correcta y repite una solicitud breve.
`AI Model Not Found` o `Model name is not valid`	Comprueba el ID exacto del modelo del proveedor, que el interruptor de la clave esté activado y el permiso para OpenAI BYOK. Inicia un chat nuevo tras corregirlos.
`You've reached your monthly usage limit` al usar un gateway	Comprueba los límites de gasto del equipo en Cursor y el crédito del proveedor. Los cargos por tokens de Cursor que correspondan pueden detener las solicitudes BYOK del equipo.
Falla un modelo GPT integrado tras activar la sustitución de Base URL	Desactiva la sustitución antes de probar la ruta gestionada por Cursor, mientras ese modelo siga disponible allí.
La respuesta empieza, pero fallan las herramientas o la edición	Revisa el protocolo y el tratamiento de llamadas a herramientas de ese modelo. Repite la prueba del archivo desechable tras corregir la configuración del proveedor o del cliente.

El intercambio con soporte de Cursor de septiembre y octubre de 2026 documenta varios de estos fallos de permisos y límites de gasto. Son comprobaciones útiles, pero no demuestran que tu cuenta tenga la misma causa.

Si la solicitud sigue fallando, registra la versión de Cursor, el ID del modelo seleccionado, el host del endpoint, la fecha y hora y el ID de solicitud. No incluyas credenciales ni contenido privado del prompt en los datos de diagnóstico que compartas.