# Cursor

El chat y el agente de Cursor pueden usar tu propio servicio compatible con OpenAI. Introduce la clave y la URL base, y después añade los nombres de los modelos a mano.

> https://nezhagate.com/es/docs/integrations/cursor

Escrita con Cursor 3.22

## Antes de empezar

- Un plan de pago de Cursor (Pro o superior): el plan gratuito no permite usar tu propia clave en el chat ni en el agente.

- En un plan de equipo, un administrador debe permitir claves de API personales.

- Cursor envía las peticiones desde sus propios servidores, así que la dirección pública de NezhaGate funciona tal cual.

## Configuración

1. Abre **Cursor Settings** (`Ctrl/Cmd + Shift + J`) → **Models**, baja hasta el final y despliega **API Keys**.

2. Pega tu clave de NezhaGate en **OpenAI API Key** y activa **Use OpenAI API Key** (son dos pasos distintos; hacen falta los dos).

3. Activa **Override OpenAI Base URL** e introduce `https://nezhagate.com/v1`.

4. Escribe el nombre exacto del modelo en el cuadro de búsqueda de modelos (por ejemplo, uno de la lista de abajo) y haz clic en **Add Custom Model**.

5. Reinicia Cursor, abre un chat nuevo y elige el modelo que añadiste.

Base URL`https://nezhagate.com/v1`

## Qué modelos añadir

Modelos de chat de NezhaGate a la venta que puedes añadir en Cursor:

`gpt-5.6-sol` · `gpt-5.6-terra` · `gpt-5.6-luna` · `gpt-6-astra` · `gpt-6.1-sol` · `gpt-6-sol` · `gpt-6-luna` · `deepseek-v4.1-flash` · `deepseek-v4-flash-0731` · `glm-5.3` · `glm-5.3-flash` · `kimi-k3` · `qwen3.7-max` · `qwen3.8-max` · `qwen3.8-max-0902` · `qwen3.8-flash` · `doubao-seed-2-1-pro` · `doubao-seed-2-1-turbo` · `grok-4.7`

- Cursor envía cualquier modelo cuyo nombre empiece por `claude-` a través de su propia clave de Anthropic, y esa casilla no tiene anulación de URL base, así que los modelos Claude de NezhaGate no se pueden usar en Cursor. Los nombres que empiezan por `gemini-` tampoco tienen garantizada la dirección personalizada, así que la lista de arriba no los incluye. Para Claude, usa [Claude Code](https://nezhagate.com/es/docs/integrations/claude-code).

- Un nombre que coincide con uno de los modelos propios de Cursor (como `gpt-5.5`) no se puede añadir; elige otro modelo.

- Para enviar imágenes, elige un modelo que acepte entrada de imágenes (consulta la documentación de la API de cada modelo).

## Límites que debes conocer

- El autocompletado con Tab nunca usa tu propia clave; solo el chat y el agente pasan por NezhaGate.

- El ajuste se aplica a todos los modelos de la familia OpenAI: mientras está activado, algunos modelos propios de Cursor dicen que no admiten claves personalizadas. Para volver a usarlos, desactiva **Use OpenAI API Key**.

- Cursor no tiene un botón para verificar claves personalizadas, y el campo de la clave no la muestra después de guardarla; la mejor prueba es enviar un mensaje.

## Prueba

Abre un chat nuevo, elige el modelo que añadiste y envía Reply with exactly: ok. Cuando responda, la petición aparecerá en el registro de llamadas de tu consola.

## Errores habituales

**Model name is not valid / AI Model Not Found**

**Use OpenAI API Key** está desactivado (no se envió ninguna clave), o el nombre del modelo empieza por `claude-`.

**This model does not support custom API keys**

Está seleccionado un modelo de Cursor. Elige un modelo que hayas añadido, o desactiva **Use OpenAI API Key** para usar los propios de Cursor.

**Invalid API key / Unauthorized User API key**

La clave está mal: vuelve a pegarla completa (el campo no muestra la anterior; simplemente sobrescríbela).

**Stuck on Planning next moves, then a rate-limit or unavailable error**

Normalmente es el plan gratuito, que no admite claves personalizadas, o una URL base incorrecta. Comprueba el plan y que la dirección sea `https://nezhagate.com/v1`.