Cómo instalar DeepSeek Harness en 5 minutos (npx dsh)

Qué es DeepSeek Harness y por qué importa

El 13 de agosto de 2026 se lanzó DeepSeek Harness v0.1, el agente de codificación (harness de orquestación) oficial de DeepSeek, pensado para competir en la misma liga que Claude Code y OpenAI Codex. Si ya has usado herramientas de este tipo, sabrás que el diferencial no está solo en el modelo, sino en el motor que orquesta modelos, herramientas, sesiones y sandboxes. DeepSeek Harness apuesta por una filosofía radical: "Everything is a plugin".

En la práctica esto significa que no tienes un monolito lleno de flags. Los modelos, las tools, las skills, las sesiones, los sandboxes, los filesystems, los loops, la orquestación e incluso la UI son módulos intercambiables. Puedes dialogar con cada uno por separado y el resultado es un harness que se adapta a tu flujo sin que pelees contra la arquitectura.

Todo lo que verás aquí es reproducible en tu máquina hoy: instalar el CLI `dsh`, levantar la vista web y conectar el modelo. Nada de teoría: en cinco minutos lo tienes corriendo.

• Lanzado el 13 de agosto de 2026 como Developer Preview, con licencia MIT.
• CLI oficial: `dsh`, ejecutable vía `npx @deepseek-ai/dsh`.
• Construido sobre Node.js y el meta-framework Cordis.

Requisitos previos: solo necesitas Node.js

La única dependencia real para instalar DeepSeek Harness es un runtime de Node.js en tu máquina. Como el CLI se distribuye mediante `npx`, ni siquiera necesitas una instalación global: `npx` descarga y ejecuta el paquete bajo demanda desde el registro de npm.

Para trabajar a gusto te recomiendo Node.js en una versión LTS (mejor que la v18 como mínimo). Si usas nvm, `nvm install --lts` te deja un entorno limpio y aislado. Antes de seguir, verifica que Node y npm están disponibles, porque `npx` no funcionará si el binario de node no está en tu `PATH`.

No necesitas instalar nada más para la primera prueba. Para el modo web ni siquiera hace falta Docker ni un sandbox: el arranque con un modelo en la nube solo requiere una API key de un proveedor como OpenRouter o la API oficial de DeepSeek.

• Node.js (preferiblemente una versión LTS) y npm/npx disponibles.
• Una API key para el proveedor de modelo (p. ej. OpenRouter para V4 Flash).
• Git instalado si vas a probar skills o plugins de la comunidad.
• No uses `sudo` para instalar paquetes globales: usa `npx` o el instalador de tu distro.

Instalación paso a paso con npx @deepseek-ai/dsh

La instalación es una sola línea. Abre tu terminal y ejecuta lo siguiente:

```bash npx @deepseek-ai/dsh web ```

Ese comando lanza la interfaz web del harness sin instalar nada global en tu sistema. `npx` comprueba, descarga y ejecuta el paquete `@deepseek-ai/dsh` al vuelo, una filosofía ligera que cuadra con el carácter plugin de la herramienta y te evita problemas de versiones globales.

Si prefieres una instalación persistente y tener el binario `dsh` disponible en cualquier sesión, hazlo de forma global con npm (idealmente a través de nvm para no tocar el sistema root). Usa una o la otra para no liar el `PATH`; a lo largo de la guía me limitaré a la sintaxis `npx`, que funciona igual en cualquier máquina.

```bash # Arranque instantaneo de la web del harness (sin global install) npx @deepseek-ai/dsh web # Instalacion global para tener el binario dsh npm install -g @deepseek-ai/dsh dsh web # Ver la version instalada dsh --version ```

Primer arranque de la interfaz web

Cuando ejecutes `npx @deepseek-ai/dsh web`, el CLI levanta un servidor local y abre la interfaz web del harness en tu navegador, normalmente en `http://localhost:3001` (el puerto exacto se indica en el log de arranque). Esa UI es otro plugin más: si no te convence la cambias, pero para la primera toma de contacto es la vía más cómoda para ver qué está pasando.

En la primera ejecución el harness te pedirá que definas el modelo y la clave de acceso. No te bloquees en este paso: el flujo de bienvenida es directo, así que solo tienes que pegar la API key del proveedor y elegir modelo.

Mi consejo para el primer uso es ignorar por unas horas las opciones avanzadas (plugins, sandboxes, filesystems). Arranca con la configuración mínima, genera algo de código y solo después vete añadiendo modularidad. Evitarás aislarte en un mar de flags antes de tener una base sólida.

• El arranque levanta un servidor local con la interfaz web del harness.
• La primera vez te pedirá la API key del proveedor de modelo.
• Prueba un prompt mínimo antes de tocar plugins y sandboxes.

Configurar el modelo: DeepSeek V4 Flash vía OpenRouter o la API oficial

El modelo ideal para empezar es DeepSeek V4 Flash. Si no tienes la API oficial de DeepSeek, OpenRouter es la vía más rápida: guardas una variable de entorno con tu key, defines el modelo y ya puedes arrancar. El precio publicado desde el 16 de agosto de 2026 es de unos $0.22 por millón de tokens de entrada en cache miss y $1.32 por millón de salida en horario de pico ($0.66 en horario valle).

Detalle técnico que importa: tanto V4 Pro como V4 Flash traen el thinking/chain-of-thought habilitado por defecto en la API. Eso mejora el razonamiento, pero consume tokens ocultos de razonamiento que suman a la factura. Si vas a correr el harness en modo agente con loops largos, hazlo presente en el presupuesto.

En tu instalación la clave estará típicamente en una variable de entorno que apunta al proveedor y al nombre del modelo. Un clásico error de arranque es tener la key en otra sesión de terminal; déjala en un `.env` por defecto o expórtala en la misma sesión donde vas a lanzar `dsh`.

```bash

# Guarda la key del proveedor en tu env export OPENROUTER_API_KEY="sk-or-..." # O define la configuracion para no repetirla cada vez cat > config.env <<EOF DEEPSEEK_API_KEY=sk-... # API oficial # Modelo por defecto del harness DEEPSEEK_MODEL=deepseek-v4-flash EOF dsh run --model deepseek-v4-flash "respuesta minima de prueba" ```

Primeros comandos: del "hola mundo" a un agente en tu repo

Una vez configurado el modelo, la mejor manera de validar la instalación es con una petición mínima. No intentes todavía loops ni sandboxes: una sola tarea concreta te dirá si el cableado de API, modelo y harness está sano.

Cuando el harness responda correctamente, pasa a un caso real: dale un archivo y pídele una modificación concreta. Ahí verás la potencia de V4 Flash en ingeniería; los benchmarks publicados de Terminal Bench 2.1 (Flash 82.7 vs Pro 72.1) y DeepSWE lo colocan incluso por delante de V4 Pro en varias tareas, pese a ser el modelo de entrada.

Abre una sesión y explora los módulos con la ayuda del propio CLI. Recuerda la filosofía: cada pieza es un plugin, así que las combinaciones de agente se montan reconociendo qué skills y tools tienes activas.

```bash

# Validacion minima del cableado dsh run "Responde SOLO con: instalacion ok" # Trabajo real sobre un archivo del repo dsh run "Anade manejo de errores a src/api.ts y ejecuta los tests" # Explorar capacidades y plugins dsh --help dsh plugins list ```

Resolución de errores comunes de instalación

El error más frecuente al instalar es `npx: command not found` o `node: not found`. Significa que el binario de Node no está en tu `PATH`. La solución es reinstalar Node.js con tu gestor de paquetes o nvm, o exportar el directorio `bin` de tu instalación manual.

El segundo bloqueo clásico es el fallo de autenticación en el primer arranque (HTTP 401 o `Invalid API key`). Verifica la variable de entorno que define la key, que no haya espacios ni caracteres raros al copiar, y que la clave sirva para el modelo V4 Flash.

Un tercer problema recurrente es que la vista web no abra porque el puerto por defecto está ocupado. Al levantar `dsh web` verás en el log el puerto usado; si falla, prueba la bandera de puerto. Como es un Developer Preview y evoluciona rápido, actualiza el paquete cuando salgan parches con `npm update` o reinstala el paquete.

• `command not found`: revisa el PATH de Node y reinstala con nvm.
• `Invalid API key`: exporta la variable en la misma sesión que lanzas el CLI.
• Web no abre: puerto ocupado o versión antigua; cambia el puerto y actualiza el paquete.

La relación con Cordis y el modelo "todo es plugin"

Bajo el capó, DeepSeek Harness está construido sobre Cordis, un meta-framework pensado para apps modulares. Cordis se encarga de la carga/descarga de plugins y de sus dependencias: los módulos cooperan mediante services y events, no con acoplamiento rígido.

Esto explica que el harness se sienta tan "carpintería": el equipo de DeepSeek Harness no inventó todo desde cero, sino que reutilizó la capa de gestión de plugins de Cordis y montó encima sus propios componentes para modelos, tools y orquestación. Es una decisión que te beneficia directamente, porque puedes traer plugins compatibles de la comunidad sin quedarte encerrado.

Para instalarlo no es imprescindible entender Cordis, pero vale la pena saberlo: cuando la web te dice "agregas un plugin de filesystem", en realidad estás jugando dentro del sistema de services y events que ya gestionaba Cordis. La regla de oro al instalar: no añadas un plugin sin saber qué events dispara y qué dependencias trae.

• Cordis gestiona el load/unload de plugins y sus dependencias.
• Los plugins cooperan entre sí mediante services y events.
• Model, tools, skills, sessions, sandboxes y UI son plugins intercambiables.

Developer Preview: lo que debes saber antes de fiarlo todo

Conviene no romantizar nada: a día de hoy DeepSeek Harness está en Developer Preview (v0.1). Puede cambiar de aquí a la release estable, puede haber rupturas entre versiones y algunas piezas anunciadas aún no están pulidas.

Esto no es un argumento en contra de usarla: al revés, es el mejor momento para aprender y contribuir. Pero si la evalúas para producción o un flujo crítico, ten un plan de salida: versiona tus configuraciones, no dependas de plugins poco probados y sigue el changelog a cada actualización.

La licencia MIT te da libertad total para forkear, usar y redistribuir. Que el producto esté en preview es parte de la curva normal de un harness joven; el mercado de estas herramientas está en plena efervescencia, así que vale la pena tenerlas en tu cinto de herramientas.

• MIT permite uso personal y comercial sin fricción.
• Developer Preview implica posibles cambios de API; versiona tus configs.
• Perfecta para personal y pruebas en repos secundarios; evalúa por separado para producción.

Preguntas frecuentes