DeepSeek Harness (dsh) con gateway: guía 2026

Respuesta corta: para usar DeepSeek Harness (dsh) a través de HopBase, añada un proveedor personalizado a $DSH_HOME/settings.yaml con api: openai-completions, baseURL: https://api.hop-base.com/v1 y apiKeyEnv: HOPBASE_API_KEY, enumere los IDs de modelo que desee y ejecute export HOPBASE_API_KEY=sk-your-key antes de iniciarlo; la Web UI de dsh acepta los mismos tres valores en Settings → Models → Add a custom provider. Como dsh es independiente del modelo, un único gateway permite que la misma instalación ejecute DeepSeek, GLM, Kimi, Grok, GPT y Claude en paralelo, con cuotas, auditoría de llamadas y atribución de costos en una sola consola. Hay dos excepciones de protocolo importantes: grok-4.20-multi-agent necesita openai-responses, y los modelos Claude necesitan anthropic-messages con la base URL https://api.hop-base.com (sin /v1); de lo contrario, obtendrá un 404. Si no se encuentra un modelo, tome los IDs exactos que su clave puede usar de GET /v1/models. Las llamadas a funciones y el reporte de uso en streaming se verificaron de extremo a extremo contra el gateway de producción.

DeepSeek Harness (dsh) es el runtime de agentes oficial y de código abierto de DeepSeek, publicado el 13 de agosto de 2026 junto con V4-Pro, que superó las 100,000 estrellas en GitHub en dos días. Su filosofía de diseño cabe en una frase: todo es un plugin, incluido el propio bucle del agente. Eso hace que dsh sea menos un asistente de programación cerrado y más un runtime modular para construir agentes de programación.

Por qué poner un gateway detrás de dsh

dsh es independiente del modelo: un proveedor personalizado solo necesita una base URL, un protocolo y los IDs de modelo. Conectarse directamente con cada proveedor implica gestionar varias claves, facturas y rutas de red; con un único gateway de HopBase, la misma instalación de dsh ejecuta DeepSeek, GLM, Kimi, Grok, GPT y Claude en paralelo, con cuotas, auditoría de llamadas y atribución de costos en una sola consola.

Configuración en tres minutos

Añada un proveedor a $DSH_HOME/settings.yaml:

providers:
  hopbase:
    api: openai-completions
    baseURL: https://api.hop-base.com/v1
    apiKeyEnv: HOPBASE_API_KEY
    models:
      - id: deepseek-v4-flash-202605
      - id: glm-5.3
      - id: grok-4.6

Exporte la clave antes de iniciarlo: export HOPBASE_API_KEY=sk-your-key. ¿Prefiere una interfaz gráfica? En la Web UI de dsh, vaya a Settings → Models → Add a custom provider y complete los mismos tres valores; tome los IDs de modelo de GET /v1/models.

Referencia rápida de protocolos

Familia de modelos	`api`	`baseURL`
Chat de DeepSeek / GLM / Kimi / Grok / GPT	`openai-completions`	`https://api.hop-base.com/v1`
grok-4.20-multi-agent (solo Responses)	`openai-responses`	`https://api.hop-base.com/v1`
Modelos Claude	`anthropic-messages`	`https://api.hop-base.com` (sin /v1)

Lo que verificamos

Las dos cosas de las que dependen los agentes están verificadas de extremo a extremo contra el gateway de producción de HopBase: las llamadas a funciones (las solicitudes de herramientas con el formato de dsh devuelven tool_calls correctos) y el reporte de uso en streaming (el último fragmento incluye el uso completo; la facturación concilia línea por línea con el uso reportado por el proveedor).

Solución rápida de problemas

Error	Causa	Solución
404 "platform does not support this API path"	Modelo Claude con el protocolo de OpenAI	Use `anthropic-messages` con la base URL sin /v1
model not found / 503	El modelo no está en ninguno de los grupos de su clave	Use los IDs exactos de `GET /v1/models`
401 invalid api key	Clave truncada o espacios sobrantes	Vuelva a copiar la clave desde la consola

Encontrará todos los parámetros y más clientes en la guía de integración de DeepSeek Harness; regístrese para crear una clave y empezar.