DeepSeek Harness installieren und lokal nutzen

DeepSeek Harness ist der quelloffene Programmier-Agent von DeepSeek. Wie Sie ihn installieren, mit einem lokalen Modell verbinden und was an DeepSeek geht.

Stand: 2026-10-14

DeepSeek Harness, kurz dsh, ist ein quelloffener KI-Agent von DeepSeek, gedacht vor allem zum Programmieren: Er bearbeitet Dateien, führt Befehle in der Kommandozeile aus, durchsucht Dateien und das Netz und kann Aufgaben planen und an Unteragenten verteilen. Gleichzeitig ist er ein Baukasten für Entwickler, die eigene Agenten bauen wollen; fast alles daran ist als Erweiterung angelegt. Der Code steht unter der MIT-Lizenz.

Das Wichtigste vorweg: DeepSeek Harness ist eine Vorabversion für Entwickler. Es gibt bisher nur Vorabveröffentlichungen, keine stabile Version, und das Projekt sagt deutlich, was das bedeutet:

„DeepSeek Harness is in developer preview and iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.“

Quelle: DeepSeek Harness auf GitHub, gelesen am

DeepSeek Harness installieren (Windows, Mac, Linux)

Sie brauchen Node.js in Version 22.19 oder neuer, Version 23 ausgenommen. Die Startseite von DeepSeek nennt dann einen Befehl:

npx @deepseek-ai/dsh web

Er startet eine Oberfläche im Browser unter http://127.0.0.1:3080. Dort wählen Sie zuerst mit Choose workspace den Projektordner, in dem der Agent arbeiten soll. Der Befehl lädt die Fassung, die das Paketverzeichnis npm als aktuell führt. Am 14. Oktober 2026 war das die Vorabversion 0.2.0-rc.2 vom 29. September 2026, und auf sie bezieht sich diese Anleitung.

Unter Windows führt der Agent Befehle in PowerShell 7 aus, wenn sie installiert ist, sonst im eingebauten Windows PowerShell 5.1. Dort können laut Dokumentation Umlaute in Eingaben an Befehle falsch ankommen; PowerShell 7 ist deshalb die bessere Wahl.

Gibt es eine Desktop-App?

Ja, als Vorschau. Am 13. Oktober 2026 verlinkte DeepSeek auf seiner Seite zu DeepSeek Harness Installationsdateien für Macs mit Apple-Chip ab macOS 13 und für Windows ab Windows 10 auf 64-Bit-Rechnern (x64); sie liegen auf DeepSeeks eigenem Server download.deepseek.com. Bei GitHub stehen sie nicht. Für Linux und für Macs mit Intel-Prozessor verlinkt DeepSeek keine. Programme unter ähnlichem Namen, die von anderen Adressen stammen, sind nicht von DeepSeek.

Ab Werk: die Cloud von DeepSeek

In der Grundeinstellung arbeitet DeepSeek Harness mit den Modellen von DeepSeek über deren Programmierschnittstelle. Sie tragen dazu unter Settings → Models einen Schlüssel von der DeepSeek-Plattform ein. Ihre Anfragen und der Code, den der Agent liest, gehen dann an DeepSeek.

Ein lokales Modell anbinden

DeepSeek Harness ist an die Cloud nicht gebunden. Unter Settings → Models können Sie einen eigenen Server eintragen:

„Switch the card to Custom model API for a relay, a company gateway, a self-hosted server, or any provider absent from the installed catalog.“

Quelle: DeepSeek Harness, Providers, gelesen am

So geht es in Version 0.2.0-rc.2: Wählen Sie Add model provider und stellen Sie die neue Karte auf Custom model API um. Dann tragen Sie ein:

  • Eine Kennung in Kleinbuchstaben, etwa ollama. Sie lässt sich später nicht mehr ändern.
  • Die Adresse der OpenAI-kompatiblen Schnittstelle Ihres Servers, bei Ollama http://localhost:11434/v1, bei LM Studio http://localhost:1234/v1, bei llama.cpp meist http://localhost:8080/v1.
  • Das Protokoll OpenAI Chat Completions.
  • Einen Schlüssel. Lokale Server brauchen meist keinen, die verwendete Bibliothek verlangt aber einen; ein beliebiger Wert genügt.
  • Mindestens ein Modell. Fetch available models fragt den Server, welche Modelle er anbietet.

Ollama, LM Studio oder llama.cpp nennt die Dokumentation dabei nicht beim Namen, aber alle drei bieten die passende Schnittstelle an. Wichtig ist die Kontextlänge. Kennt DeepSeek Harness ein Modell nicht, rechnet es mit 262.144 Token Kontext. Ollama stellt aber unterhalb von 24 GB Grafikspeicher nur 4.096 Token ein und unterhalb von 48 GB 32.768; auf dem Mac zählt dabei nicht der verbaute Arbeitsspeicher, sondern der kleinere Teil, den macOS der Grafik zuteilt. Starten Sie Ollama deshalb mit mehr Kontext, auf Mac und Linux etwa mit OLLAMA_CONTEXT_LENGTH=65536 ollama serve; in der Ollama-App auf Mac und Windows stellen Sie die Kontextlänge in den Einstellungen mit dem Schieberegler ein. Ob es gewirkt hat, zeigt ollama ps in der Spalte CONTEXT. Tragen Sie denselben Wert beim Modell in DeepSeek Harness ein.

Welche Modelle sich eignen

Empfehlungen für lokale Modelle gibt DeepSeek nicht. Für einen Programmier-Agenten braucht ein Modell zuverlässige Werkzeugaufrufe und einen langen Kontext. Aus unserem Katalog kommen dafür etwa diese in Frage, jeweils mit 65.536 Token Kontext gerechnet:

  • Qwen3-Coder 30B A3B, fürs Programmieren gebaut, läuft auf 188 von 891 geführten Geräten flüssig.
  • Laguna XS 2.1, ebenfalls fürs Programmieren gebaut, läuft auf 226 von 891 Geräten flüssig.
  • Qwen3.8 27B, ein allgemeines Modell mit Stärken beim Programmieren, läuft auf 249 von 891 Geräten flüssig.

Welche Modelle sich fürs Programmieren eignen, ordnet unsere Seite KI zum Programmieren ein.

Und die DeepSeek-Modelle selbst?

Die Sprachmodelle von DeepSeek sind offen, aber groß. Das kleinste der Reihe V4, DeepSeek V4-Flash, braucht in der Stufe Q4_K_M rund 160 GB Speicher und läuft mit 65.536 Token Kontext auf 13 von 891 geführten Geräten flüssig. Das neuere V4.1-Flash, mit dem die Cloud von DeepSeek Harness ab Werk arbeitet, ist noch größer. Lokal betrieben binden Sie ein DeepSeek-Modell wie jedes andere über Custom model API an. Soll es auf Wunsch ohne Nachdenkphase antworten, braucht DeepSeek Harness dafür einen Eintrag in seiner Konfigurationsdatei, mit reasoningEfforts samt der Stufe off und compat.thinkingFormat: deepseek. Mehr zu den Modellen steht auf unserer Seite DeepSeek lokal.

MCP-Server anbinden

Über MCP, ein offenes Protokoll, bieten fremde Programme einem Agenten zusätzliche Werkzeuge an. Ab Werk ist in DeepSeek Harness kein MCP-Server eingeschaltet. Eingetragen wird ein Server in der Konfigurationsdatei des Profils, angebunden über stdio oder streamable-http. Was Sie einem solchen Server geben, verarbeitet laut Datenschutzerklärung dessen Betreiber, nicht DeepSeek.

Was trotz eines lokalen Modells an DeepSeek geht

Für eigene Server verspricht DeepSeek in seiner Datenschutzerklärung:

„DeepSeek Harness does not store or process your Input and Output on the server side.“

Quelle: DeepSeek Harness, Privacy Policy, gelesen am

Das gilt für die Ein- und Ausgaben des Modells. Zwei Wege führen trotzdem zu DeepSeek:

  • Die Websuche. Ab Werk sucht DeepSeek Harness über die Suche von DeepSeek, mit demselben Schlüssel wie die Modelle. Die Alternativen im Code, Exa und Perplexity, sind ebenfalls Cloud-Dienste. Wer nichts nach außen geben will, nutzt die Websuche nicht.
  • Rückmeldungen. Geben Sie eine Rückmeldung, mit /feedback, im Rückmeldefenster oder schon mit einer Bewertung einer Antwort, schickt DeepSeek Harness den bisherigen Verlauf der Sitzung mit: Nachrichten, Werkzeugaufrufe samt Ergebnissen, also auch gelesene Dateiinhalte, und das Arbeitsverzeichnis. Das gilt bei jedem Modellanbieter, auch bei einem lokalen:

„OTel releases a Session-log prefix only after explicit user feedback, regardless of model provider.“

Quelle: DeepSeek Harness, Grundeinstellungen, gelesen am

Abschalten lässt sich das, indem Sie beim Start die Umgebungsvariable DSH_TELEMETRY_DISABLED mit einem beliebigen Wert setzen, auf Mac und Linux etwa mit DSH_TELEMETRY_DISABLED=1 npx @deepseek-ai/dsh web, in der PowerShell unter Windows mit $env:DSH_TELEMETRY_DISABLED="1" vor dem Start. Nutzen Sie dagegen die Cloud von DeepSeek, lädt der Agent ab Werk zusätzlich das Sitzungsprotokoll hoch und meldet, welche Erweiterungen aktiv sind. Laut Datenschutzerklärung speichert DeepSeek diese Daten in der Volksrepublik China und nutzt sie zum Training, wogegen Sie widersprechen können.

Sicherheit

DeepSeek sagt selbst, dass die Vorabversion nicht als sicher gelten darf:

„It has not undergone a security audit and must not be treated as secure or production-ready.“

Quelle: DeepSeek Harness, Safety, gelesen am

Ab Werk darf der Agent nur im Arbeitsordner und in temporären Ordnern schreiben und fragt vor heiklen Aktionen nach. Die Abschottung betrifft aber nur das Schreiben von Dateien: Lesen darf der Agent auf allen Systemen überall, und Netz und Prozesse schränkt sie nicht ein. Unter Windows ist zudem der Schreibschutz nur teilweise umgesetzt. Erweiterungen lädt DeepSeek Harness aus dem npm-Verzeichnis, ersatzweise von einem Spiegel in China. Probieren Sie den Agenten deshalb in einem Projekt ohne Zugangsdaten aus, am besten in einer virtuellen Maschine oder einem Container.

Für wen sich DeepSeek Harness heute lohnt

Für Entwickler, die einen Agenten ausprobieren oder erweitern wollen, und für alle, die die Cloud von DeepSeek ohnehin nutzen. Wer einen Programmier-Agenten verlässlich im Alltag mit lokalen Modellen einsetzen will, greift derzeit besser zu einem Werkzeug mit stabiler Version, etwa OpenCode, dessen Dokumentation Ollama, LM Studio und llama.cpp ausdrücklich beschreibt. Allgemeinere Agenten mit eigenem Ratgeber sind OpenClaw und Hermes Agent.

Quellen: DeepSeek Harness auf GitHub (README, LICENSE, SAFETY.md, Releases, Dokumentation zu Providers, Voreinstellungen in packages/bundle/base/cordis.patch.yml, Beschreibungen der Bausteine llm-pi-ai, session-log-deepseek, session-telemetry-otel, sandbox-local, pwsh-local, mcp-client und plugin-manager), Startseite von DeepSeek Harness, zur Desktop-App erneut gelesen 2026-10-13, Datenschutzerklärung, Ollama zur Kontextlänge, OpenCode, Providers, alle gelesen 2026-09-25; Version im Paketverzeichnis npm, Releases und Dokumentation zu Providers erneut gelesen 2026-10-14.

Fazit

Kurz gesagt

DeepSeek Harness ist ein quelloffener KI-Agent von DeepSeek unter der MIT-Lizenz, gedacht vor allem zum Programmieren, und bisher nur eine Vorabversion für Entwickler. Ab Werk arbeitet er mit der Cloud von DeepSeek; in den Einstellungen lässt sich aber ein eigener Server wie Ollama, LM Studio oder llama.cpp anbinden, mit ausreichend eingestellter Kontextlänge. Auch mit lokalem Modell gehen die Websuche und Rückmeldungen samt Sitzungsverlauf an DeepSeek; die Rückmeldungen lassen sich über eine Umgebungsvariable abschalten. Weil DeepSeek die Vorabversion selbst nicht als sicher einstuft, probieren Sie sie in einer virtuellen Maschine oder einem Container aus, und für den verlässlichen Alltag mit lokalen Modellen greifen Sie derzeit besser zu einem Werkzeug mit stabiler Version wie OpenCode.

Häufige Fragen

Was ist DeepSeek Harness?

Ein quelloffener KI-Agent von DeepSeek für Programmieren, Recherche und Alltagsaufgaben, der unter der MIT-Lizenz steht. Er ist eine Vorabversion für Entwickler; was er kann und wie Sie ihn installieren, steht in der Einleitung und im Abschnitt „DeepSeek Harness installieren“.

Quellen: DeepSeek Harness auf GitHub · DeepSeek Harness, Lizenz · DeepSeek Harness, Startseite

Was kostet DeepSeek Harness?

Das Programm selbst kostet nichts, es steht unter der MIT-Lizenz. Nutzen Sie die Modelle aus der Cloud von DeepSeek, rechnet DeepSeek je eine Million Tokens ab, nach Eingabe und Ausgabe getrennt; mit einem angebundenen lokalen Modell rechnet Ihre eigene Hardware.

Quellen: DeepSeek Harness, Lizenz · DeepSeek, Preise der Schnittstelle

Kann ich DeepSeek in Deutschland nutzen?

Die Berliner Beauftragte für Datenschutz hat die DeepSeek-Apps am 27. Juni 2025 bei Apple und Google als rechtswidrigen Inhalt gemeldet, wegen einer aus ihrer Sicht rechtswidrigen Übermittlung von Nutzerdaten nach China. Ab Werk arbeitet DeepSeek Harness mit der Cloud von DeepSeek, die die Daten laut Datenschutzerklärung in China speichert. Für DeepSeek Harness mit eigenem Modellserver sagt die Datenschutzerklärung, dass Ein- und Ausgaben nicht auf DeepSeeks Servern verarbeitet werden; die Websuche läuft ab Werk trotzdem über DeepSeek, und eine Rückmeldung schickt den Sitzungsverlauf mit, siehe „Was trotz eines lokalen Modells an DeepSeek geht“.

Quellen: Berliner Datenschutzbeauftragte, Pressemitteilung vom 27.06.2025 · DeepSeek Harness, Datenschutzerklärung · DeepSeek Harness, Grundeinstellungen

Ist DeepSeek Harness sicher?

DeepSeek sagt selbst, dass die Vorabversion kein Sicherheitsaudit durchlaufen hat und nicht als sicher gelten darf. Probieren Sie sie deshalb in einer virtuellen Maschine oder einem Container aus, wie im Abschnitt „Sicherheit“ beschrieben.

Quelle: DeepSeek Harness, Sicherheitshinweise

Kann ich DeepSeek lokal installieren?

Den Agenten ja: als Desktop-App in der Vorschau für Macs mit Apple-Chip und für Windows (Abschnitt „Gibt es eine Desktop-App?“) oder mit „npx @deepseek-ai/dsh web“ als Oberfläche im Browser auf Ihrem Rechner. Die Sprachmodelle von DeepSeek sind zwar offen, aber sehr groß; auf welchen Geräten sie laufen, zeigt die Seite DeepSeek lokal, und jedes andere lokale Modell binden Sie wie im Abschnitt „Ein lokales Modell anbinden“ an.

Quellen: DeepSeek Harness auf GitHub · DeepSeek V4-Flash, Lizenzangabe bei Hugging Face

Weitere Ratgeber