Configuración de API Key de Cursor — Guía de Claves de Terceros de APIMaster

Cursor es un editor de código potenciado por IA. APIMaster.ai proporciona APIs compatibles con OpenAI y Claude Messages. Puedes conectarte a través de la configuración integrada de claves de terceros de Cursor o mediante extensiones oficiales.

Comienza con Obtener Clave API. Mantén las claves solo en tu máquina, no las compartas en chats o capturas de pantalla.

---

Qué enfoque usar

Objetivo	Recomendado
Modelos no integrados en Cursor (ej. DeepSeek)	Configuración de Cursor → Modelos + ID de modelo personalizado
GPT-5.4 / GPT-5.5 facturados vía APIMaster	Extensión Codex + configuración ~/.codex
Claude Sonnet / Opus facturados vía APIMaster	Extensión Claude Code + configuración ~/.claude
Agente de codificación general	También funciona Cline (Compatible con OpenAI)

---

Requisitos previos

1. Cursor instalado (Windows / macOS / Linux).
2. La función de clave API de terceros de Cursor requiere Cursor Pro.
3. Clave API de APIMaster desde la consola.
4. ID del modelo objetivo desde el marketplace.

---

Método 1: Configuración de Cursor (bueno para DeepSeek, etc.)

Funciona para IDs de modelo que Cursor no incluye de forma nativa (ej. deepseek-v4-pro).

Paso 1: Clave API y URL Base

1. Abre Configuración de Cursor → Modelos (o Claves API).

2. Activa Clave API de OpenAI y pega tu clave de APIMaster.

3. Activa Sobrescribir URL Base de OpenAI:

   https://apimaster.ai/v1
   

   Incluye el sufijo /v1.

Paso 2: Añadir un modelo personalizado

1. Haz clic en Añadir modelo.
2. Introduce un ID de modelo del marketplace (ej. deepseek-v4-pro).
3. Actívalo y selecciónalo en el selector de modelos de chat.

Paso 3: Probar

Envía un mensaje en el chat de Cursor. Si el pie de página muestra deepseek-v4-pro y recibes una respuesta, el tráfico está pasando por APIMaster.

---

Límites del Método 1: GPT y Claude integrados

Con la misma clave de terceros en Configuración, los nombres de GPT y Claude a menudo se comportan de manera diferente:

1. No se pueden añadir nombres integrados duplicados

Añadir gpt-5.4, gpt-5.5 o algunos IDs de Claude puede fallar — Cursor ya reserva esas ranuras para las rutas oficiales de Cursor.

Solución: Usa el Método 2 (extensiones Codex / Claude Code) para GPT y Claude en APIMaster.

2. Errores de GPT integrado después de configurar APIMaster

Seleccionar el GPT-5.4 / GPT-5.5 integrado de Cursor mientras la URL Base Sobrescrita apunta a APIMaster puede dar error — la ruta integrada entra en conflicto con tu URL base personalizada.

Solución: Usa el panel lateral de Codex, no los modelos GPT integrados.

3. Claude integrado usa la cuota de Cursor Pro

Claude/Sonnet integrado en el chat principal generalmente factura Cursor Pro, no tu clave de APIMaster.

Solución: Usa el panel de la extensión Claude Code.

---

Método 2: Extensiones Codex y Claude Code (GPT y Claude)

Instala las extensiones oficiales y apúntalas a APIMaster usando los mismos archivos de configuración que la línea de comandos.

Instalación

• Codex – El agente de codificación de OpenAI (openai)
• Claude Code para VS Code (Anthropic)

Configurar APIMaster

Extensión	Guía	Archivos	URL Base
Codex (GPT)	Configuración de Codex	~/.codex/config.toml, auth.json	https://apimaster.ai/v1
Claude Code	Configuración de Claude Code	~/.claude/settings.json	https://apimaster.ai (sin /v1)

Consulta cada guía para ver el contenido completo de los archivos y las instrucciones de copia de seguridad.

Uso en Cursor

Abre el icono de la barra de actividades de CODEX o CLAUDE CODE y chatea allí — la facturación usa APIMaster, separada de los modelos integrados de Cursor.

---

Solución de problemas

Problema	Solución
Sin opción de clave API / sobrescritura	Requiere Cursor Pro
401	Verifica la clave; sin espacios adicionales
404 modelo	Coincide exactamente con el ID del marketplace
No se puede añadir gpt-5.4	Usa la extensión Codex
Claude sigue usando cuota Pro	Usa el panel de Claude Code
Codex apunta a OpenAI	Reemplaza completamente los archivos de configuración ~/.codex según la guía

---

Relacionados

• Resumen de Agentes
• Cline
• Cursor (guía breve)
• Obtener Clave API