DeepSeek Harness einrichten und mit einer API verbinden

DeepSeek Harness ist ein Open-Source-Coding-Agent und Agent Runtime von DeepSeek AI. Er stellt Loop, Tools, Workspace-Zugriff, Sessions, Berechtigungen und Oberfläche rund um ein Modell bereit. Das Modell selbst kommt weiterhin von einem API-Provider. Dieser Guide erklärt zuerst den DeepSeek code harness und verbindet ihn danach über den offiziellen Custom-Provider-Ablauf mit OmniaKey.

Was ist DeepSeek Harness?

DeepSeek Harness, kurz dsh, ist kein neues Sprachmodell. Es ist die Software, die ein Modell in einen Agent verwandelt, der einen Workspace versteht, Tools aufruft, Dateien editiert, Befehle ausführt, Sessions bewahrt und um Freigaben bittet.

Einige Launch-Berichte nennen es ein Open-Source-AI-Agent-Framework. Die offiziellen Materialien sind präziser: Open-Source Agent Harness, lokal ausgerichteter erweiterbarer Coding-Agent und Entwicklungs- beziehungsweise Runtime-Umgebung für Agents.

Das zentrale Prinzip lautet everything is a plugin. DeepSeek Harness basiert auf Cordis; Models, Tools, Skills, Sessions, Sandboxes, Storage, Loops, Scheduling und sogar die UI lassen sich per Konfiguration ersetzen oder neu zusammensetzen.

Der nachvollziehbare Event Stream ist mehr als ein Chatverlauf. Die Dokumentation beschreibt Resume, Fork, Search und Replay als Operationen auf demselben Session Log. Das hilft, wenn ein Agent vor seiner Antwort mehrere Tool Calls ausführt.

Was DeepSeek Harness nicht ist

• Es ist nicht DeepSeek V4 Pro oder ein anderes Modell. Harness und Modell sind getrennte Ebenen.
• Es ist noch kein stabiles Production Release. DeepSeek kennzeichnet es als developer preview und warnt vor Compatibility-breaking Changes.
• Beim npm Quick Start ist es kein gehosteter Coding-Dienst. Die Web UI bindet standardmäßig nur an Local Loopback.
• Open Source macht Modell-Inference nicht kostenlos. Das Repository nutzt die MIT License, API-Nutzung wird vom konfigurierten Provider berechnet.

DeepSeek Harness mit OmniaKey konfigurieren

Die vollständigen Werte vor den einzelnen Schritten:

Das Suffix /v1 gehört in die Base URL. Verwende weder nur den Origin noch /v1/v1 und füge nicht den vollständigen Pfad /chat/completions ein. Harness ergänzt den Operation Path selbst.

1. DeepSeek Harness installieren und starten

Installiere Node.js, öffne ein Terminal im Projektverzeichnis, das der Agent sehen soll, und starte den offiziellen npm Quick Start:

npx @deepseek-ai/dsh web

Der aktuelle Befehl startet die Web UI unter:

http://127.0.0.1:3080

Ist 3080 belegt, akzeptiert das Web Profile einen anderen Port:

npx @deepseek-ai/dsh web --port 3081

Das Startverzeichnis von dsh wird zum Standardort im Dateisystem. Der Composer bleibt jedoch gesperrt, bis du in der UI einen Workspace hinzufügst und auswählst. Wähle das Repository bewusst; der Agent kann gemäß aktiver Permission Policy File- und Shell-Tools erhalten.

2. Einen eigenen OmniaKey API Key anlegen

Öffne das OmniaKey API Keys Dashboard und erstelle einen Key nur für DeepSeek Harness. Ein separater Key lässt sich leichter begrenzen, rotieren, widerrufen und auditieren als ein Credential für mehrere Tools.

Lege den Klartext-Key nicht in Repositories, Shell History, Screenshots, Issues oder Chat Logs ab. In der Web UI gespeicherte Keys sind Write-only: DeepSeek dokumentiert, dass das Secret in $DSH_HOME/.credentials.yaml liegt, während Settings nur eine Credential Reference speichern und die Seite einen redigierten Descriptor erhält.

3. OmniaKey als Custom Provider hinzufügen

Bei einer neuen Installation bestätigst du den Internal Testing Notice mit Continue. Der nächste Onboarding-Dialog fragt nach einem offiziellen DeepSeek API Key. Wähle Configure later, weil OmniaKey als Custom Provider und nicht als eingebaute offizielle Route konfiguriert wird.

Öffne in DeepSeek Harness Settings → Models, wähle Add a custom provider und trage ein:

1. Provider ID: omniakey. Die ID muss mit einem Kleinbuchstaben beginnen.
2. Display name: OmniaKey.
3. Base URL: https://api.omniakey.com/v1.
4. API protocol: openai-completions.
5. API key: den gerade erstellten OmniaKey Key.

Die Provider ID kann nach der Erstellung nicht umbenannt werden, da gespeicherte Sessions, Defaults, Requests und Credential References sie verwenden. Display Name, Base URL, Protocol, Credential und Model List bleiben editierbar.

4. Modelle abrufen und auswählen

Wähle unter Model catalog die Aktion Fetch available models. Bei einem Custom OpenAI-compatible Provider sendet das Tool mit Bearer Authentication ein GET /models an die aktuelle Base URL. Hier wird daraus OmniaKeys GET /v1/models.

Wähle nur Modelle, die du wirklich einsetzen willst. Diese zwei IDs eignen sich als Start:

Über denselben Provider kannst du auch die aktuell von OmniaKey unterstützten Claude-, GPT-, Gemini-, Grok- und GLM-Modelle verwenden. Kopiere die exakten IDs aus dem Live-Modellkatalog; Modellnamen sind genaue Identifier, keine unscharfen Aliases.

Wenn Discovery nicht verfügbar ist, kannst du eine korrekte Model ID manuell hinzufügen. dsh benötigt mindestens ein Modell, um den Custom Provider anzulegen.

5. Workspace auswählen und sicher testen

Speichere den Provider, wähle mit Choose workspace dein Projekt, starte eine neue Session und entscheide dich im Picker für OmniaKey / deepseek-v4-pro oder OmniaKey / deepseek-v4-flash.

Beginne mit einer eng begrenzten Read-only-Aufgabe:

Prüfe package.json und fasse die verfügbaren scripts zusammen. Ändere keine Dateien und führe keine Befehle aus.

Dieser Test bestätigt Workspace, Provider, Key, genaue Model ID und den grundlegenden Response Path, bevor du Edits oder Shell Commands erlaubst. Eine Textantwort beweist nicht jedes Tool-Call-Format. Teste daher eine reversible Tool-Aufgabe, bevor du einen großen Refactor vergibst.

Model Settings gelten ab dem nächsten Request ohne Server-Neustart. Eine Session, die bereits eine Anfrage gesendet hat, behält jedoch das im Log gespeicherte Modell. Starte nach einem Provider- oder Modellwechsel eine neue Session für einen eindeutigen Test.

Optional: OmniaKey in settings.yaml konfigurieren

Für den ersten Durchlauf ist die Web UI übersichtlicher. In einer kontrollierten lokalen Umgebung kann $DSH_HOME/settings.yaml ein Provider Profile enthalten, das eine Environment Variable referenziert, statt den Key einzubetten:

export OMNIAKEY_API_KEY="your-omniakey-api-key"

llm-pi-ai:
  providers:
    omniakey:
      displayName: OmniaKey
      apiKeyEnv: OMNIAKEY_API_KEY
      api: openai-completions
      baseURL: https://api.omniakey.com/v1
      models:
        - id: deepseek-v4-pro
        - id: deepseek-v4-flash

Der Key muss in der Umgebung des Harness-Prozesses vorhanden sein. Ersetze apiKeyEnv nicht durch ein Literal Secret in settings.yaml. Die offizielle dsh-llm-pi-ai-Referenz empfiehlt Credential References, damit Secrets nicht ins Settings-Dokument gelangen.

Warum OmniaKey mit DeepSeek Harness verwenden?

DeepSeek Harness unterstützt Custom Gateways; OmniaKey macht daraus einen wiederverwendbaren Provider-Eintrag.

• Eine Konfiguration für mehrere Modellfamilien. Wechsle die genaue Model ID im Picker, ohne für jeden Vendor ein Gateway Profile anzulegen.
• Model Discovery. Harness kann OmniaKeys OpenAI-kompatible Modellliste lesen, statt alle IDs aus dem Gedächtnis einzugeben.
• Getrennte Betriebskontrollen. Gib Harness einen eigenen API Key, Quota, Rotationszyklus und Usage Trail.
• Explizite Modellidentität. OmniaKey nimmt keine Silent Model Substitution vor. Angeforderter Provider und Modell laufen tatsächlich; ein nicht verfügbarer Upstream liefert einen sichtbaren Fehler.
• Für API-Verbrauch zahlen, nicht für ein weiteres Agent-Abo. OmniaKey arbeitet Prepaid und pro Token; aktuelle Verfügbarkeit und Preise stehen im Katalog.

Das bedeutet nicht, dass OmniaKey immer besser ist als ein direkter DeepSeek Key. Wenn du nur den nativen DeepSeek Account und Endpoint brauchst, ist der Direct Provider sinnvoll. OmniaKey hilft, wenn dieselbe Harness-Installation ausgewählte DeepSeek- und andere Modellfamilien hinter einem Key und einer Base URL nutzen soll.

Fehlerbehebung

Fetch available models liefert 401

Prüfe, ob der Key von OmniaKey stammt, keine Leerzeichen enthält, aktiv ist und exakt mit https://api.omniakey.com/v1 verwendet wird. Model Discovery nutzt Bearer Authentication.

Der Provider liefert 404

Prüfe zuerst die Base URL. Typische Fehler sind ein fehlendes /v1, ein doppeltes /v1/v1 oder https://api.omniakey.com/v1/chat/completions als Base URL.

UNKNOWN_MODEL

Das gewählte Modell steht nicht in der gespeicherten Liste des Custom Providers. Rufe die Modelle erneut ab oder füge die exakte ID aus dem OmniaKey-Katalog hinzu und wähle sie in einer neuen Session.

MISSING_CREDENTIAL

Speichere den Key unter Settings → Models oder stelle sicher, dass OMNIAKEY_API_KEY in der Shell existiert, die DeepSeek Harness startet. Eine Variable in einem anderen Terminal aktualisiert den laufenden Prozess nicht.

Das geänderte Modell scheint nicht aktiv zu sein

Starte eine neue Session. Bestehende Sessions behalten nach der ersten Anfrage Provider und Modell im Append-only Log.

Text funktioniert, aber ein Agent Tool schlägt fehl

Einfache Textgenerierung und strukturierte Tool-Nutzung sind unterschiedliche Prüfungen. Beginne Read-only, untersuche den genauen Fehler in der Trajectory View und erhöhe Limits oder Rechte erst danach. Ein fehlerhafter Tool Call wird nicht durch Rotation eines gültigen API Keys behoben.

Häufige Fragen

Ist DeepSeek Harness kostenlos?

Der Quellcode steht unter der MIT License. Modell-Inference ist davon getrennt und kann über DeepSeek, OmniaKey oder einen anderen Provider API-Kosten verursachen.

Kann DeepSeek Harness DeepSeek V4 Pro über OmniaKey nutzen?

Ja. Füge OmniaKey als openai-completions Custom Provider hinzu und wähle die exakte ID deepseek-v4-pro. deepseek-v4-flash ist als günstigere DeepSeek-V4-Route ebenfalls verfügbar.

Für den 0813 Release, offizielle Peak-/Off-Peak-Preise und Beispielkosten lies den DeepSeek V4 Pro API Preisguide (English). Die neuere Flash Route, native Vision, Benchmark-Evidenz und den aktuellen V4-Pro-Status behandelt der DeepSeek V4.1 Flash Review.

Soll ich den OmniaKey Key in die eingebaute DeepSeek-Karte eintragen?

Verwende stattdessen Add a custom provider. Die Built-in Card konfiguriert die offizielle DeepSeek Route. Das Custom-Provider-Formular ist der dokumentierte Gateway-Weg und stellt Base URL, Protocol und Model List bereit.

Kann derselbe Provider Claude, GPT oder Gemini verwenden?

Ja, wenn OmniaKeys OpenAI-kompatible Oberfläche das Modell aktuell unterstützt. Rufe die Live-Liste ab und füge die exakten IDs hinzu. Protokollmerkmale können abweichen; teste das Tool-Verhalten des gewählten Modells.

Wo speichert DeepSeek Harness den API Key?

Über die Models Page gespeicherte Keys sind Write-only und liegen in $DSH_HOME/.credentials.yaml; Settings behalten nur die Credential Reference. Bei direkter YAML-Konfiguration verwende apiKeyEnv und die Prozessumgebung.

Ist DeepSeek Harness für einen stabilen Production Workflow bereit?

Behandle es derzeit als Evaluationsziel. DeepSeek nennt den Stand ausdrücklich Developer Preview und warnt vor Compatibility-breaking Changes. Pinne Versionen, sichere Konfiguration ohne Secrets und prüfe nach Upgrades den offiziellen Guide erneut.

Geprüfte Quellen

• DeepSeek Harness product page
• DeepSeek Harness GitHub README
• Official Web UI quick start
• Official model and custom-provider guide
• Official dsh-llm-pi-ai provider reference
• OmniaKey OpenAI-compatible API reference (English)
• OmniaKey live model catalog