¡Invita a amigos y gana tokens gratuitos!Saber más

🚀 Integrando Cursor con modelos personalizados de CodingPlanX

Introducción: Cursor es un editor de código impulsado por IA muy apreciado por los desarrolladores, que cuenta con potentes capacidades integradas de Modelos de Lenguaje Grande (LLM). Sin embargo, debido a restricciones de red, control de costos (uso de API proxy de terceros o modelos más económicos como DeepSeek), o necesidades de implementación en intranet empresarial, a menudo necesitamos configurar una URL de API y una Clave API personalizadas.

Este tutorial te guiará paso a paso sobre cómo completar fácilmente esta configuración.

📋 Requisitos previos

Antes de comenzar, asegúrate de tener lista la siguiente información:

  1. Cursor instalado: Asegúrate de que tu Cursor esté actualizado a la última versión.
  2. Clave API (API Key): ej., sk-xxxxxxxxxxxxxxxxxxxxxxxx.
  3. URL base (Base URL): La dirección de tu proxy de API personalizado.
    • Nota: Por lo general, debe terminar con /v1, por ejemplo, https://api.codingplanx.ai/v1.
  4. Nombre del modelo: El nombre estándar del modelo que pretendes usar (ej., gpt-4o, claude-3-5-sonnet, deepseek-chat, etc.).

⚙️ Pasos detallados de configuración

Paso 1: Abrir la configuración de Cursor

  1. Inicia el editor Cursor.
  2. Haz clic en el ícono de engranaje ⚙️ en la esquina superior derecha, o usa el atajo para abrir la configuración:
    • Windows / Linux: Ctrl + ,
    • macOS: Cmd + ,

Paso 2: Ir a la página de configuración de modelos

En la barra de navegación izquierda del panel de configuración, busca y haz clic en la pestaña Models (Modelos).

Paso 3: Configurar la Clave API

  1. Desplázate hacia abajo en la página de Modelos para encontrar la sección OpenAI API Key.
  2. Pega tu Clave API personalizada en el cuadro de entrada.
  3. Haz clic en el botón Verify (Verificar) a la derecha. (Si la verificación falla en este punto, no te preocupes, ya que aún no hemos configurado la URL).
  4. ⚠️ Nota importante: Asegúrate de que el Cursor Tab oficial y otros interruptores de suscripción de pago anteriores estén en el estado adecuado (si estás utilizando una API de terceros gratuita, se recomienda desactivar los interruptores de los modelos oficiales).

Paso 4: Configurar la URL base (Anular el endpoint predeterminado)

Este es el paso más crucial, ya que determina a dónde se envían tus solicitudes:

  1. Debajo del cuadro de entrada OpenAI API Key, encuentra la opción Override OpenAI Base URL.
  2. Expande esta opción e ingresa la dirección de tu interfaz personalizada en el cuadro.

    💡 Formato de ejemplo:

    • CodingplanX AI: https://api.codingplanx.ai/v1
  3. Después de completarlo, debes presionar la tecla Enter para guardar la configuración.

Paso 5: Agregar nombres de modelos personalizados (Opcional pero recomendado)

Si el modelo que estás utilizando no está en la lista predeterminada de Cursor (ej., deepseek-coder), debes agregarlo manualmente:

  1. Desplázate hasta la parte superior de la página de Modelos y encuentra la sección Model Names.
  2. Haz clic en + Add Model (Agregar modelo).
  3. Escribe el nombre de tu modelo con precisión (ej., deepseek-chat), luego presiona Enter para confirmar.
  4. Activa el interruptor junto al modelo que acabas de agregar, y se recomienda desactivar otros modelos que no uses para evitar seleccionar el equivocado.

✅ Prueba y verificación

Después de la configuración, necesitamos probar si funciona:

  1. Regresa a la interfaz de edición de código.
  2. Presiona Ctrl + L (Windows) o Cmd + L (macOS) para abrir la ventana de Chat a la derecha.
  3. En la parte inferior de la ventana de chat, haz clic en el nombre del modelo que se muestra actualmente y cambia al modelo que acabas de configurar (ej., gpt-4o o deepseek-chat).
  4. Envía un saludo simple, por ejemplo: "¿Quién eres? Por favor, dime la versión de tu modelo."
  5. Si la IA responde con normalidad y rapidez, ¡felicidades, la configuración fue exitosa! 🎉

❓ Preguntas frecuentes y resolución de problemas

SíntomaCausa posibleSolución
Tiempo de espera de conexión / 404 No encontradoError de formato de URL base.Verifica si a la URL le falta el sufijo /v1, o si se agregó /chat/completions por error. El formato correcto debe ser https://xxx.com/v1.
Modelo no encontradoEl nombre del modelo solicitado no es compatible con tu canal API.Verifica si el nombre del modelo seleccionado en Cursor coincide exactamente con el nombre admitido por tu proveedor de API (distingue entre mayúsculas y minúsculas).
Autenticación fallidaClave API incorrecta o saldo insuficiente.Verifica si la Clave (Key) se copió por completo (sin espacios adicionales) y ve al panel del proveedor de API para verificar el saldo de tu cuenta.
No se puede usar Cursor Tab (Autocompletar)La finalización de código en línea de Cursor (Copilot) utiliza un modelo independiente.Las API de terceros solo pueden hacerse cargo de las funciones de Chat y Cmd+K. La finalización de Cursor Tab generalmente todavía depende de los servicios oficiales de Cursor o requiere una configuración especial que admita modelos FIM.

📝 Conclusión: Dominar la configuración de API personalizadas no solo reduce significativamente el costo de usar la programación asistida por IA, sino que también te permite cambiar libremente entre varios LLM de vanguardia. Si este tutorial te resultó útil, ¡no dudes en compartirlo con tus amigos desarrolladores!