> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DeepSeek Harness

> DeepSeek Harness mit AIHubMix verbinden: npm-Installation, OpenAI-kompatibler Anbieter, auto oder feste Modelle und Test einer Agent-Anfrage.

DeepSeek Harness (Befehl `dsh`) ist das Open-Source-Framework von DeepSeek für Coding Agents. Es bietet Arbeitsbereiche, Terminal, Dateibearbeitung, Skills, Planung und eine Web UI. Über die OpenAI-Chat-Completions-kompatible Schnittstelle kann es AIHubMix verwenden.

<Info>
  Diese Anleitung wurde am 14. August 2026 mit DeepSeek Harness `0.1.0-rc.6` getestet. Harness befindet sich in der Entwickler-Vorschau, daher können spätere Versionen Felder oder UI-Details ändern.
</Info>

<h2 id="summary">
  Zusammenfassung
</h2>

Für die Integration sind vier Werte erforderlich:

| Einstellung                  | Wert                      |
| ---------------------------- | ------------------------- |
| Provider ID                  | `aihubmix`                |
| Base URL                     | `https://aihubmix.com/v1` |
| API protocol                 | `openai-completions`      |
| API key environment variable | `AIHUBMIX_API_KEY`        |

<Frame>
  <img src="https://mintcdn.com/aihubmix/pPBGbuf_Qo9bMEMd/public/en/deepseek-harness/01-models-aihubmix-configured.png?fit=max&auto=format&n=pPBGbuf_Qo9bMEMd&q=85&s=9a11531222d056d05d6ee6030eddb595" alt="AIHubMix ist auf der Models-Seite von DeepSeek Harness konfiguriert" width="1280" height="720" data-path="public/en/deepseek-harness/01-models-aihubmix-configured.png" />
</Frame>

<h2 id="requirements">
  Welche Voraussetzungen gibt es?
</h2>

* Ein aktiver [AIHubMix API Key](https://console.aihubmix.com/token)
* Node.js `22.19.0` oder neuer, einschließlich Node.js 24+
* Netzwerkzugriff auf die npm Registry und `https://aihubmix.com`

```bash theme={null}
node --version
npm --version
```

<h2 id="install">
  Wie wird DeepSeek Harness installiert?
</h2>

Installieren Sie das veröffentlichte npm-Paket, ohne das Quellrepository zu klonen:

```bash theme={null}
npm install -g @deepseek-ai/dsh
dsh --version
```

Bei `dsh: command not found` führen Sie `npm config get prefix` aus und prüfen, ob das zugehörige `bin`-Verzeichnis in `PATH` enthalten ist.

<h2 id="start-web-ui">
  Wie wird die Web UI gestartet?
</h2>

Führen Sie den Befehl im Projektverzeichnis aus, das als Arbeitsbereich dienen soll:

```bash theme={null}
dsh web --port 3080
```

Öffnen Sie `http://127.0.0.1:3080` und wählen oder erstellen Sie bei der ersten Verwendung einen Arbeitsbereich.

<h2 id="configure-provider">
  Wie wird der AIHubMix-Anbieter konfiguriert?
</h2>

Öffnen Sie **Settings > Models > Add a custom provider**.

<Frame>
  <img src="https://mintcdn.com/aihubmix/pPBGbuf_Qo9bMEMd/public/en/deepseek-harness/03-add-custom-provider.png?fit=max&auto=format&n=pPBGbuf_Qo9bMEMd&q=85&s=e5f609447d3c979a65235ecc1b0382d0" alt="Formular für einen benutzerdefinierten Anbieter in DeepSeek Harness" width="1280" height="720" data-path="public/en/deepseek-harness/03-add-custom-provider.png" />
</Frame>

| Feld         | Empfohlener Wert          | Hinweise                                                                      |
| ------------ | ------------------------- | ----------------------------------------------------------------------------- |
| Provider ID  | `aihubmix`                | Bezeichner in Kleinbuchstaben, bei Bedarf `aihubmix-gateway`                  |
| Display name | `AIHubMix`                | Name im Modellselektor                                                        |
| Base URL     | `https://aihubmix.com/v1` | Muss `/v1` enthalten                                                          |
| API protocol | `openai-completions`      | OpenAI-Chat-Completions-kompatibles Protokoll                                 |
| API key      | Ihr AIHubMix API Key      | Harness speichert ihn als Zugangsdaten und zeigt den Klartext nicht erneut an |

Der endgültige Endpunkt lautet `https://aihubmix.com/v1/chat/completions`.

<Warning>
  Tragen Sie nicht den vollständigen Pfad `/chat/completions` in Base URL ein.
</Warning>

<h2 id="add-models">
  auto oder ein anderes Modell hinzufügen
</h2>

Wählen Sie nach Eingabe von Base URL und API Key **Fetch available models**. Harness ruft `GET https://aihubmix.com/v1/models` auf und zeigt die verfügbaren Modell-IDs an.

<Frame>
  <img src="https://mintcdn.com/aihubmix/pPBGbuf_Qo9bMEMd/public/en/deepseek-harness/07-discover-models.png?fit=max&auto=format&n=pPBGbuf_Qo9bMEMd&q=85&s=7fdeeb8c4ba8400910bcabe1e7b50a78" alt="Verfügbare AIHubMix-Modelle in DeepSeek Harness" width="1280" height="720" data-path="public/en/deepseek-harness/07-discover-models.png" />
</Frame>

Für den ersten Verbindungstest können Sie nur `auto` mit dem Anzeigenamen `Auto` hinzufügen. Für ein bestimmtes Modell wählen Sie es aus der Liste oder geben über **Add model** die genaue Modell-ID ein. Der grafische Modellselektor zeigt nur Modelle, die im aktuellen Provider-Katalog registriert sind.

<Frame>
  <img src="https://mintcdn.com/aihubmix/pPBGbuf_Qo9bMEMd/public/en/deepseek-harness/04-add-auto-model.png?fit=max&auto=format&n=pPBGbuf_Qo9bMEMd&q=85&s=0c1e93d53cf9840d5c5885dc192b0d80" alt="AIHubMix-Modell auto manuell hinzufügen" width="1280" height="720" data-path="public/en/deepseek-harness/04-add-auto-model.png" />
</Frame>

Speichern Sie mit **Create provider**.

<h2 id="auto-vs-specific-models">
  auto vs. festes Modell
</h2>

| Auswahl         | Einsatz                                                                   |
| --------------- | ------------------------------------------------------------------------- |
| `auto`          | Erster Verbindungstest oder automatische Modellauswahl durch AIHubMix     |
| Feste Modell-ID | Feste Modellfunktion, Version oder reproduzierbares Ergebnis erforderlich |

Beide Varianten verwenden denselben Provider, dieselbe Base URL und denselben API Key. Beim Modellwechsel muss der Anbieter nicht neu erstellt werden.

<h2 id="environment-variables">
  API Key in einer Umgebungsvariable speichern
</h2>

Bearbeiten Sie `$HOME/.dsh/settings.yaml`:

```yaml theme={null}
llm-pi-ai:
  providers:
    aihubmix:
      displayName: AIHubMix
      apiKeyEnv: AIHUBMIX_API_KEY
      api: openai-completions
      baseURL: https://aihubmix.com/v1
      models:
        - id: auto
          name: Auto
          contextWindow: 1000000
          maxTokens: 32768

agent-default-model:
  provider: aihubmix
  model: auto
```

```bash theme={null}
export AIHUBMIX_API_KEY='sk-***'
dsh web --port 3080
```

Wenn der Schlüssel aus der Startumgebung stammt, zeigt die Einstellungsseite einen schreibgeschützten Hinweis, ohne den Wert offenzulegen.

<Frame>
  <img src="https://mintcdn.com/aihubmix/pPBGbuf_Qo9bMEMd/public/en/deepseek-harness/02-aihubmix-provider-details.png?fit=max&auto=format&n=pPBGbuf_Qo9bMEMd&q=85&s=a18af7f6409268331dcb4ddfa7d78568" alt="Details des AIHubMix-Anbieters in DeepSeek Harness" width="1280" height="720" data-path="public/en/deepseek-harness/02-aihubmix-provider-details.png" />
</Frame>

Starten Sie Harness nach einer Änderung der Umgebungsvariable neu.

<h2 id="verify-chat">
  Modell auswählen und Unterhaltung testen
</h2>

Schließen Sie Settings und wählen Sie unten rechts im Eingabefeld **Auto** oder ein anderes hinzugefügtes Modell.

<Frame>
  <img src="https://mintcdn.com/aihubmix/pPBGbuf_Qo9bMEMd/public/en/deepseek-harness/05-select-auto-model.png?fit=max&auto=format&n=pPBGbuf_Qo9bMEMd&q=85&s=82577ac5295eebc0ef6e4945f75f5ffe" alt="Auto im Modellselektor von DeepSeek Harness" width="1280" height="720" data-path="public/en/deepseek-harness/05-select-auto-model.png" />
</Frame>

```text theme={null}
Reply with exactly: AIHubMix connection successful
```

Die erwartete Antwort bestätigt die Verbindung zwischen Harness, dem OpenAI-Chat-Completions-kompatiblen Endpunkt und AIHubMix.

<Frame>
  <img src="https://mintcdn.com/aihubmix/pPBGbuf_Qo9bMEMd/public/en/deepseek-harness/06-live-chat-success.png?fit=max&auto=format&n=pPBGbuf_Qo9bMEMd&q=85&s=f5fe3902c1c2f57b84b34b739b258394" alt="Erfolgreiche AIHubMix-Antwort in DeepSeek Harness" width="1280" height="720" data-path="public/en/deepseek-harness/06-live-chat-success.png" />
</Frame>

<h2 id="headless-test">
  Headless-Test ausführen
</h2>

```bash theme={null}
export AIHUBMIX_API_KEY='sk-***'
dsh --profile headless \
  'Reply with exactly DSH_AIHUBMIX_OK and do not use tools.'
```

Bei Erfolg wird `DSH_AIHUBMIX_OK` ausgegeben.

<h2 id="troubleshooting">
  Häufige Fragen
</h2>

<h3 id="missing-credential">
  Warum zeigt Harness MISSING\_CREDENTIAL?
</h3>

Harness hat `AIHUBMIX_API_KEY` nicht aus der Startumgebung erhalten. Setzen Sie die Variable und starten Sie Harness aus demselben Terminal.

<h3 id="models-401">
  Warum liefert die Modellsuche 401?
</h3>

Prüfen Sie, ob der API Key gültig ist und keine zusätzlichen Leerzeichen oder Zeilenumbrüche enthält. Die Anfrage verwendet Bearer-Authentifizierung.

<h3 id="only-auto">
  Warum ist Auto das einzige Modell im Selektor?
</h3>

Der Selektor zeigt nur registrierte Modelle des aktuellen Provider-Katalogs. Öffnen Sie **Settings > Models > AIHubMix > Edit** und verwenden Sie **Fetch available models** oder fügen Sie die genaue Modell-ID manuell hinzu.

<h3 id="unknown-model">
  Warum meldet Harness UNKNOWN\_MODEL?
</h3>

Der aktuelle Provider-Katalog enthält diese Modell-ID nicht. Modell-IDs unterscheiden Groß- und Kleinschreibung. Verwenden Sie den exakten Wert aus der Modellsuche.

<h3 id="connection-timeout">
  Warum läuft die Verbindung in ein Timeout?
</h3>

Prüfen Sie DNS, das Organisationsnetzwerk und den lokalen Proxy. Wenn nur der Browser den Systemproxy nutzt, setzen Sie `HTTP_PROXY`, `HTTPS_PROXY` und `NODE_USE_ENV_PROXY=1` im Terminal, das `dsh` startet.

<h2 id="security">
  Sicherheitshinweise
</h2>

* Speichern Sie API Keys nicht in Git, Screenshots oder gemeinsam genutzten Skripten
* Verwenden Sie den Zugangsspeicher von Harness oder `AIHUBMIX_API_KEY`
* Geben Sie bei der Fehlersuche keinen vollständigen API Key aus
* Nutzen Sie die Secret-Verwaltung der CI-Plattform für Umgebungsvariablen

***

Zuletzt aktualisiert: 2026-08-14