DeepSeek Harness: Was veröffentlicht wurde und wie die Installation funktioniert

Am 13. August 2026 ging nicht nur V4-Pro allgemein verfügbar: Mit @deepseek-ai/dsh veröffentlichte DeepSeek auch seinen Coding-Agent-Harness DeepSeek Harness, kurz DSH, für V4-Pro und V4-Flash auf npm. Die Einrichtung braucht vier Schritte und einen regulären DeepSeek-API-Key; außerdem gehört ein Plugin-System zum Paket. Wichtig vor der Installation: Auf PyPI existiert seit Mai bereits ein völlig unabhängiges Python-Paket namens deepseek-harness, das ebenfalls einen dsh-Befehl bereitstellt. Es handelt sich nicht um dasselbe Tool.

Was DeepSeek Harness (DSH) eigentlich macht

Ein Coding-Agent-Harness kümmert sich rund um das Modell um die Auswahl des Kontexts, den Umgang mit Tool-Fehlern, Neuplanung und die Erkennung abgeschlossener Aufgaben. Selbst bei identischem Modell können sich Benchmark-Ergebnisse je nach Harness-Konfiguration verschieben. Deshalb legt DeepSeek bei Agent-Evaluierungen die Harness-Einstellungen offen, statt bloße Modellwerte zu nennen.

Bekannte Beispiele sind Claude Code als Harness für Anthropics Claude-Modelle, Cursor, das mehrere Anbieter in einer IDE bündelt, und GitHub Copilot als Harness für OpenAI-Modelle in VS Code. Erst die Kombination aus Modell und Harness ergibt einen Agenten: ein System, das Dateien bearbeiten, Befehle ausführen und APIs aufrufen kann, statt nur einzelne Prompts zu beantworten. Genau diese Rolle übernimmt DSH für V4-Pro und V4-Flash.

DSH ist DeepSeeks eigener Harness für V4-Pro und V4-Flash, vergleichbar damit, wie Claude Code für Sonnet und Opus ausgelegt ist. Im Changelog zur V4-Flash-Beta vom 31. Juli wurde der Name erstmals öffentlich erwähnt. Dort heißt es, die Agent-Benchmarks seien mit „DeepSeek Harness minimal mode (to be released soon)“ bei effort=max, top_p=0.95 und temperature=1.0 erstellt worden.

Der „Minimal Mode“ ist eine schlanke Konfiguration mit maximalem Reasoning-Aufwand und festen Sampling-Parametern. Sie soll Agent-Benchmarks reproduzierbar machen, statt sie für jeden Benchmark separat zu optimieren. Das vollständige Produkt geht über den Benchmark-Runner hinaus, der die veröffentlichten Werte erzeugt hat — einschließlich des in Beta-Berichten angedeuteten Plugin-Systems.

Sowohl V4-Pro als auch V4-Flash unterstützen ein Kontextfenster von 1 Mio. Token sowie drei Stufen für den Reasoning-Aufwand: low für einfache Aufgaben, high für übliche Agent-Aufgaben und max für komplexe Arbeiten (offizieller Changelog, Eintrag vom 13. August).

@deepseek-ai/dsh installieren

Voraussetzung ist Node.js 18 oder neuer — dieselbe Mindestversion, die DeepSeek in seiner offiziellen Integrationsanleitung für Claude Code nennt.

1. Node-Version prüfen: node --version (erforderlich ist 18+; falls nicht vorhanden, unter macOS brew install node).
2. Global installieren: npm install -g @deepseek-ai/dsh.
3. API-Key setzen: export DEEPSEEK_API_KEY=<your key> von der DeepSeek-Plattform.
4. Starten: cd /path/to/my-project && dsh.

Berechtigungsfehler bei globalen npm-Installationen sind unter macOS häufig. npm empfiehlt dafür einen globalen Prefix, der für den eigenen Nutzer beschreibbar ist (npm config set prefix ~/.npm-global). sudo funktioniert zwar, kann aber bei späteren Paket-Updates zu Besitzkonflikten führen.

Für die Harness-Software selbst wurde kein separater Preis angekündigt. Die Preise für die dahinterliegende Modell-API ändern sich am 16. August um 16:00 UTC: Für die V4-Familie gelten dann Peak-/Off-Peak-Tarife, wobei Off-Peak halb so viel kostet wie Peak (offizieller Changelog).

V4-Pro GA im Benchmark: Hier kommt der Harness ins Spiel

Die folgenden offiziellen Werte veröffentlichte DeepSeek im Changelog-Eintrag vom 13. August. Sie wurden sämtlich mit der oben beschriebenen Harness-Konfiguration erzielt:

V4-Pro liegt in diesen Benchmarks zwischen 0.5 und 8.3 Punkten vor Flash. Die größten Abstände zeigt es bei DeepSWE (+8.3) und NL2Repo (+7.3). Die zentrale Zahl lautet 87.9 bei Terminal Bench 2.1. Eine unabhängige Reproduktion mit einem öffentlichen Harness auf r/LocalLLaMA kam für Flash 0731 in 445 Durchläufen auf 82.7 — innerhalb der durch die Konfiguration verursachten Varianz passend zu DeepSeeks Angabe. DSBench-FullStack und DSBench-Hard sind interne Evaluierungssets; bei diesen beiden Zeilen handelt es sich also um Messungen von DeepSeek selbst.

Alle veröffentlichten Benchmarks liefen mit dem Aufwand max. Für den Produktionseinsatz empfiehlt DeepSeek low bei einfachen Aufgaben, high für gewöhnliche Agent-Arbeit und max bei komplexen Aufgaben.

@deepseek-ai/dsh oder pip install deepseek-harness?

Die beiden fast gleich benannten Pakete erschienen mit mehreren Monaten Abstand und haben nichts miteinander zu tun.

Das PyPI-Projekt ist eine Protokolladapter-Bibliothek und kein Coding Agent. Der Autor dokumentierte in mehr als 270 Versuchen 16 Verhaltensweisen der V4-API und fasste sie als Vertrag mit 10 Regeln zusammen. Verfügbar ist dieser in vier Formen: als Python-Bibliothek, dsh-CLI, MCP-Server und Anthropic Skill. Drei Erkenntnisse sind für alle relevant, die auf V4 aufbauen:

• Mehrturn-Tool-Schleifen liefern HTTP 400, wenn reasoning_content in Assistant-Nachrichten nicht erhalten bleibt — auf beiden Modellen jeweils 3/3 reproduziert.
• Der Endpunkt /beta ordnet v4-pro stillschweigend deepseek-reasoner zu.
• Cache-Treffer erscheinen nach einem Präfix von 1,024 Token in Blöcken von 256 Token; eine Schleife über fünf Turns erreichte ein Gleichgewicht von 95 % und senkte damit die effektiven Input-Kosten um ungefähr das 50-Fache.

Die größte Verwechslungsgefahr entsteht dadurch, dass beide Pakete einen dsh-Befehl mitbringen. Nach einer Installation per pip liegt die Adapter-Bibliothek vor. Bei einer npm-Installation unter dem Scope @deepseek-ai ist es der Harness.

DeepSeek V4 als Coding Agent ohne DSH nutzen

Wer einen DeepSeek-basierten Coding Agent einsetzen möchte, bevor sich die DSH-Dokumentation gefestigt hat, findet in DeepSeeks offizieller Integrationsanleitung drei unterstützte Wege:

Die Claude-Code-Konfiguration ordnet DeepSeek-Modelle den Modell-Slots von Claude Code zu:

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

Eine Besonderheit bei der Zuordnung: Anfragen nach claude-sonnet landen bei Flash, nicht bei Pro. DeepSeeks Dokumentation weist Pro dem Opus-Slot und Flash dem Haiku-Slot zu. Alle drei Tools sind als Drittanbieter-Integrationen dokumentiert, für deren Wirksamkeit oder Sicherheit DeepSeek keine Garantie übernimmt. Einen umfassenderen Vergleich finden Sie in unserem LLM-Vergleich für Coding Agents sowie im V4-Pro-GA-API-Guide.

FAQ

Ist @deepseek-ai/dsh der offizielle DeepSeek Harness?

Der npm-Scope @deepseek-ai entspricht DeepSeeks GitHub-Organisation, und das Veröffentlichungsdatum passt zum im Changelog vom 31. Juli angekündigten Zeitfenster. Community-Beiträge bestätigen, dass sich das Paket installieren lässt. Der Changelog von DeepSeek dokumentiert am 13. August zwar V4-Pro GA, nennt den Harness jedoch nicht; außerdem verhindert npm eine automatisierte Prüfung der Paket-Seite.

Worin unterscheiden sich DSH und deepseek-harness auf PyPI?

Es sind unterschiedliche Produkte von unterschiedlichen Betreibern. @deepseek-ai/dsh ist der am 13. August veröffentlichte Coding-Agent-Harness auf npm. pip install deepseek-harness installiert dagegen eine unabhängige Python-Protokolladapter-Bibliothek von Henry Zhang (MIT, 9. Mai), die Besonderheiten der V4-API behandelt. Beide stellen einen dsh-Befehl bereit.

Brauche ich für DSH einen DeepSeek-API-Key?

Ja. Der Harness nutzt V4-Pro und V4-Flash über die DeepSeek API, die Nutzung wird also tokenbasiert abgerechnet. Die Installation des npm-Pakets selbst ist kostenlos; Kosten entstehen durch den API-Verbrauch. Für die V4-Familie wechseln die Preise am 16. August um 16:00 UTC zu Peak-/Off-Peak-Tarifen, wobei Off-Peak halb so viel kostet wie Peak.

Wie schlägt sich DSH gegenüber Claude Code?

Claude Code ist ein ausgereifter und dokumentierter Terminal-Coding-Agent, der über den Anthropic-kompatiblen Endpunkt bereits mit DeepSeek läuft. DSH setzt auf modellspezifische Optimierung: einen Harness, der um das Protokollverhalten von V4 herum entwickelt wurde, statt daran angepasst zu werden. Das ist angesichts der offengelegten Benchmark-Konfiguration plausibel, aber erst dann unabhängig belegt, wenn DSH-Dokumentation und Community-Tests nachziehen.

Was ist der Unterschied zwischen einem AI-Harness und einem AI-Agent?

Der Harness ist die Infrastrukturebene: Kontextverwaltung, Tool-Routing und Aufgabenorchestrierung. Ein Agent ist das Gesamtsystem aus Modell und Harness, das mehrstufige Aktionen ausführen kann. Jeder Agent benötigt einen Harness, aber derselbe Harness kann unterschiedliche Modelle bedienen. Claude Code, Cursor, Copilot und DSH sind allesamt Harnesses; zum „Agenten“ werden sie durch das Modell, das sie antreibt.

Release-Status: bestätigt und aus der Community gemeldet

Die Angaben in diesem Artikel stammen aus zwei Evidenzstufen.

Offiziell bestätigt (DeepSeek-API-Changelog, datierte Einträge):

• deepseek-v4-pro erreichte am 13. August GA, inklusive nativer Unterstützung für die OpenAI Responses API und drei Stufen für den Reasoning-Aufwand (Changelog).
• V4-Flash startete am 31. Juli in die öffentliche Beta; die Benchmarks wurden mit „DeepSeek Harness minimal mode (to be released soon)“ erzeugt.
• Alle Benchmark-Zahlen für V4-Pro GA und V4-Flash beta stammen aus diesen Changelog-Einträgen.
• Die Preise der V4-Familie wechseln am 16. August um 16:00 UTC zu Peak-/Off-Peak-Tarifen.
• Die Integrationsanleitung für Claude Code, OpenCode und OpenClaw ist offizielle Dokumentation.

Aus der Community gemeldet (Reddit-Beiträge, reproduzierte Screenshots):

• @deepseek-ai/dsh lässt sich installieren und funktioniert. u/Testx01 veröffentlichte den Paket-Link am 13. August um 12:56 UTC; u/Available_Yam_6267 folgte wenige Minuten später. Der npm-Scope @deepseek-ai entspricht DeepSeeks GitHub-Organisation.
• Die npm-Paket-Seite blockiert automatisierte Abrufe; Angaben zu Version, Lizenz und Maintainer sind deshalb über die Registry nicht bestätigt.

„Deepseek harness is out on npm :)“ — u/Testx01, r/DeepSeek, 13. August

• Eine reproduzierte Nachricht aus der internen Beta beschreibt eine Beta-Gruppe mit 369 Mitgliedern. Diese habe am 11. August einen finalen internen Build bereitgestellt und Plugin-Entwickler gebeten, ihre Repositories vor der öffentlichen Beta am 13. August mit #dsh zu taggen. Nach dem Start sollten Plugins auf einzelne Accounts übertragbar werden.
• Community-Berichte verwiesen auf chinesische Tech-Presse, die im Mai meldete, DeepSeek stelle ein eigenes Harness-Team zusammen und suche für Agent Harness Produktrollen.

Angaben zu DSH-Funktionen, CLI und Plugins sollten als aus der Community bestätigt gelten, bis DeepSeek auf der eigenen Website formale Dokumentation veröffentlicht.