Última verificación documental: 29 de julio de 2026. Esta página funciona como mapa de decisiones; no se ejecutó una sesión de agente ni una solicitud API facturable.
Integrar DeepSeek en un flujo de desarrollo significa conectar un cliente, una aplicación o una automatización con un modelo de DeepSeek. Esa conexión puede servir para redactar código, explicar un fragmento, proponer pruebas, resumir un cambio o solicitar una acción estructurada. No significa que el modelo conozca automáticamente el repositorio, pueda abrir archivos, ejecute comandos o tenga acceso a GitHub, GitLab, Visual Studio Code, un servidor o una canalización de despliegue.
El acceso real depende de la capa que lo rodea. Un editor decide qué archivos envía; un agente de terminal expone herramientas; una acción de CI prepara el diff; y tu servidor conserva la clave y llama a la API. DeepSeek recibe el contexto que esas piezas le proporcionan y devuelve texto o una solicitud de herramienta. El cliente, no el modelo, controla los permisos y ejecuta las acciones.
Esta distinción evita dos errores frecuentes: presentar la compatibilidad de API como una integración nativa y atribuir a DeepSeek funciones que pertenecen a una extensión de terceros. También permite evaluar por separado al modelo, al cliente, al proveedor del repositorio y a la infraestructura propia.
Aviso de independencia: DeepSeek Español es un sitio independiente y no oficial. No pertenece a DeepSeek ni representa a la empresa. Las herramientas de edición, terminal, repositorios y CI/CD citadas en esta guía son productos de terceros, salvo la API y la plataforma que DeepSeek identifica expresamente como propias. Una receta publicada en la documentación de DeepSeek no convierte una extensión o un agente externo en un producto oficial.
Elige la guía adecuada
| Necesidad | Guía especializada | Cuenta necesaria para probar |
|---|---|---|
| Agente abierto en terminal | DeepSeek con OpenCode | DeepSeek API key y saldo |
| Claude Code mediante endpoint Anthropic-compatible | DeepSeek con Claude Code | DeepSeek API key y saldo |
| Modelo de terceros dentro de Copilot Chat | DeepSeek en GitHub Copilot Chat | GitHub Copilot + DeepSeek API key |
| Integración propia en backend | Referencia de la API | DeepSeek API key y saldo |
Tres vías de conexión que no son equivalentes
| Vía | Qué proporciona | Quién controla el acceso | Qué debes comprobar |
|---|---|---|---|
| API oficial de DeepSeek | Modelos alojados y endpoints compatibles con formatos OpenAI y Anthropic | Tu aplicación y tu cuenta de API | Modelo, parámetros, coste, errores, términos y tratamiento de datos |
| Cliente o extensión de terceros | Interfaz de editor o terminal, selección de archivos y herramientas | El cliente, su configuración y el sistema operativo | Editor, permisos, telemetría, almacenamiento de la clave y reputación del proveedor |
| Modelo autoalojado | Pesos ejecutados con una infraestructura elegida por el equipo | El operador de esa infraestructura | Licencia, modelo exacto, hardware, servidor de inferencia, seguridad y compatibilidad |
Un modelo autoalojado no llama a la API oficial por el mero hecho de llevar el nombre DeepSeek. Puede tener otro tamaño, cuantización, límite, plantilla de chat o comportamiento. De la misma forma, una extensión compatible con un endpoint no queda auditada ni respaldada automáticamente por DeepSeek. Registra siempre qué cliente, versión, modelo y proveedor intervienen.
Estado actual de la API para desarrollo
Los identificadores principales documentados para proyectos nuevos son deepseek-v4-flash y deepseek-v4-pro. Ambos admiten modo con pensamiento y sin pensamiento, salida JSON y llamadas a herramientas. La documentación oficial indica una ventana de contexto de 1 millón de tokens y un máximo de salida de 384.000 tokens; son límites técnicos, no una recomendación para enviar una base de código completa.
| Aspecto | V4 Flash | V4 Pro |
|---|---|---|
| Orientación práctica | Tareas frecuentes, iteración y control de coste | Problemas complejos que merecen una evaluación adicional |
| Pensamiento | Activado o desactivado; esfuerzo high o max | Activado o desactivado; esfuerzo high o max |
| JSON y tool calls | Admitidos | Admitidos |
| Contexto documentado | 1M tokens | 1M tokens |
DeepSeek anunció la retirada de los aliases históricos deepseek-chat y deepseek-reasoner para el 24 de julio de 2026 a las 15:59 UTC. A 29 de julio, la documentación operativa solo enumera los IDs V4 explícitos. No uses los aliases en una integración nueva; su respuesta actual no se probó con una clave válida. Puedes ampliar el contexto técnico en nuestra página sobre DeepSeek V4.
Compatibilidad de API no significa paridad total
La API ofrece un formato compatible con OpenAI y otro compatible con Anthropic. Esto permite reutilizar SDK y configurar clientes que acepten una URL base y una clave personalizadas. Sin embargo, «compatible» no significa que cada parámetro, tipo de contenido o herramienta de esos ecosistemas tenga el mismo comportamiento.
En el formato Anthropic, por ejemplo, la documentación enumera campos plenamente admitidos, ignorados y no admitidos. Las imágenes, documentos, ejecución de código y herramientas MCP no deben darse por disponibles solo porque el cliente pueda enviarlos. Algunos nombres de modelos también se mapean a modelos DeepSeek. Antes de adoptar un cliente, comprueba las funciones concretas que utilizarás y diseña una prueba de compatibilidad; una pantalla que se abre correctamente no demuestra que todo el protocolo funcione.
Editores, asistentes de terminal y agentes
La documentación oficial mantiene recetas para varios agentes y asistentes de programación, entre ellos Claude Code, GitHub Copilot y OpenCode. Las propias páginas advierten que los agentes son de terceros y que DeepSeek no garantiza su eficacia ni seguridad. La integración consiste normalmente en dirigir el cliente al endpoint compatible, facilitar una clave de DeepSeek y mapear modelos; el agente sigue siendo responsable de leer archivos, mostrar cambios y ejecutar herramientas.
DeepSeek publicó una integración específica de V4 Flash mediante Responses API. Nuestra guía de DeepSeek con Codex incluye configuración aislada, una prueba funcional, coste y límites.
Visual Studio Code y otras interfaces de editor
No existe una capacidad universal llamada «integración nativa con VS Code» que otorgue acceso automático a un proyecto. Hace falta una extensión concreta. La guía oficial de integración con GitHub Copilot describe una extensión de terceros que añade V4 Flash y V4 Pro al selector de modelos de Copilot Chat. Requiere sus propios requisitos y una clave de la API. Antes de instalarla, verifica editor, versión, editor de la extensión, código publicado, permisos, política de actualizaciones y forma de custodiar la clave.
Una extensión puede enviar el archivo activo, una selección, resultados de búsqueda o más partes del espacio de trabajo. Concede solo el alcance necesario. Excluye secretos, certificados, archivos de entorno, datos personales y repositorios no autorizados. Si la extensión usa otro modelo para describir imágenes, como ocurre en determinados flujos, interviene un proveedor adicional y debes evaluarlo por separado.
Agentes de terminal
Un agente de terminal puede resultar más potente porque combina el modelo con lectura de archivos, búsqueda, edición y comandos. También aumenta el impacto de un error. Trabaja primero en una rama, limita el directorio, bloquea secretos y exige confirmación para instalar paquetes, alterar infraestructura, modificar migraciones, publicar artefactos o ejecutar comandos destructivos. Revisa el diff y ejecuta las pruebas antes de aceptar.
Configurar el endpoint Anthropic de DeepSeek para Claude Code es una conexión documentada, pero Claude Code continúa siendo software de un tercero. Las variables de entorno no deben guardarse en el repositorio. Usa un gestor de secretos o el mecanismo seguro del entorno, aplica rotación y separa claves de desarrollo, CI y producción.
La receta oficial de Claude Code documenta además el uso de su herramienta Web Search mediante la API de DeepSeek. Esa capacidad pertenece a ese flujo configurado y puede generar solicitudes y consumo adicionales; no implica que una llamada estándar a Chat Completions navegue por internet. En cualquier otro cliente, la búsqueda solo existe si la integración la implementa y la autoriza expresamente.
Repositorios y CI/CD
DeepSeek no observa GitHub, GitLab ni otro repositorio por sí mismo. Una aplicación, bot o trabajo de CI debe recuperar el evento y preparar la entrada. Para revisar una solicitud de cambios, envía el diff necesario, reglas del proyecto y resultados relevantes, no todo el repositorio. La salida debe quedar como comentario o borrador revisable, nunca como aprobación de seguridad.
- Usa un token del repositorio con permisos mínimos y duración limitada.
- Ignora contenido no confiable que intente cambiar las instrucciones desde un comentario, archivo o issue.
- No permitas que texto generado decida si una compilación crítica puede desplegarse.
- Mantén análisis estático, pruebas, revisión humana y protección de ramas.
- Registra modelo, prompt, commit y resultado para poder reproducir el análisis.
Usos razonables dentro del ciclo de software
El modelo es más útil como generador y transformador de borradores que como autoridad. Puede explicar código proporcionado, proponer una implementación, elaborar casos de prueba, resumir un cambio, convertir una especificación en una lista de comprobación o preparar documentación. Cada salida necesita evidencia y validación proporcional al riesgo.
| Tarea | Entrada mínima útil | Validación necesaria |
|---|---|---|
| Explicar código | Fragmento, lenguaje y contexto de ejecución | Comparar con el comportamiento y dependencias reales |
| Generar una función | Contrato, tipos, errores y restricciones | Revisión, pruebas y análisis de seguridad |
| Proponer tests | Requisitos y casos límite conocidos | Comprobar que los tests pueden fallar y cubren el contrato |
| Revisar un diff | Cambio, archivos relacionados y normas | Herramientas estáticas y revisor responsable |
| Redactar documentación | API, ejemplos ejecutables y versión | Ejecutar ejemplos y contrastar con el código |
| Clasificar errores | Log minimizado, versión y pasos | Reproducir; no confundir hipótesis con causa |
Para un proceso más amplio, consulta DeepSeek en ingeniería de software. Si quieres construir el cliente en lugar de configurar uno existente, la guía para crear una aplicación con DeepSeek cubre la arquitectura de una aplicación propia.
Llamada mínima desde Node.js
Este ejemplo usa el SDK de OpenAI con la URL base de DeepSeek. La clave se lee en el servidor y no aparece en el navegador ni en el código fuente. Instala el paquete con npm install openai y define DEEPSEEK_API_KEY fuera del repositorio.
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.DEEPSEEK_API_KEY,
baseURL: "https://api.deepseek.com",
});
const sourceCode = `
export function divide(a, b) {
return a / b;
}`;
const completion = await client.chat.completions.create({
model: "deepseek-v4-flash",
messages: [
{
role: "system",
content: "Revisa el fragmento. Separa hechos, riesgos e información ausente.",
},
{
role: "user",
content: "Lenguaje: JavaScript\nObjetivo: detectar errores\nCódigo:\n" + sourceCode,
},
],
stream: false,
reasoning_effort: "high",
thinking: { type: "enabled" },
});
console.log(completion.choices[0].message.content);En una aplicación real faltan timeout, cancelación, reintentos con espera, control de tamaño, observabilidad y tratamiento de errores. Valida que existe una respuesta antes de usarla. Para tareas repetibles, fija una rúbrica y conserva ejemplos de evaluación. Nuestra guía de la API de DeepSeek reúne los conceptos básicos de autenticación y peticiones.
Tool calls: el modelo solicita, tu aplicación decide
Las llamadas a herramientas permiten describir funciones como read_file, run_tests o get_build_status. El modelo puede devolver el nombre y los argumentos de una función, pero no implementa ni ejecuta esa función. Tu código debe validar el esquema, comprobar la identidad, aplicar una lista permitida, ejecutar en un entorno aislado y devolver el resultado.
const tools = [
{
type: "function",
function: {
name: "get_test_status",
description: "Obtiene el estado de una ejecución permitida",
parameters: {
type: "object",
properties: {
run_id: { type: "string" },
},
required: ["run_id"],
additionalProperties: false,
},
},
},
];
const messages = [
{ role: "user", content: "Comprueba el estado de la ejecución build-123." },
];
const response = await client.chat.completions.create({
model: "deepseek-v4-flash",
messages,
tools,
});
const requestedCall = response.choices[0].message.tool_calls?.[0];
// Validar nombre, argumentos, usuario y run_id antes de ejecutar nada.No expongas una función genérica capaz de ejecutar cualquier comando, leer cualquier ruta o solicitar cualquier URL. Los argumentos son datos no confiables aunque los produzca el modelo. Si la acción modifica código, dependencias, incidencias o infraestructura, muestra el cambio exacto y solicita aprobación. El modo estricto de tool calls es una función beta con endpoint y restricciones propios; ayuda con el formato, no sustituye permisos ni validación.
Cómo elegir entre V4 Flash y V4 Pro
No elijas solo por el nombre. Prepara un conjunto de tareas representativas con resultados esperados: correcciones pequeñas, refactorizaciones, pruebas, explicaciones y revisión de cambios. Ejecuta ambos modelos con el mismo contexto y puntúa exactitud, cumplimiento de instrucciones, errores, latencia y coste total.
- V4 Flash: buen candidato inicial para interacciones frecuentes y tareas bien delimitadas.
- V4 Pro: candidato para problemas más complejos cuando la evaluación demuestra una mejora que justifica coste y latencia.
- Modo sin pensamiento: útil para transformaciones sencillas y respuestas rápidas; verifica calidad.
- Modo con pensamiento: puede ayudar en tareas difíciles, pero incrementa tokens y no garantiza corrección.
El contexto de 1M tampoco obliga a llenarlo. Recuperar archivos relevantes suele reducir ruido, exposición y coste. Divide tareas largas y resume resultados verificables. Consulta los precios de DeepSeek API antes de estimar un despliegue, ya que pueden cambiar.
Seguridad y privacidad del código
Al usar la API alojada, el contenido seleccionado se transmite a DeepSeek Open Platform para generar la respuesta solicitada. No describas ese flujo como local, privado por defecto o de retención cero. DeepSeek procesa las Entradas delegadas para prestar la API, pero la documentación pública revisada no especifica para los usuarios finales de la aplicación la región exacta de tratamiento o almacenamiento, el plazo general de conservación ni el uso de esas Entradas para entrenamiento. No debe inferirse esta información de la política del servicio directo, que excluye expresamente las aplicaciones de terceros. El desarrollador sigue siendo responsable de informar a sus usuarios, establecer una base jurídica adecuada y evaluar las obligaciones de seguridad, privacidad y transferencia aplicables.
- No envíes claves, tokens, certificados, datos de clientes ni código sin autorización.
- Filtra archivos como
.env, historiales, volcados, registros y configuraciones de producción. - Guarda la clave en el servidor o en el almacén seguro del cliente aprobado; nunca en JavaScript del navegador.
- Separa cuentas y claves por entorno, limita gasto y rota credenciales.
- Trata repositorios, issues y documentación recuperada como fuentes de posible inyección de instrucciones.
- Ejecuta código generado solo en un entorno aislado, sin secretos ni acceso innecesario a la red.
- Revisa licencias, atribuciones y posible similitud con código ajeno antes de publicar.
Consulta además nuestra guía de seguridad y la política de privacidad. En sectores regulados o proyectos críticos, una revisión jurídica y de seguridad es parte de la implementación, no un añadido posterior.
Despliegue y evaluación sin comprometer el repositorio
Empieza con una tarea estrecha y reversible. Durante la primera fase, permite lectura de un repositorio de prueba y genera sugerencias sin aplicarlas. Después, habilita edición en una rama aislada para un grupo pequeño. Solo amplía permisos si las mediciones muestran valor y los controles funcionan.
- Define el caso de uso, datos permitidos, acciones prohibidas y responsable.
- Crea un conjunto de evaluación con ejemplos normales, ambiguos y adversariales.
- Configura permisos mínimos, límites de coste y un interruptor de desactivación.
- Mide sugerencias aceptadas, defectos, vulnerabilidades, tiempo de revisión y coste.
- Repite la evaluación cuando cambie el modelo, cliente, prompt, extensión o herramienta.
No midas únicamente líneas generadas. Una integración puede producir mucho código y aumentar el tiempo de revisión. El indicador útil es el resultado validado: menos tiempo total sin más defectos, exposición ni carga operativa. Conserva siempre una ruta de trabajo que no dependa de la disponibilidad del modelo.
Preguntas frecuentes
¿DeepSeek tiene una extensión oficial para VS Code?
No debe deducirse eso de la compatibilidad. La documentación de DeepSeek lista recetas y una extensión para Copilot Chat, pero la identifica como producto de un tercero. Verifica siempre el editor y el repositorio concretos antes de instalar.
¿Puede DeepSeek leer todo mi repositorio?
Solo si un cliente con permisos recupera y envía ese contenido. El modelo no obtiene acceso al repositorio mediante la clave de DeepSeek. Limita rutas y selecciona el contexto mínimo.
¿La compatibilidad con OpenAI permite usar cualquier herramienta?
No. El cliente debe permitir URL base y modelo personalizados, y las funciones que use deben estar admitidas por DeepSeek. Prueba parámetros, streaming, tool calls y manejo de errores antes de depender del cliente.
¿Tool calls ejecuta comandos automáticamente?
No. La API devuelve una solicitud estructurada. Tu aplicación decide si la rechaza, pide confirmación o ejecuta una función limitada. Dar acceso de shell es una decisión del integrador.
¿Es seguro enviar código propietario?
No hay una respuesta universal. Revisa autorización, contratos, políticas oficiales, transferencias, secretos y sensibilidad del repositorio. Si no puedes enviar un archivo, exclúyelo técnicamente; no dependas solo de una instrucción escrita.
¿Un contexto de 1M reemplaza la búsqueda en el código?
No. Un contexto grande sigue teniendo límite, coste y ruido. La recuperación por símbolos, rutas, dependencias y cambios ayuda a entregar evidencia relevante y reduce exposición.
¿Puedo aceptar una corrección sin revisarla si compila?
No. Compilar no demuestra que el comportamiento, la seguridad, el rendimiento o la licencia sean correctos. Exige pruebas apropiadas, análisis estático y revisión humana.
Fuentes oficiales consultadas
- DeepSeek API: primera llamada, formatos y modelos.
- DeepSeek API: modelos, capacidades, límites y precios.
- DeepSeek API: integración documentada con Claude Code.
- DeepSeek API: integración documentada con GitHub Copilot.
- DeepSeek API: compatibilidad y límites del formato Anthropic.
- DeepSeek API: llamadas a herramientas.
- DeepSeek: términos oficiales de la plataforma abierta.
- DeepSeek: política de privacidad oficial.