Guía completa para conectar DeepSeek API en Cursor: configuración, modelos personalizados y revisión de costos

Actualización 2026-06-03: este artículo se ha revisado según la documentación oficial de Cursor, Cursor Pricing y la documentación de DeepSeek API. La tabla de costos usa cifras estimadas; se amplía la configuración de modelos personalizados, Base URL compatible con OpenAI, saldo/límites de tasa y diagnóstico de red corporativa.

A finales del mes pasado, al ver el extracto del banco me quedé helado: Cursor Pro había cobrado otros 20 dólares. En tres meses, solo esta herramienta me había costado 60.

Cursor funciona de verdad; la experiencia de programación asistida por IA me tiene enganchado. Pero cada factura me hace dudar: ¿vale realmente la pena? Sobre todo Ultra, a 200 dólares al mes: para un desarrollador independiente es un precio desorbitado.

Hasta que en un grupo técnico vi que alguien comentaba que se puede configurar DeepSeek API en Cursor. Mi primera reacción fue: ¿es fiable? ¿Será un lío? ¿La calidad del código aguanta?

Lo probé y la verdad es que mola.

La configuración me llevó 5 minutos. El primer mes gasté unos 3 yuanes. En calidad de código hay diferencia con Claude 3.5, pero para el día a día basta sobrado; en algunos puntos hasta sorprende.

Aquí te explico paso a paso cómo configurarlo para que puedas empezar al terminar de leer. También cuento todas las trampas, incluidas limitaciones que la documentación oficial no suele dejar claras.

¿Por qué elegir DeepSeek API?

Empecemos por el dinero.

Cursor Pro cuesta 20 dólares al mes; Ultra llega a 200. Para un desarrollador independiente no es poco, sobre todo si escribes código y depuras bugs sin un uso intensivo diario.

¿Y DeepSeek API?

Mira esta tabla de precios:

• Entrada: 2 yuanes por millón de tokens (con caché, solo 0,5 yuanes)
• Salida: 8 yuanes por millón de tokens

Puede sonar abstracto. En la práctica: unas 100-150 conversaciones al mes, con unas cientos de líneas de código por sesión. Así, el gasto mensual ronda los 2-5 yuanes.

Sí, yuanes, no dólares.

Comparativa de costos de un vistazo:

Plan	Costo mensual	Costo anual	Ahorro
Cursor Pro	$20 (¥145)	$240 (¥1740)	-
Cursor Ultra	$200 (¥1450)	$2400 (¥17400)	-
DeepSeek API	¥2-5	¥24-60	Más del 95 %

Hablamos ahora de calidad.

DeepSeek-V3 está entre los mejores modelos open source en código. En mi uso diario va bien en lógica de negocio habitual, refactorización y explicación de lógica compleja. Sigue por debajo de Claude 3.5 Sonnet, pero la brecha no impide el uso normal.

Otra sorpresa: el razonamiento de DeepSeek-R1 es muy sólido. En problemas de varios pasos o diseño de algoritmos, a veces supera lo esperado.

¿Para quién encaja?

En pocas palabras, si te reconoces en esto, DeepSeek API encaja bien:

1. Desarrollador individual / indie — presupuesto ajustado pero quieres IA en el flujo
2. Estudiante — 20 dólares al mes duelen
3. Equipo pequeño — Pro para todos sale caro
4. Uso ligero — unas pocas veces al día, no uso intensivo

Si necesitas uso intensivo y la mejor experiencia posible, mejor Cursor Pro: Tab, Composer y edición multiarchivo no los cubre bien la API personalizada de DeepSeek por ahora.

Preparativos (5 minutos)

Antes de configurar, necesitas esto. Es sencillo; sigue los pasos.

Obtener la API Key de DeepSeek

Primero regístrate en la plataforma abierta de DeepSeek y crea una API Key.

1. Abre la plataforma abierta de DeepSeek
2. Regístrate e inicia sesión (móvil, email o cuenta de GitHub)
3. En la consola, ve a «API Keys»
4. Pulsa «Create API Key» y ponle un nombre (por ejemplo «cursor-use»)
5. Copia y guarda la API Key (solo se muestra una vez)

Recarga saldo antes. Mínimo 10 yuanes; Alipay y WeChat Pay. Los usuarios nuevos suelen recibir unos 5 yuanes de prueba.

Dos modos de usar DeepSeek en Cursor

Mucha gente se lía aquí. Cursor ofrece dos formas:

1. Modo de membresía integrada
Con Cursor Pro puedes usar el modelo deepseek-r1 integrado. No configuras API propia, pero pagas Pro y consumes la cuota de Cursor.

2. Modo API personalizada (foco de este artículo)
Configuras tu DeepSeek API con tu Key y tu saldo. No hace falta Pro; controlas el gasto.

Vamos con el segundo: API personalizada.

Información que debes tener a mano

Antes de empezar:

• API Key: la cadena copiada de DeepSeek
• Base URL: https://api.deepseek.com (la usarás en la configuración)
• Nombres de modelo:
  • deepseek-chat — sin modo de razonamiento; codificación habitual
  • deepseek-reasoner — modo de razonamiento; problemas complejos

Con uno basta al principio; yo uso deepseek-chat por velocidad. Para lo complejo cambio a deepseek-reasoner.

Tutorial paso a paso (con detalle)

Empezamos. Cada paso está explicado para que no te atasques.

Paso 1: Abrir ajustes de Cursor

Dos formas:

• Atajo: Mac Cmd + ,; Windows/Linux Ctrl + ,
• Clic: icono de engranaje ⚙️ arriba a la derecha → «Settings»

En la página de ajustes, en el panel izquierdo entra en «Models».

Paso 2: Añadir modelo personalizado

En Models verás «Add model». Haz clic.

Se abre un diálogo para el nombre del modelo. Opciones:

1. deepseek-chat — codificación diaria, respuesta rápida
2. deepseek-reasoner — problemas que requieren razonamiento

Empieza con deepseek-chat. Si quieres razonamiento, añade después deepseek-reasoner.

Escribe deepseek-chat y confirma.

Paso 3: Configurar Base URL

Paso crítico; aquí falla mucha gente.

Tras añadir el modelo verás su página de configuración. Busca «Override OpenAI Base URL» y despliégala.

En el campo escribe:

https://api.deepseek.com

Algunos tutoriales añaden /v1; ambas valen:

• https://api.deepseek.com ✅
• https://api.deepseek.com/v1 ✅

Yo no pongo sufijo; más simple.

Atención: sin espacios ni saltos de línea; la URL debe coincidir al pie de la letra.

Paso 4: Introducir API Key

En la misma página, más abajo, está el campo «API Key».

Pega la Key copiada de DeepSeek.

Importante:

• Copia la Key completa, sin perder caracteres al inicio o al final
• Sin espacios antes ni después
• Sin saltos de línea

Revisa a ojo. Suele empezar por sk- y ser una cadena larga.

Paso 5: Guardar y verificar

Cuando todo esté relleno, pulsa «Save» abajo.

Cursor prueba la conexión. Tras unos segundos, un tick verde ✓ significa éxito.

Si sale una X roja ✗ o un error, ve a «Solución de problemas frecuentes» más abajo.

Paso 6: Empezar a usar

Con la configuración lista, ya puedes usarlo.

Abre el chat de Cursor (Cmd/Ctrl + L). En el desplegable de modelos verás deepseek-chat.

Selecciónalo y prueba. Por ejemplo, pídele una función sencilla.

Primera vez:
Empieza con algo simple, como «escribe en Python una función de Fibonacci». Mira velocidad y calidad del código.

Limitaciones importantes (léelas antes de celebrar)

No te emociones aún; hay límites que la documentación no siempre deja claros. Son trampas que encontré tras un mes de uso.

Solo modo Chat

Es la limitación mayor.

Con API personalizada, DeepSeek solo funciona en el chat: conversar, generar código, explicar lógica, revisar código.

Pero:

• Tienes que copiar y pegar el código al editor
• No hay «Apply» directo al archivo como en Pro
• No hay Composer (edición coordinada de varios archivos)

En resumen: solo «hablar», no «actuar» en el editor.

A mí no me afecta mucho; suelo retocar el código yo. Si dependes del apply automático de Cursor, puede frustrarte.

Tab autocompletado no disponible

El autocompletado Tab de Cursor predice la siguiente línea mientras escribes.

Solo funciona con modelos integrados de Cursor; la API personalizada no lo activa.

Tab Completion seguirá usando el modelo propio de Cursor. Sin suscripción Pro, Tab no está disponible.

No es grave: el chat cubre la mayor parte; Tab es un extra.

Compatibilidad de modelos limitada

La API personalizada de Cursor solo admite APIs en formato compatible con OpenAI.

DeepSeek encaja; otros formatos no, por ejemplo:

• Modelos de razonamiento de OpenAI (o1, o1-mini, o3-mini)
• LLM locales personalizados
• APIs que no sigan el formato OpenAI

DeepSeek es compatible; con eso basta.

Seguridad

Con API Key propia, la Key viaja en cada petición a los servidores de Cursor.

Cursor dice que no almacena la Key, pero las peticiones pasan por su backend. Tenlo presente.

Si te preocupa la seguridad:

1. Rota la API Key con regularidad
2. Pon límites de uso en la consola de DeepSeek
3. Revisa el historial de llamadas

Yo veo el riesgo acotado: si filtra la Key de DeepSeek, el daño suele ser el saldo de la cuenta, no como una Key de nube crítica.

Experiencia real y análisis de costos

Teoría aparte, un mes de uso real.

Escenarios habituales

Uso DeepSeek API sobre todo para:

1. Revisión y optimización de código
Le paso el código y pide mejoras. Detecta detalles que se me escapan.

2. Depuración
Ante un error críptico, mando el log y el código. Analiza causas y orienta el arreglo. Acierta un 70-80 %; mejor que adivinar.

3. Fragmentos de código
Para utilidades o lógica de datos, pido un borrador. No lo uso tal cual, pero ahorra tecleo; luego adapto.

4. Discusión de algoritmos
Sorpresa agradable: con deepseek-reasoner el razonamiento es claro y a veces aporta ideas nuevas.

Cálculo real de costos

Soy desarrollador frontend: 5-10 usos entre semana; fines de semana poco.

Factura del primer mes:

• Conversaciones totales: unas 120
• Promedio por conversación: 800 tokens de entrada, 500 de salida
• Consumo mensual: 96k entrada, 60k salida

Coste:

• Entrada: 96k ÷ 1000 × 2 yuanes = 0,192 yuanes
• Salida: 60k ÷ 1000 × 8 yuanes = 0,48 yuanes
• Total: 0,67 yuanes

Sí, menos de un yuan en el primer mes.

Con uso más intenso (decenas de chats al día) puede subir a 3-5 yuanes/mes. Frente a unos ¥145/mes de Cursor Pro, sigue siendo más del 95 % de ahorro.

Comparativa según hábito:

Mi hábito	DeepSeek API	Cursor Pro	Ahorro
Ligero (5/día)	¥1-2/mes	¥145/mes	~99 %
Medio (15/día)	¥3-5/mes	¥145/mes	~97 %
Intenso (30/día)	¥8-12/mes	¥145/mes	~92 %

Trucos de uso

Después de un tiempo, esto me funciona:

1. Preguntas concisas
No envíes archivos enteros; solo el fragmento relevante. Ahorra muchos tokens.

2. Aprovecha la caché
Con caché, 0,5 yuanes por millón de tokens. Varias preguntas en el mismo contexto salen más baratas.

3. Chat primero, Reasoner después
deepseek-chat para lo cotidiano. deepseek-reasoner solo para razonamiento pesado.

4. Divide preguntas largas
Varias preguntas pequeñas suelen ir mejor que una enorme y controlan el consumo.

Solución de problemas frecuentes

Problemas típicos que he visto en grupos.

Fallo de configuración o error de conexión

Síntoma: al guardar, X roja; no conecta o falla la verificación.

Pasos:

1. Revisa la API Key

   • Vuelve a copiarla en la consola de DeepSeek
   • Sin espacios ni saltos de línea
   • Debe empezar por sk-

2. Confirma saldo

   • Mira el saldo en la consola de DeepSeek
   • Recarga si hace falta

3. Prueba el sufijo /v1

   • Cambia la Base URL a https://api.deepseek.com/v1
   • A veces lo arregla

4. Revisa la red

   • Comprueba acceso a la web de DeepSeek
   • Con proxy, puede hacer falta ajustar la configuración

Conecta pero falla al invocar

Síntoma: la verificación pasa, pero al usarlo hay error.

Causas habituales:

1. Saldo insuficiente — lo más común; recarga unos 10 yuanes
2. Límite de tasa — DeepSeek limita la frecuencia; espera unos minutos
3. Nombre de modelo incorrecto — debe ser exactamente deepseek-chat o deepseek-reasoner

Respuestas muy lentas

Síntoma: tardas mucho en recibir respuesta.

Qué hacer:

1. Usa chat — deepseek-reasoner es más lento; para el día a día, deepseek-chat
2. Reduce contexto — no mandes bloques enormes; divide
3. Revisa red — los servidores de DeepSeek están en China; en condiciones normales debería ir rápido

No aparece el modelo añadido

Síntoma: configuración OK pero no sale en la lista del chat.

Qué hacer:

1. Reinicia Cursor
2. Confirma que guardaste (Settings > Models)
3. A veces la lista tarda unos segundos en actualizarse

Sugerencias de optimización avanzada

Cuando lo domines, prueba esto.

Varios modelos a la vez

Mi estrategia:

• deepseek-chat: codificación diaria, respuestas rápidas
• deepseek-reasoner: algoritmos complejos, arquitectura
• Claude 3.5 Sonnet (Pro): funciones críticas, refactors grandes

Eliges según la tarea: calidad y costo equilibrados.

Sin Pro, puedes combinar APIs de varios proveedores:

• DeepSeek para el día a día
• Cuota gratuita de OpenRouter o Groq para probar otros modelos

Uso mixto

Opción 1: ahorrar entre semana, Pro el fin de semana
DeepSeek entre semana; un día de Pro el fin de semana para proyectos personales con todas las funciones.

Opción 2: Chat con API, Tab con Pro
Si Tab es imprescindible, Pro básico y chat con API propia para ahorrar cuota de Pro.

Monitorización de costos

Revisa el uso con regularidad:

1. Consola de DeepSeek

   • Estadísticas de llamadas
   • Tendencia diaria/semanal
   • Picos inesperados pueden indicar llamadas duplicadas

2. Alertas de presupuesto

   • Aviso de uso en la consola
   • Por ejemplo «avisar si el saldo baja de 5 yuanes»
   • Evita quedarte sin servicio

3. Revisión mensual

   • Gasto total del mes
   • Ajusta hábitos si hace falta
   • Compara con Pro para confirmar que sigue compensando

Conclusión

En resumen:

Conectar DeepSeek API a Cursor no es complicado. Cinco minutos de configuración y el costo pasa de unos ¥145/mes a ¥2-5/mes; el ahorro se nota al momento.

En calidad hay brecha con Claude 3.5, pero para codificar, depurar y hacer code review basta. DeepSeek-R1 en razonamiento sorprende en algunos casos.

Puntos clave:

• ✅ Costo muy bajo: ¥2-5/mes de media, más del 95 % de ahorro
• ✅ Configuración simple: 5 minutos siguiendo los pasos
• ✅ Calidad suficiente para codificación habitual
• ⚠️ Límites: solo Chat; sin Tab ni Composer

Si eres indie o un equipo pequeño con presupuesto ajustado, pruébalo una semana y mira si encaja con tu flujo. Con 10 yuanes de recarga tienes margen de sobra para experimentar.

Regístrate ya en la plataforma abierta de DeepSeek. Cuando lo configures, cuéntanos en comentarios cómo te va en tu escenario.

Si quieres más trucos para ahorrar con herramientas de IA, sígueme: seguiré compartiendo configuraciones útiles.

El dinero ahorrado da para varios cafés.

Antes de configurar en 2026, haz esta comprobación

Necesidad	Opción recomendada	Cuándo no encaja
Chat y código a bajo costo	DeepSeek API + modelo personalizado en Cursor	Necesitas Tab y Composer completos
Pair programming intensivo con IA	Modelos integrados Cursor Pro/Ultra	Solo miras el costo por token
Red corporativa o proxy	Lee primero el diagnóstico de red de Cursor, luego configura la API	Culpar a DeepSeek sin revisar red
Equipo pequeño sensible al costo	API personalizada + presupuesto mensual de tokens	Sin gestión unificada de Keys ni control de saldo

Lecturas relacionadas: configuración y red en Cursor

• Guía de proxy corporativo en Cursor
• Diagnóstico completo de red en Cursor
• Panorama de herramientas de programación con IA 2026