DeepSeek Harness mit QCode einrichten

Verbinden Sie DeepSeek Harness (dsh) 0.2.2-rc.1 über Custom model API mit QCode.cc: OpenAI Chat für GPT und chinesische Modelle, Anthropic Messages für Claude.

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

Zuletzt überprüft: 2026-11-09 · 📄 Laut offizieller Dokumentation (DeepSeek Harness 0.2.2-rc.1, am 2026-11-04 auf npm und GitHub veröffentlicht; die Repository-Dokumentation wurde am 2026-11-09 gelesen)

Auf einen Blick¶

DeepSeek Harness befindet sich in der Entwicklervorschau. Die offizielle README sagt: "THERE WILL BE COMPATIBILITY-BREAKING CHANGES." Gleichen Sie die von Ihnen eingesetzte Version mit dieser Seite ab.

Welches Protokoll¶

Das API protocol eines eigenen Providers muss mit dem Protokoll des Gateways übereinstimmen. Die Auswahl bietet drei Optionen: OpenAI Chat Completions, OpenAI Responses und Anthropic Messages, gespeichert als openai-completions, openai-responses und anthropic-messages. Ein Provider spricht ein Protokoll, daher braucht ein Gateway mit zwei Protokollen zwei Provider.

QCode bietet Claude nur über das Anthropic-Protokoll und GPT nur über die OpenAI-Protokolle; die vier chinesischen Modellfamilien funktionieren über beide. Siehe Endpunkte und API-Pfade. Daraus ergeben sich zwei Provider:

Die Provider-IDs sind frei gewählte Namen. Verwenden Sie die Modell-IDs von qcode.cc/models Zeichen für Zeichen; die chinesischen IDs stehen auch unter Chinesische Modelle. Hängen Sie kein / an eine Base-URL und setzen Sie keine claude-…-IDs hinter die OpenAI-Base-URL.

Installation¶

DeepSeek Harness benötigt Node.js 24.9 oder neuer (das npm-Paket deklariert node >=24.9.0, und die Versionshinweise zu v0.2.2-rc.1 sagen: "Raise the minimum supported Node.js version to 24.9."). Installieren Sie Node.js und führen Sie aus:

npx @deepseek-ai/dsh web

Der Befehl startet die Web-Oberfläche standardmäßig auf http://127.0.0.1:3080 und öffnet sie bei lokalem Start im Standardbrowser. Ein SSH-Start gibt nur die Host-URL aus. Mit --no-open läuft der Server ohne Browserfenster.

Für den Start aus einem Repository-Checkout:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

$DSH_HOME ist das Datenverzeichnis des Harness; standardmäßig ~/.dsh, sofern Sie nicht die Umgebungsvariable DSH_HOME setzen. Lesen Sie vor dem Start den offiziellen Sicherheitshinweis.

Konfiguration¶

Modelländerungen wirken ab der nächsten Anfrage, ohne den Server neu zu starten.

Die Web-Oberfläche folgt der Sprache des Browsers. Die Schritte unten nennen die englischen Bezeichnungen; in der deutschen Oberfläche heißen sie:

1. Öffnen Sie die Web-Oberfläche, dann Settings → Models, und wählen Sie Add model provider.
2. Wechseln Sie die Karte zu Custom model API. Sie ist für ein Relay, ein Firmen-Gateway, einen selbst betriebenen Server oder jeden Provider gedacht, der im installierten Katalog fehlt.

3. Füllen Sie das Formular für den ersten Provider:

4. Provider ID: qcode (kleingeschrieben; die ID ist dauerhaft, wählen Sie sie bewusst)

5. Display name: QCode (optional)
6. Base URL: https://api.qcode.cc/openai/v1
7. API protocol: OpenAI Chat Completions
8. API key: Ihr QCode-Key (beginnt mit cr_)
9. Wählen Sie in der Liste Models des Formulars (die offizielle Anleitung nennt sie Modellkatalog) Add model und tragen Sie die Modell-IDs ein, etwa deepseek-v4-pro und gpt-6-sol. Fetch available models fragt den Endpunkt nach seinen Modellen; das ist nur eine Erleichterung, und laut offizieller Anleitung funktionieren von Hand eingetragene IDs genauso, wenn der Abruf fehlschlägt oder nichts listet. Auf QCode listet der OpenAI-Endpunkt die GPT-Modelle, daher tragen Sie die chinesischen IDs von Hand ein.
10. Wählen Sie Create provider. Wiederholen Sie den Vorgang dann mit Provider ID qcode-claude, Display name QCode Claude, Base-URL https://api.qcode.cc/api, API protocol = Anthropic Messages, demselben Key und dem Modell claude-sonnet-5 und wählen Sie erneut Create provider.
11. Öffnen Sie die Modellauswahl und wählen Sie ein Modell. Die Auswahl macht das Modell zugleich zum Standard für neue Sitzungen.

Keys sind nur beschreibbar: Nach dem Speichern erhält die Seite nur eine maskierte Beschreibung, niemals den Klartext. Der Key liegt in $DSH_HOME/.credentials.yaml, in den Einstellungen bleibt nur sein Verweis.

Was die Seite schreibt¶

Zur Orientierung: Dieselben Provider sehen in $DSH_HOME/profiles/<profile>/cordis.patch.yml so aus. Beim Standardstart mit dsh web ist <profile> gleich web, der Pfad also $DSH_HOME/profiles/web/cordis.patch.yml. Dieses Dokument schreibt die Seite für Sie; bearbeiten Sie es von Hand nur, wenn Sie eine Einstellung brauchen, die das Formular nicht anbietet.

- id: llm-pi-ai
  config:
    providers:
      qcode:
        displayName: QCode
        apiKeyEnv: QCODE_API_KEY
        api: openai-completions
        baseURL: https://api.qcode.cc/openai/v1
        models:

          - id: deepseek-v4-pro
          - id: gpt-6-sol
      qcode-claude:
        displayName: QCode Claude
        apiKeyEnv: QCODE_CLAUDE_API_KEY
        api: anthropic-messages
        baseURL: https://api.qcode.cc/api
        models:

          - id: claude-sonnet-5

apiKeyEnv ist ein Verweis auf die Anmeldedaten: Die Seite leitet ihn aus der Provider ID ab (qcode → QCODE_API_KEY, qcode-claude → QCODE_CLAUDE_API_KEY) und speichert den eingegebenen Key unter diesem Namen. Der offizielle Eintrag zu MISSING_CREDENTIAL sagt: speichern Sie den Provider-Key über die Models-Seite oder setzen Sie die referenzierte Umgebungsvariable. Eine Cordis-Konfigurationsüberschreibung ersetzt die gesamte Konfiguration des Eintrags, behalten Sie beim Bearbeiten einer bestehenden Überschreibung also Ihre anderen Provider.

Verbindung überprüfen¶

1. Wählen Sie ein hinzugefügtes Modell in der Modellauswahl und senden Sie eine kurze Nachricht wie ping.
2. Öffnen Sie probe.qcode.cc, geben Sie Ihren QCode-Key ein und prüfen Sie, dass die Anfrage mit diesem Modell erscheint.
3. Um Key und Pfad ohne dsh zu prüfen:

KEY="cr_your_key"

# OpenAI Chat Completions provider
curl -sS https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "content-type: application/json" \
  -d '{"model":"deepseek-v4-pro","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

# Anthropic Messages provider
curl -sS https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

Fehlerbehebung¶

Bekannte Einschränkungen¶

• Entwicklervorschau: Konfigurationsfelder und Verhalten können sich zwischen Versionen ändern; diese Seite wurde gegen 0.2.2-rc.1 geprüft, die Version, die npm am 2026-11-09 als latest führt.
• Das Formular hat kein Feld für die compat-Schalter; setzen Sie sie auf der Route in cordis.patch.yml, wie in der offiziellen Anleitung beschrieben.
• Ein von Hand eingetragenes Modell deklariert keine Reasoning-Stufen, bis Sie sie ergänzen, und bleibt rein textbasiert, bis Sie in seinen Model options Image wählen (siehe die Abschnitte der offiziellen Anleitung zu Bildeingabe und Reasoning-Aufwand).

Weiterführende Dokumentation¶

• Endpunkte und API-Pfade — Tabelle „Protokoll × Modellfamilie"
• Chinesische Modelle — GLM / Kimi / DeepSeek / Qwen: IDs und Pfade
• CodeWhale (DeepSeek-TUI) — ein weiterer Terminal-Agent mit beiden Protokollen
• Übersicht der Tool-Kompatibilität — welches Tool welches Protokoll spricht
• T3 Code — eine Oberfläche, die Claude Code und Codex steuert
• DeepSeek-Harness-Leitfaden auf qcode.cc — Hintergrund und Anwendungsfälle

Enterprise →