Cursor es un editor de código con IA muy utilizado. Incluye su propia cuota de modelos, pero también permite introducir tu propia API Key y Base URL. Para los equipos en China, usar tu propio gateway aporta tres ventajas: acceso más estable, facturación unificada y libertad para cambiar de modelo en cualquier momento.
Este artículo explica cómo configurar una API personalizada en Cursor, los errores habituales y cómo elegir entre una suscripción de Cursor y tu propia clave.
Cursor se actualiza con frecuencia, por lo que los nombres de los menús pueden cambiar. Este artículo usa las versiones habituales a octubre de 2026; consulta la configuración de tu versión actual para los detalles.
1. Entiende las dos formas de usar Cursor
1. Usar la cuota incluida de Cursor
Funciona desde el primer momento y se factura según tu plan de Cursor. Encaja en usuarios individuales que no quieren configurar nada y tienen un uso moderado.
2. Usar tu propia API Key
Introduce en Cursor la clave y la Base URL de una interfaz compatible con OpenAI de terceros, y el uso se factura a tu propia cuenta de API. Encaja en:
- Usuarios en China cuyo acceso a las API oficiales es inestable.
- Equipos que quieren facturación y cuotas unificadas.
- Usuarios que necesitan especificar modelos o cambiar entre varios proveedores.
- Empresas que quieren incluir el uso de Cursor en la gestión de costes.
Nota: incluso con tu propia clave, algunas funciones de Cursor pueden seguir requiriendo un plan válido. Consulta la versión actual de Cursor y las reglas de tu plan.
2. Prepara una API Key
- Abre ZSQH AI Gateway e inicia sesión.
- Ve a "API Keys", crea una clave nueva y llámala
cursor-work-laptop. - Fija un límite de gasto y una fecha de caducidad.
- Copia la clave y guárdala en un gestor de contraseñas.
- Recarga tu monedero y confirma el saldo.
Usa esta Base URL:
https://ai.zhongshangqihang.com/v1
Es la dirección compatible con OpenAI. La función de API personalizada de Cursor suele llamar al protocolo OpenAI, así que no introduzcas la dirección raíz de Anthropic.
3. Configura Cursor
Las rutas de menú varían ligeramente entre versiones. Normalmente están en:
Cursor Settings → Models → OpenAI API Key
Pasos:
- Abre la configuración de Cursor (el atajo suele ser
Cmd/Ctrl + ,). - Busca la sección Models u OpenAI API Key.
- Activa "Override OpenAI Base URL" o un interruptor similar.
- Introduce
https://ai.zhongshangqihang.com/v1como Base URL. - Introduce tu clave de API
sk-.... - Añade a la lista de modelos los nombres que quieras usar, por ejemplo
gpt-5yclaude-sonnet-4-5. - Guarda, inicia un chat nuevo y selecciona el modelo personalizado para probar.
Si Cursor informa "API Key invalid":
- Comprueba que la clave se copió completa.
- Comprueba que la Base URL termina en
/v1. - Comprueba que el saldo es suficiente.
- Comprueba que el nombre del modelo está disponible para tu cuenta.
4. Cómo elegir modelos
Las tareas en Cursor suelen dividirse en tres categorías:
| Tarea | Modelo sugerido | Por qué |
|---|---|---|
| Autocompletado diario y corrección de errores pequeños | Modelo ligero y rápido | Baja latencia y bajo coste |
| Refactorización de varios archivos, agentes complejos | Modelos insignia Claude Sonnet / GPT | Comprensión de código y llamadas a herramientas más fiables |
| Razonamiento difícil y diseño de arquitectura | Opus / modelos de gama alta | Mayor capacidad a un coste más alto |
Los nombres de modelo deben seguir la página de precios de modelos. El desplegable de modelos de Cursor puede mostrar solo los nombres que reconoce; si tu modelo personalizado no aparece, añádelo manualmente o selecciona un alias compatible.
5. Suscripción frente a clave propia
No hay una respuesta universal; depende del uso. Puedes estimarlo así:
- Calcula aproximadamente cuántas peticiones envías al día y cuánto contexto lleva cada una.
- Consulta el precio y la cuota de tu plan de Cursor.
- Usa la página de precios de la API para estimar el coste en tokens del mismo uso.
- Ten en cuenta la estabilidad, la velocidad de acceso y la gestión de facturación.
Reglas prácticas:
- Uso bajo, un solo modelo: un plan puede ser más sencillo.
- Uso alto, cambios frecuentes de modelo, varios miembros del equipo: tu propia clave más un gateway suele ser más controlable.
- Necesitas acceso estable desde China: el valor de un gateway suele superar la diferencia de precio unitario.
Para precios concretos, consulta precios de modelos y la página oficial de planes de Cursor.
6. Preguntas frecuentes y resolución de problemas
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| 401 | Clave incorrecta o caducada, Base URL incorrecta | Copia la clave de nuevo; confirma /v1 |
| 404 | Ruta duplicada en la Base URL | Introduce solo hasta /v1, sin /chat/completions |
| Modelo no disponible | Nombre de modelo incorrecto o no habilitado | Copia el nombre de modelo de la página de precios |
| Tiempo de espera agotado | Red o proxy | Revisa la red, alterna entre directo y proxy |
| Saldo insuficiente | Sin recarga o cuota agotada | Recarga; revisa la cuota de la clave |
| Respuesta truncada | Límite de contexto o de salida | Reduce el contexto o aumenta el límite de salida |
7. Recomendaciones de seguridad
- Crea una clave separada para Cursor; no la compartas con servicios de producción.
- Fija un límite de gasto para evitar que las peticiones en segundo plano del IDE consuman demasiado.
- No guardes claves a largo plazo en ordenadores compartidos.
- Elimina las claves antiguas cuando un empleado se vaya o se sustituya una máquina.
- Para equipos, usa un gateway unificado y crea una clave por miembro para facilitar la auditoría.
8. Qué equipos se benefician
- Agencias y equipos externalizados: una clave por proyecto, con los costes registrados por proyecto.
- Startups: un punto de entrada unificado, modelos que se pueden cambiar en cualquier momento y sin dependencia de un único proveedor.
- I+D empresarial: gestión centralizada de miembros, cuotas, registros y facturación.
- Desarrolladores individuales: acceso más estable desde China y pago más cómodo.
Próximos pasos
Primero regístrate en ZSQH AI Gateway, crea una clave dedicada cursor e introdúcela en Cursor como se describe arriba. Cuando funcione, ajusta tu modelo principal según precios de modelos.
Lecturas relacionadas:
