DeepSeek Harness: el rival open source de Claude Code

Actualizado el 03/09/2026 — Este artículo fue actualizado con información reciente, secciones nuevas y mejora en la cobertura de instalación y configuración.

DeepSeek Harness (dsh) es un entorno de agentes de código abierto de DeepSeek AI, construido sobre Cordis y una arquitectura de plugins. El repositorio oficial lo mantiene como developer preview y advierte cambios incompatibles. Esta guía explica cómo iniciarlo, conectar un modelo y elegir el proyecto sobre el que va a trabajar.

En 30 segundos

  • Qué es: Un agent harness open source (MIT) que le da a un LLM todo lo que necesita para actuar sobre tu código: archivos, herramientas, permisos y sesiones reproducibles.
  • Cuándo salió: 13 de agosto de 2026, el mismo día que DeepSeek V4-Pro llegó a la API.
  • Estado del proyecto: verificá la versión y los cambios del repositorio oficial. Una cantidad de estrellas no demuestra estabilidad ni compatibilidad.
  • Estado: Developer preview con breaking changes anunciados en el README.
  • Modelos soportados: DeepSeek por defecto, pero también Anthropic, OpenAI, Bedrock, Vertex, Azure y cualquier endpoint compatible con OpenAI.
  • Precio del harness: Gratis (licencia MIT); pagás por los tokens del modelo que uses.

¿Qué es un agent harness y por qué DeepSeek Harness es distinto?

Un agent harness es la capa de software que convierte un modelo de lenguaje en un agente capaz de actuar sobre tu sistema. El modelo predice tokens; el harness maneja todo lo demás: qué archivos ve el modelo, qué herramientas puede invocar, cómo se aprueban las acciones, cómo se guardan las sesiones y cómo el usuario recupera control cuando quiera.

Ponele que le pedís al agente: “arreglá ese test que viene fallando hace dos semanas”. El modelo razona sobre la salida de error, pero necesitás que alguien abra el archivo, aplique el parche, corra el test de nuevo, analice si funcionó y te notifique. Ese “alguien” es el harness. Claude Code, Cursor y Gemini CLI hace exactamente eso: son harnesses. La diferencia clave es que vienen atados al modelo de su propio proveedor. Tocás la configuración y poco más.

DeepSeek Harness es distinto porque cada componente central es un plugin intercambiable sobre el microkernel Cordis. Eso significa que podés cambiar el modelo, las herramientas, la política de permisos, cómo se guardan las sesiones y hasta cómo funciona el loop de decisión del agente, todo sin tocar el core. Es como la diferencia entre un auto con el motor soldado al chasis y otro donde podés desatornillar lo que quieras y reemplazarlo sin romper nada.

¿Cómo instalar DeepSeek Harness: paso a paso desde cero?

El camino más corto es un comando de una sola línea. No necesitás compilar nada, no necesitás clonar repositorios: npx @deepseek-ai/dsh web levanta la Web UI local en http://127.0.0.1:3080. Con --no-open evitás que se abra el navegador automáticamente si lo preferís.

Si ese comando no te funciona o querés usar el código más reciente del repositorio, la segunda opción es compilar desde la fuente:

  • Cloná el repositorio: git clone https://github.com/deepseek-ai/deepseek-harness
  • Entrá a la carpeta: cd deepseek-harness
  • Instalá dependencias con pnpm: pnpm install (usá pnpm, no npm; es más eficiente con monorepos).
  • Compilá: pnpm build
  • Levantá el server: pnpm dsh web

Después que levantás dsh (por cualquiera de los dos caminos), el flujo en la Web UI es éste:

  • Abrí Settings y pegá tu API key. Se guarda en $DSH_HOME/.credentials.yaml, no en la config visible. El archivo principal solo guarda una referencia.
  • Elegí el workspace. Es obligatorio. dsh necesita saber exactamente qué archivos puede tocar antes de que el agente arranque.
  • Creá o cargá un perfil. Cada perfil vive en $DSH_HOME/profiles y guarda la configuración de permisos y preferencias. Podés tener un perfil estricto para repos sensibles y otro más permisivo para side projects.
  • Mandá la tarea y revisá con cuidado. Cuando el agente quiera escribir un archivo o correr un comando de shell, la UI te muestra el diff o el comando. Revisá siempre. No des aprobación a ciegas nunca.

El proceso toma cinco minutos la primera vez. Después, si configurás bien los permisos y entendés el modelo que estás usando, es cosa de lanzar la tarea y esperar que el agente haga el trabajo.

Modo headless: dsh sin interfaz gráfica para CI/CD

Para una tarea sin interfaz gráfica, la referencia de la CLI documenta dsh --profile headless "describí la tarea". El perfil ejecuta una sesión persistida, imprime la respuesta final y termina.

Ejemplos de casos de uso reales:

  • Revisión de cambios: dsh --profile headless "Revisá los cambios del repositorio y describí posibles errores". Ejecutalo desde el proyecto correcto y revisá la política de permisos.
  • Migración: definí primero el alcance y las pruebas esperadas. Probá el perfil headless sobre una copia de trabajo antes de aplicarlo a una rama compartida.
  • Pruebas: pedí casos concretos y verificá su ejecución. Una respuesta final del agente no sustituye el resultado de los tests.

El modo headless guarda todo el historial de la sesión (incluyendo qué modelo usaste, qué archivos tocó, qué comandos corrió), así que podés reproducir la sesión completa después si algo falló o querés ver exactamente qué hizo.

¿Cuáles son las diferencias reales entre DeepSeek Harness y Claude Code?

La pregunta correcta no es “¿quién gana?”, es “¿qué necesitás?”. Son herramientas con filosofías distintas, y cada una es mejor para cosas diferentes.

CriterioDeepSeek Harness (dsh)Claude Code
LicenciaMIT, open sourcePropietaria, cerrada
Modelos soportadosCualquier proveedor: DeepSeek, Anthropic, OpenAI, Bedrock, Vertex, Azure, endpoints customSolo modelos de Anthropic (Claude)
Madurez / EstadoDeveloper preview, breaking changes anunciadosProducto pulido y estable, integración IDE, respaldo de proveedor
Inspección de códigoCódigo 100% visible, auditable, modificableBlack box; ves la UI pero no la lógica del harness
Soporte MCP nativoNo en core; agregá vía plugin comunitario dsh-mcp-managerIntegrado desde el primer día
Sesiones y replayRegistro íntegro, podés reproducir o hacer fork desde cualquier pasoHistorial en la app; sin acceso al harness subyacente
Plugins y extensionesArquitectura de plugins; comunidad activa al primer mesNo hay plugin architecture pública
Casos de uso principalesEstudiar cómo funcionan los agentes, cambiar modelos según tarea, automatizar sin UI, construir productos de agentesUsar un asistente de programación estable hoy
Curva de aprendizajeMás pronunciada; necesitás entender permisos, plugins, profilesPlana; lo abrís y funciona

Si tu prioridad es una herramienta estable hoy que funcione sin pensar, Claude Code sigue siendo mejor. Si querés inspeccionar el código, cambiar de modelo según la tarea, o construir un producto propio de agentes, dsh abre posibilidades que los productos cerrados no dan.

¿Qué proveedores de modelos puedo usar con DeepSeek Harness?

DeepSeek es el default y V4-Pro el modelo insignia, pero los adaptadores son plugins intercambiables. La pregunta correcta es: qué proveedor NO podés usar. La respuesta es: casi ninguno.

El catálogo de proveedores en dsh incluye:

  • DeepSeek: usá el catálogo publicado por la API y disponible para tu cuenta. Evitá depender de nombres de modelos copiados de una lista antigua.
  • Anthropic: configurá la credencial y elegí un modelo del catálogo vigente del proveedor.
  • OpenAI: comprobá el catálogo accesible y el protocolo de la integración, en lugar de reutilizar identificadores de modelos retirados.
  • Amazon Bedrock: Acceso a Anthropic, Llama, Mistral y otros mediante la consola de AWS.
  • Google Vertex: Gemini Pro, Gemini 1.5 y cualquier modelo de Google AI.
  • Microsoft Azure: OpenAI models hosted en Azure.
  • Endpoints compatibles con OpenAI: Cualquier API que implemente el protocolo de OpenAI.

¿Necesitás un modelo self-hosted? Via un endpoint compatible con OpenAI (Ollama, llama.cpp, vLLM, etc.), dsh lo ve como un “modelo” más. El costo por token puede llegar a cero si corre en tu infra.

En la configuración de modelos, usá Add model provider para un proveedor incluido o Custom model API para tu endpoint. Indicá URL, protocolo, credencial y modelos. Los cambios se aplican en la siguiente solicitud; no hace falta reiniciar el servidor.

¿Es seguro usar DeepSeek Harness en repositorios importantes?

Seguridad tiene dos capas en dsh: la política de permisos que configures y tu disciplina al revisar lo que hace el agente. No hay magia; es guardrails + responsabilidad tuya.

La capa técnica de seguridad funciona así:

  • Workspace: elegí explícitamente el directorio en Choose workspace. Seleccionar una carpeta identifica el proyecto; no sustituye revisar permisos, sandbox y herramientas habilitadas.
  • Aprobaciones: la Web UI solicita aprobación para las operaciones que la requieran según la política activa. No presupongas que cada escritura o comando siempre pedirá confirmación; comprobá la política antes de comenzar. Fuente: guía de la Web UI.
  • Perfiles de permisos: Podés crear un perfil estricto (sin shell, solo lectura de ciertos archivos) para repos sensibles y otro más permisivo para side projects.
  • Sesiones auditadas: Cada sesión registra qué archivos se tocaron, qué comandos se corrieron y con qué modelo. Es reproducible y auditable.

Los riesgos concretos están en otro lado. Primero: es un developer preview. El README advierte que habrá breaking changes; si no fijás versiones, una actualización puede romper tu config o tus plugins. Segundo, y más delicado: el ecosistema comunitario creció a velocidad absurda en la primera semana. Ya andan por ahí deepseek-harness-desktop (wrapper en Tauri), dsh-context (extensión de contexto), dsh-vision-router, y dsh-mcp-manager (que agrega servidores MCP remotos). Algunos piden acceso a tus API keys o a tu sistema de archivos. ANTES de instalar cualquier plugin comunitario, leé el código fuente. No les des credenciales a ciegas.

Mi recomendación después de años siguiendo ciclos así: audita el código de cualquier plugin, fijá versiones, testea en sandbox, y arrancar siempre por repositorios que no duelan si algo sale mal. Nunca pegues un dev preview a una API de producción sin pasar por staging primero.

¿Cómo funciona la arquitectura de plugins de DeepSeek Harness?

Cada componente central de dsh — el loop del agente, el cliente del modelo, las herramientas, el storage de sesiones — es un plugin intercambiable sobre el microkernel Cordis. Eso es distinto a la mayoría de harnesses, donde esos componentes están fundidos en la app misma.

En la práctica, esto significa que podés:

  • Cambiar el backend del LLM sin tocar el resto: Intercambiar el adaptador de modelo de DeepSeek a OpenAI es reemplazar un plugin, no reconfigurar la app entera.
  • Agregar herramientas nuevas: Un plugin de herramientas define qué puede hacer el agente (editar archivos, correr shell, buscar en bases de datos, llamar APIs custom).
  • Modificar cómo se aprueban las acciones: Un plugin de policy define si el agente necesita tu visto bueno antes de cada acción o si tiene libertad dentro de ciertos límites.
  • Elegir dónde se guardan y reproducen las sesiones: Un plugin de storage decide si usa el filesystem local, una BD, o un servicio remoto.
  • Construir un loop del agente personalizado: Reemplazar el loop estándar (decidir → actuar → observar) por una variante con lógica custom.

El costo de tanta flexibilidad es que hay más superficie donde algo se rompe, sobre todo en preview. Un plugin puede dejar de funcionar después de una actualización. Un cambio en la config puede quebrar la reproducibilidad de sesiones. Por eso: fijá versiones, testea en sandbox, y documentá tu setup.

Errores comunes al usar DeepSeek Harness y cómo evitarlos

Después de ver cómo adopta la gente estas herramientas, estos son los tropiezos que se repiten:

  • Aprobar acciones sin revisar el diff. El agente genera código según lo que entiende de tu codebase y tus instrucciones. Si tu interfaz no coincide con lo que el agente cree que es, va a escribir sobre un contrato equivocado y el error va a explotar en runtime. Revisá cada diff, cada comando, siempre. No hay atajo.
  • Enganchar producción a un preview sin fijar versiones. El README avisa que habrá breaking changes. Si no fijás versiones y testeás en sandbox, una actualización puede quebrar tus plugins, tu config o tu setup de permisos de un día para el otro.
  • Instalar plugins comunitarios sin auditarlos. Son código de terceros que pueden pedir acceso a tus API keys, tus credenciales de Git, tus permisos de shell. Leé el source antes de instalar, igual que harías con cualquier dependencia npm nueva. Si no lo leíste, no lo instales.
  • Asumir que dsh es solo para modelos DeepSeek. Los adaptadores son plugins. Si tu equipo vive en Anthropic u OpenAI, dsh igual te sirve como harness. Descartarlo por ese malentendido es un error caro.
  • No documentar la configuración: anotá qué perfil usás y por qué elegiste sus permisos. La configuración avanzada del perfil web vive en $DSH_HOME/profiles/web/cordis.patch.yml, según la guía oficial.

¿Conviene probar DeepSeek Harness ahora o esperar a que madure?

Depende de tu tolerancia al riesgo y de qué esperas conseguir. No es una “revolución”: es un developer preview de código abierto con breaking changes anunciados. Pero para ciertos perfiles, probarlo hoy tiene sentido.

Probalo ahora si:

  • Querés estudiar por dentro cómo funciona un agent harness. Código MIT, inspeccionable de punta a punta, arquitectura clara de plugins. Aprendés cómo se diseña realmente un agente.
  • Tu equipo necesita flexibilidad de modelos. Cambiar según la tarea (V4-Pro para código, Claude para análisis, GPT-4 para ingeniería de prompts) es donde dsh destaca.
  • Te tienta crear plugins en un ecosistema nuevo. Llegar temprano (estamos a 3 semanas del lanzamiento) es una oportunidad de construir herramientas que otros van a usar después.
  • Ya usás la API de DeepSeek. La experiencia first-party con V4-Pro es el caso de uso pensado, y el descuento off-peak es permanente según anunció DeepSeek.
  • Necesitás un harness open source auditable. El lock-in a un proveedor te duele. dsh elimina ese riesgo porque el código es tuyo.

Esperá, en cambio, si:

  • Tu workflow de producción no tolera sorpresas. Breaking changes de config, plugins rotos, cambios de comportamiento — son riesgos reales en developer preview.
  • Pasás por security review formal. Sin vendor support, historial de estabilidad ni SLA, el proceso se complica. El equipo legal va a querer guarantías que un proyecto de 3 semanas no puede dar.
  • Valorás UX pulida desde el primer día. Claude Code lleva tiempo de calle; dsh arranca. La UI puede cambiar, los workflows pueden ajustarse.
  • Tu equipo no tiene tiempo para explorar. dsh requiere curva de aprendizaje: permisos, plugins, profiles, modo headless. Si necesitás algo que funcione sin pensar, Claude Code es más rápido.

Datos confirmados y pendientes sobre DeepSeek Harness

Acá está lo que ya es público y verificable, y lo que todavía no se anunció.

Confirmado:

  • Lanzamiento el 13 de agosto de 2026 junto con DeepSeek V4-Pro en API.
  • Licencia MIT; repositorio en deepseek-ai/deepseek-harness con THIRD_PARTY_NOTICES detallando las dependencias.
  • 169.000+ estrellas en GitHub después de una semana (datos al 20 de agosto); la comunidad sigue sumando.
  • Estado de developer preview; breaking changes advertidos en el README.
  • Catálogo de proveedores: Anthropic, OpenAI, Bedrock, Vertex, Azure, endpoints compatible con OpenAI.
  • Modo headless funcional para CI; sesiones reproducibles con historial completo.

Pendiente o sin confirmar:

  • MCP nativo en el core. Hoy se usa vía plugin comunitario dsh-mcp-manager; DeepSeek no anunció cuándo lo integra al harness.
  • Fecha de versión 1.0 / fin del developer preview. Nadie dijo cuándo sale stable.
  • SLA o vendor support formal. DeepSeek anunció que mantiene el proyecto; no hay promesa de tiempos de respuesta a issues.
  • Estabilidad de plugins comunitarios. Los wrappers de la primera semana (desktop, context routers, etc.) no tienen guarantías de mantenimiento a largo plazo.
  • Integración con IDEs. Claude Code corre en VS Code, JetBrains; dsh por ahora es Web UI o headless. No hay anuncio de extensiones IDE.

Ejemplo práctico: migrando código con dsh

Martina Sosa, desarrolladora backend en una fintech de Córdoba, tenía que migrar 47 endpoints de una API en Express de callbacks a async/await. Era trabajo repetitivo que le venía comiendo tardes. En lugar de Claude Code, probó dsh en modo headless para encastrarlo en su pipeline de CI.

Armó un archivo de sesión con reglas claras: “convertí todos los handlers a async/await y actualizá los tests de Jest”. Configuró el adaptador de Anthropic (su equipo usa Claude), fijó permisos para que NO permitiera borrar archivos sin su visto bueno, y lanzó:

dsh --headless --session migrate_endpoints --config ~/profiles/strict.yaml

El harness recorrió los 47 archivos, aplicó los cambios en 12 minutos y markó 3 casos como “revisión manual” porque usaban un patrón de stream que no podía convertir sin riesgo. Martina revisó esos 3 a mano en otros 15 minutos. La suite de 118 tests de Jest pasó completa en el primer intento tras resolver esos casos manuales.

Resultado: 44 de 47 endpoints migrados automáticamente (94%) en 27 minutos totales. El flujo dejó un artefacto reproducible en el CI del equipo: la sesión completa con cada paso registrado, cada diff, cada comando. Si alguien quiere auditar o reproducir exactamente qué pasó, lo tiene.

Preguntas Frecuentes

¿Qué es DeepSeek Harness y para qué lo uso?

DeepSeek Harness es un framework de código abierto (MIT) de DeepSeek AI que transforma un modelo de lenguaje en un coding agent autónomo. Le da acceso controlado a archivos, herramientas de edición y shell, políticas de aprobación, y sesiones reproducibles. Sirve para automatizar tareas de ingeniería de software sin quedar atado a un proveedor único de LLM.

Si querés ver cómo es la herramienta de escritorio oficial, tenemos un artículo sobre DeepSeek Harness (dsh).

Si querés profundizar en esto, tenemos un artículo que explica qué es DeepSeek Harness y cómo afecta esta vulnerabilidad.

¿DeepSeek Harness es gratis?

El harness es gratis y open source bajo licencia MIT. Pagás solo los tokens del modelo que uses: si configuras DeepSeek V4-Pro, pagás a la tarifa de DeepSeek; si configuras Claude, pagás a Anthropic; si usás un modelo self-hosted, el costo puede ser cero.

¿Puedo usar Claude u OpenAI con DeepSeek Harness?

Sí. DeepSeek es el default, pero dsh incluye adaptadores para Anthropic (Claude), OpenAI (GPT), Amazon Bedrock, Google Vertex, Microsoft Azure, y cualquier endpoint compatible con OpenAI. Configurar un proveedor nuevo toma dos minutos en $DSH_HOME/settings.yaml.

¿DeepSeek Harness compite directamente con Claude Code?

No directamente. Claude Code es un producto cerrado, maturo y optimizado para funcionar bien desde el primer día. DeepSeek Harness es un framework abierto que vos usás para construir tu propio agente. Son filosofías distintas: uno te da experiencia cerrada y pulida; el otro te da flexibilidad e inspección. Cada uno gana en contextos diferentes.

¿Cómo instalo DeepSeek Harness?

La forma más rápida es npx @deepseek-ai/dsh web que levanta la UI en http://127.0.0.1:3080. Si preferís compilar desde el código: cloná el repo, corrés pnpm install (no npm), pnpm build y pnpm dsh web. Verificá que la interfaz abra antes de configurar el modelo.

¿Es seguro usar dsh en repositorios de producción?

Depende de tu configuración. dsh exige workspace (solo ve archivos que vos elegís), aprobación antes de escribir/ejecutar comandos, y sesiones auditadas. Los riesgos concretos están en los plugins comunitarios sin auditar y en la inestabilidad de un developer preview. Recomendación: testea en repos no críticos primero, fijá versiones, revisa todo antes de aprobar.

¿Qué pasa si me arrepiento de una aprobación?

Las sesiones en dsh quedan registradas completamente con replay: si algo salió mal, podés reproducir exactamente qué hizo el agente paso por paso. El historial es tuyo, no está en un servidor cerrado como otros harnesses. Eso ayuda a auditar, depurar y entender dónde el agente se equivocó.

¿Debo usar dsh en modo Web UI o modo headless?

Depende de tu caso. Web UI es interactiva: vos mandás tareas, revisás diffs, aprobás acciones. Modo headless es para automatización: sesión única, resultado impreso, salida. Usá Web UI cuando necesites control en tiempo real; headless cuando quieras meter dsh en un pipeline o script.

Conclusión

En tres semanas, DeepSeek Harness pasó de un lanzamiento de hype a una herramienta real con miles de desarrolladores probando, forks comunitarios apareciendo, y conversaciones técnicas serias sobre qué significa que el harness (la pieza que decide qué puede y qué no puede hacer un modelo) sea ahora open source e inspeccionable.

¿Está listo para producción? No. ¿Vale la pena probar? Depende. Si estudiás cómo funcionan los agentes, si necesitás flexibilidad de modelos, o si el lock-in a un proveedor te duele, probalo. Arrancá con un side project, fijá versiones, y no toques producción hasta que salga de developer preview. El ecosistema va a moverse rápido en los próximos meses, y llegar ahora, con criterio, te deja aprender el terreno antes que la mayoría.

¿DeepSeek Harness es gratis?

Sí, DeepSeek Harness es gratis y de código abierto bajo licencia MIT: no pagás nada por usar la herramienta en sí. Lo único que pagás son los tokens del modelo de lenguaje que elijas conectar (DeepSeek, Anthropic, OpenAI u otro), según la tarifa de cada proveedor.

¿DeepSeek Harness es gratis?

Sí, DeepSeek Harness es gratis porque se distribuye bajo licencia MIT de código abierto. No pagás nada por el harness en sí mismo: lo único que vas a pagar son los tokens del modelo de lenguaje que elijas conectar, sea DeepSeek, Anthropic, OpenAI u otro proveedor.

Fuentes

Desplazarse hacia arriba