AIREITERDeepSeek ya tiene su propio entorno de ejecución para agentes de programación: DeepSeek Harness (DSH). El paquete npm @deepseek-ai/dsh se publicó el 13 de agosto de 2026, coincidiendo con la disponibilidad general de V4-Pro, y está pensado para V4-Pro y V4-Flash. Se instala en cuatro pasos, funciona con una clave estándar de la API de DeepSeek e incluye un sistema de plugins. Antes de lanzarte a instalarlo, hay una advertencia importante: desde mayo existe en PyPI otro paquete, sin relación alguna, llamado deepseek-harness, que también añade un comando dsh. No son la misma herramienta.
Qué es DeepSeek Harness (DSH) y para qué sirve
Un harness para agentes de programación se ocupa de la capa que rodea al modelo: qué contexto seleccionar, cómo gestionar errores de herramientas, cuándo replantear el plan y cómo detectar que una tarea ha terminado. Por eso los resultados de un benchmark pueden variar según la configuración del harness aunque el modelo no cambie. DeepSeek publica esos ajustes junto a las evaluaciones de agentes, en vez de limitarse a dar cifras brutas del modelo.
Hay ejemplos conocidos: Claude Code actúa como harness para los modelos Claude de Anthropic; Cursor reúne varios proveedores en un IDE; y GitHub Copilot hace ese papel para modelos de OpenAI dentro de VS Code. El agente surge al combinar un modelo con un harness: un sistema capaz de editar archivos, ejecutar comandos y llamar a APIs, no solo de responder a un prompt aislado. DSH cumple esa función para V4-Pro y V4-Flash.
DSH es el harness oficial de DeepSeek, creado para V4-Pro y V4-Flash de forma comparable a como Claude Code se diseñó para Sonnet y Opus. La entrada del changelog de la beta de V4-Flash, fechada el 31 de julio, fue la primera mención pública: indicaba que los benchmarks de agentes se habían ejecutado con «DeepSeek Harness minimal mode (to be released soon)», con effort=max, top_p=0.95 y temperature=1.0.
El «minimal mode» es una configuración reducida, con el esfuerzo de razonamiento al máximo y parámetros de muestreo fijos. Su objetivo es que los benchmarks de agentes sean reproducibles, no ajustar la configuración para cada prueba. El producto completo —incluido el sistema de plugins adelantado en informes de la beta— va más allá del ejecutor de benchmarks que generó las puntuaciones publicadas.
Tanto V4-Pro como V4-Flash admiten una ventana de contexto de 1 millón de tokens y tres niveles de esfuerzo de razonamiento: low para tareas sencillas, high para el trabajo habitual con agentes y max para tareas complejas (entrada del 13 de agosto en el changelog oficial).
Cómo instalar @deepseek-ai/dsh
Necesitas Node.js 18 o posterior, el mismo requisito base que establece la guía oficial de integración con Claude Code de DeepSeek.
- Comprueba tu versión de Node:
node --version(se requiere 18 o superior; si no lo tienes en macOS, usabrew install node). - Instálalo globalmente:
npm install -g @deepseek-ai/dsh. - Configura tu clave:
export DEEPSEEK_API_KEY=<your key>, obtenida en la plataforma de DeepSeek. - Ejecuta la herramienta:
cd /path/to/my-project && dsh.
Los errores de permisos de macOS al instalar paquetes npm globales son frecuentes. La solución recomendada por npm consiste en configurar un prefijo global donde tu usuario pueda escribir (npm config set prefix ~/.npm-global). Usar sudo funciona, pero puede provocar conflictos de propiedad en futuras actualizaciones de paquetes.
No se ha anunciado un precio independiente para el software del harness. La API de modelos que utiliza cambia sus tarifas el 16 de agosto a las 16:00 UTC: la familia V4 pasa a un esquema de precios punta/valle, y la tarifa valle será la mitad de la tarifa punta (changelog oficial).
Benchmarks de V4-Pro GA: el papel de Harness
Estas son las cifras oficiales publicadas por DeepSeek en la entrada de su changelog del 13 de agosto. Todas se obtuvieron con la configuración de harness descrita anteriormente:
| Benchmark | V4-Pro GA | Beta de V4-Flash |
|---|---|---|
| Terminal Bench 2.1 | 87.9 | 82.7 |
| Cybergym | 83.3 | 76.7 |
| Toolathlon-Verified | 74.1 | 70.3 |
| DSBench-FullStack | 71.1 | 68.7 |
| DSBench-Hard | 67.2 | 59.6 |
| DeepSWE | 62.7 | 54.4 |
| NL2Repo | 61.5 | 54.2 |
| Agents' Last Exam | 25.7 | 25.2 |
| HLE (with tools) | 60.0 | — |
V4-Pro supera a Flash entre 0.5 y 8.3 puntos en estos benchmarks; las mayores diferencias aparecen en DeepSWE (+8.3) y NL2Repo (+7.3). El 87.9 de Terminal Bench 2.1 es la cifra más destacada. Una reproducción independiente con un harness público en r/LocalLLaMA situó Flash 0731 en 82.7 tras 445 pruebas, en línea con la afirmación de DeepSeek dentro de los márgenes de variación por configuración. DSBench-FullStack y DSBench-Hard son conjuntos de evaluación internos, así que esas dos filas corresponden a mediciones de la propia DeepSeek.
Todos los benchmarks publicados se ejecutaron con esfuerzo max. Para producción, DeepSeek recomienda low en tareas sencillas, high para el trabajo normal con agentes y max cuando la tarea es compleja.
@deepseek-ai/dsh frente a pip install deepseek-harness
Los dos paquetes tienen nombres casi idénticos, pero aparecieron con meses de diferencia y no guardan relación entre sí.
@deepseek-ai/dsh (npm) | deepseek-harness (PyPI) | |
|---|---|---|
| Mantenedor | DeepSeek (scope oficial) | Henry Zhang, sin afiliación |
| Primer lanzamiento | 13 de agosto de 2026 | 9 de mayo de 2026 |
| Lenguaje | Node.js | Python |
| Qué es | Harness para agentes de programación | Biblioteca adaptadora de protocolos |
| Instalación | npm install -g @deepseek-ai/dsh | pip install deepseek-harness |
| Licencia | Aún sin verificar | MIT |
El proyecto de PyPI es una biblioteca adaptadora de protocolos, no un agente de programación. Su autor documentó 16 comportamientos de la API V4 en más de 270 pruebas y los codificó en un contrato de 10 reglas disponible en cuatro formatos: biblioteca Python, CLI dsh, servidor MCP y Anthropic Skill. Estos son los tres hallazgos que más problemas pueden causar al desarrollar sobre V4:
- Los bucles de herramientas de varios turnos devuelven HTTP 400 si no se conserva
reasoning_contenten los mensajes del asistente; se reprodujo 3/3 en ambos modelos. - El endpoint
/betareasigna silenciosamentev4-proadeepseek-reasoner. - Los aciertos de caché aparecen en bloques de 256 tokens tras un prefijo de 1,024 tokens; un bucle de cinco turnos alcanzó un equilibrio del 95%, reduciendo el coste efectivo de entrada aproximadamente 50 veces.
Ambos paquetes incluyen un comando dsh, y esa es la principal fuente de confusión. Si instalaste mediante pip, tienes la biblioteca adaptadora. Si usaste npm bajo el scope @deepseek-ai, tienes el harness.
Cómo usar DeepSeek V4 como agente de programación sin DSH
Si quieres un agente de programación basado en DeepSeek antes de que la documentación de DSH se estabilice, la guía oficial de integración de DeepSeek contempla tres opciones compatibles:
| Herramienta | Configuración | Modelos DeepSeek | Mejor para | |
|---|---|---|---|---|
| Claude Code | Variables de entorno y endpoint compatible con Anthropic | V4-Pro (principal), V4-Flash (subagente) | Programación en terminal con esfuerzo máximo | |
| OpenCode | Flujo /connect, seleccionar proveedor DeepSeek | V4-Pro | Código abierto y selección interactiva de proveedor (requiere v1.14.24+) | |
| OpenClaw | `curl -fsSL https://openclaw.ai/install.sh \ | bash` | V4-Pro o V4-Flash | Asistente personal con Skills e integración de chat |
La configuración de Claude Code asigna los modelos de DeepSeek a los slots de Claude Code:
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=maxHay una peculiaridad en las asignaciones: las solicitudes de claude-sonnet se resuelven en Flash, no en Pro. La documentación de DeepSeek coloca Pro en el slot de Opus y Flash en el de Haiku. Las tres herramientas se documentan como integraciones de terceros, cuya eficacia y seguridad DeepSeek no garantiza. Para una comparativa más amplia, consulta nuestra comparativa de LLM para agentes de programación y la guía de la API de V4-Pro GA.
Preguntas frecuentes
¿Es @deepseek-ai/dsh el DeepSeek Harness oficial?
El scope @deepseek-ai de npm coincide con la organización de GitHub de DeepSeek, y la fecha de lanzamiento encaja con la ventana prometida en el changelog del 31 de julio. Publicaciones de la comunidad confirman que se puede instalar. El changelog de DeepSeek del 13 de agosto documenta la disponibilidad general de V4-Pro, pero no menciona el harness, y npm impide verificar automáticamente la página del paquete.
¿En qué se diferencian DSH y deepseek-harness de PyPI?
Son productos distintos y de mantenedores distintos. @deepseek-ai/dsh es el harness para agentes de programación de npm, publicado el 13 de agosto. pip install deepseek-harness instala una biblioteca Python independiente de adaptación de protocolos, creada por Henry Zhang (MIT, 9 de mayo), para gestionar particularidades de la API V4. Ambos incluyen un comando dsh.
¿Necesito una clave de API de DeepSeek para usar DSH?
Sí. El harness utiliza V4-Pro y V4-Flash a través de la API de DeepSeek, por lo que el uso se factura por token. El paquete npm se instala gratis; el coste procede del consumo de la API. Las tarifas de la familia V4 cambian a un esquema punta/valle el 16 de agosto a las 16:00 UTC, y la tarifa valle será la mitad de la punta.
¿Cómo se compara DSH con Claude Code?
Claude Code es un agente de programación en terminal maduro y documentado que ya funciona con DeepSeek mediante el endpoint compatible con Anthropic. La propuesta de DSH es una optimización específica para el modelo: un harness creado en torno al comportamiento del protocolo de V4, en vez de adaptado a él. Esa ventaja resulta plausible por la divulgación de la configuración de benchmarks, pero sigue sin demostrarse en uso independiente hasta que haya documentación de DSH y pruebas de la comunidad.
¿Qué diferencia hay entre un harness de IA y un agente de IA?
El harness es la capa de infraestructura: gestión de contexto, enrutamiento de herramientas y orquestación de tareas. El agente es el sistema resultante: un modelo que se ejecuta dentro de un harness y puede realizar acciones de varios pasos. Todo agente necesita un harness, pero un mismo harness puede servir a distintos modelos. Claude Code, Cursor, Copilot y DSH son harnesses; lo que los convierte en «agentes» es el modelo que los impulsa.
Estado del lanzamiento: qué está confirmado y qué procede de la comunidad
Los datos de este artículo proceden de dos niveles de evidencia.
Confirmado oficialmente (entradas fechadas del changelog de la API de DeepSeek):
deepseek-v4-proalcanzó la disponibilidad general el 13 de agosto con soporte nativo para OpenAI Responses API y tres niveles de esfuerzo de razonamiento (changelog).- V4-Flash entró en beta pública el 31 de julio, con benchmarks producidos usando «DeepSeek Harness minimal mode (to be released soon)».
- Todos los resultados de benchmarks de V4-Pro GA y la beta de V4-Flash proceden de esas entradas del changelog.
- Las tarifas de la familia V4 pasan a precios punta/valle el 16 de agosto a las 16:00 UTC.
- La guía de integración de Claude Code, OpenCode y OpenClaw es documentación oficial.
Reportado por la comunidad (publicaciones de Reddit y capturas reproducidas):
@deepseek-ai/dshse puede instalar y funciona. u/Testx01 publicó el enlace al paquete a las 12:56 UTC del 13 de agosto; u/Available_Yam_6267 lo hizo minutos después. El scope npm@deepseek-aicoincide con la organización de GitHub de DeepSeek.- La página del paquete de npm bloquea las consultas automatizadas, por lo que la versión, la licencia y los metadatos del mantenedor siguen sin confirmarse a través del registro.
«Deepseek harness is out on npm :)» — u/Testx01, r/DeepSeek, 13 de agosto
- Un mensaje reproducido de la beta interna habla de un grupo beta de 369 miembros que subió una compilación interna final el 11 de agosto y pidió a los desarrolladores de plugins etiquetar sus repositorios con
#dshantes de la beta pública del 13 de agosto. Tras el lanzamiento, los plugins podrían trasladarse a cuentas individuales. - Un informe de la comunidad citó a prensa tecnológica china en mayo, según la cual DeepSeek estaba formando un equipo específico de harness y contratando perfiles de producto para Agent Harness.
Conviene considerar las afirmaciones sobre las funciones, la CLI y los plugins de DSH como confirmadas por la comunidad hasta que DeepSeek publique documentación formal en su propio sitio.