Tutorial de conexión de DeepSeek Harness (dsh)

DeepSeek Harness es el framework de ejecución de agentes de código abierto de DeepSeek (comando dsh); su idea central es «todo es un plugin»: el modelo, las herramientas, la sesión y demás capacidades las proporcionan plugins. Admite la conexión con cualquier pasarela mediante una «API de modelos personalizada»: en la descripción del grupo GPT-Azure de NextHub, DSH figura como herramienta de terceros adaptada.

Pasos de conexión

1. Instálalo e inícialo

Necesitas tener Node.js instalado (se recomienda la versión LTS oficial actual). Inicia la Web UI directamente con npx, o instálalo globalmente y arráncalo:

npx @deepseek-ai/dsh web

npm install -g @deepseek-ai/dsh
dsh web

Tras el arranque, el navegador abrirá automáticamente la interfaz de administración local.

2. Añade un proveedor personalizado (canal Claude)

Entra en Ajustes → Modelos, pulsa Añadir proveedor, cambia la tarjeta a Custom model API (API de modelos personalizada) y rellena los campos según esta tabla:

Campo	Contenido	Nota
Provider ID	nexthub	en minúsculas; no se puede renombrar después de crearlo
URL base	https://api.nexthub.cc	el protocolo Anthropic usa el dominio desnudo, sin /v1
Protocolo de la API	Anthropic Messages	corresponde al endpoint del protocolo Anthropic Messages
Credenciales (API Key)	tu ApiKey de NextHub	grupo de la familia Claude
Modelos	claude-opus-5-5, etc.	al menos uno; puedes pulsar «Obtener modelos disponibles» para descargarlos automáticamente

Después de guardar, solo tienes que elegir el modelo que acabas de añadir en la lista de modelos del cuadro de diálogo.

3. Conecta el canal GPT (opcional)

Un proveedor solo habla un protocolo, así que si necesitas GPT crea otro: escribe nexthub-gpt como Provider ID, elige OpenAI Chat Completions (u OpenAI Responses) como Protocolo de la API, escribe https://api.nexthub.cc/v1 (con /v1) como URL base, usa como API Key la clave del grupo GPT-Azure / GPT-Pro y pon gpt-5.6, gpt-6-astra, etc. como modelos.

4. Verificación

Selecciona un modelo de NextHub en el cuadro de diálogo y envía un mensaje; si responde con normalidad, la conexión se ha realizado correctamente.

Método por archivo de configuración (opcional)

La configuración anterior acaba escrito en $DSH_HOME/profiles/web/cordis.patch.yml (DSH_HOME es por defecto ~/.dsh); también puedes editar directamente este archivo:

- id: llm-pi-ai
  config:
    providers:
      nexthub:
        apiKeyEnv: NEXTHUB_API_KEY
        api: anthropic-messages
        baseURL: https://api.nexthub.cc
        models:
          - id: claude-opus-5-5
          - id: claude-fable-5

En apiKeyEnv se escribe el nombre de la variable de entorno (la clave en sí se lee de esa variable de entorno); la clave guardada desde la interfaz se almacena en $DSH_HOME/.credentials.yaml. Tras modificarla no hace falta reiniciar: surte efecto en la siguiente petición.

Los modelos visuales deben declarar sus tipos de entrada

Por defecto, los modelos introducidos a mano se tratan como texto puro. Para enviar imágenes al modelo, marca Image en Input types dentro de Model options del modelo (equivale a la configuración input: [text, image]); de lo contrario, el envío de imágenes se rechazará antes de enviarse.