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.“
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.“
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 Studiohttp://localhost:1234/v1, bei llama.cpp meisthttp://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.“
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.“
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.“
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.
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.
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
- Sprachassistent selber bauen: lokal mit Whisper, Ollama und PiperEin Sprachassistent ohne Cloud braucht drei Modelle: Whisper hört zu, ein Sprachmodell antwortet, Piper liest vor. Speicher, gemessenes Tempo und unsere Grenzen.
- Whisper lokal: Interviews und Besprechungen auf dem eigenen Rechner transkribierenWhisper lokal installieren und nutzen, mit Programm oder im Terminal: Welches Modell für deutsche Aufnahmen passt, wie viel Speicher es braucht und wo die Grenzen liegen.
- KI-Agenten mit lokalem Modell: zwölf Werkzeuge im VergleichOpenClaw, Hermes Agent, DeepSeek Harness und neun weitere Agenten mit einem Modell auf dem eigenen Rechner: was jeder verlangt, was Ihr Gerät hergibt und welcher zu Ihnen passt.
- KI auf dem eigenen PC installieren: Reicht Ihr Rechner, oder müssen Sie etwas kaufen?Zum Ausprobieren brauchen Sie meist weder neue Hardware noch das Terminal. Was mit 8 und 16 GB Arbeitsspeicher läuft, welche Programme ohne Befehle auskommen und wann sich ein Kauf lohnt.
- Lokale KI: Was das heißt, was Sie brauchen, was sie kannLokale KI heißt, dass die Modelldatei auf Ihrem Gerät liegt und die Rechenarbeit dort stattfindet. Was Sie dafür brauchen, was heute gut funktioniert und wo die Grenzen liegen.
- Qwen lokal betreiben: welche Fassung auf welches GerätQwen gibt es in vielen Größen. Die kleinste aktuelle Fassung in unserem Katalog, Qwen3.5 4B, braucht 4,4 GB und läuft damit auf praktisch jedem Rechner, Qwen3.8 27B flüssig auf 261 von 891 Geräten. Welche Fassung zu Ihrem Rechner passt und wie Sie sie starten.
- Qwen-Image: KI-Bilder lokal erzeugen und die richtige Fassung wählenQwen-Image erzeugt Bilder auf dem eigenen Rechner. Die neue Fassung 2.1 ist nur für Forschung und Erprobung freigegeben, für Unternehmen ist 2512 die Fassung. Was beide an Speicher brauchen und wie lange ein Bild auf unserer Karte dauerte.
- DSGVO-konforme KI: Welche Daten verlassen bei welchem Aufbau Ihr Haus?Lokal heißt nicht telemetriefrei, und eine EU-Zusage hängt am Bereitstellungstyp. Was bei vier gängigen Aufbauten wirklich übertragen wird, mit Zitaten aus den Datenschutzerklärungen der Anbieter.
- KI für Berufsgeheimnisträger: Was § 203 StGB bei ChatGPT & Co. verlangtHat ChatGPT eine Schweigepflicht? Worauf Anwälte, Ärzte, Steuerberater und Psychotherapeuten bei KI achten müssen, was die Kammern sagen und warum lokale KI die einfachste Antwort ist.
- KI lokal betreiben, ohne Terminal: So läuft ein Sprachmodell auf Ihrem RechnerLokale KI-Modelle brauchen auf Mac und Windows keine Befehlszeile mehr. Was Sie an Hardware brauchen, wie die Einrichtung Schritt für Schritt gelingt und wo die Grenzen liegen.
- Lokale KI-Modelle: Welches läuft auf Ihrer Hardware?Ob ein lokales KI-Modell auf Ihrem Rechner läuft, entscheidet der Speicher. Wie Sie die richtige Zahl finden und was die Stufen hinter dem Namen bedeuten.
- Mac mini für lokale KI: Welche Ausstattung reicht und wann es der Mac Studio sein mussBeim Mac zählt der Arbeitsspeicher, nicht die ganze Zahl. Was der Mac mini mit M4, M5 Pro und M6 trägt, wann es der Mac Studio sein muss und was gebraucht zählt.
- Deutsche und europäische KI-Modelle: Welche es gibt und was davon lokal läuftTeuken aus Deutschland, EuroLLM aus einem EU-Projekt, Mistral aus Paris, Apertus aus der Schweiz. Lizenz, Größe und auf wie vielen der 891 Geräte sie flüssig laufen.
- gpt-oss: OpenAIs offenes Modell auf dem eigenen Rechnergpt-oss gibt es in zwei Größen. Die kleine läuft auf 478 von 891 geführten Geräten flüssig, die große auf 80. Was Sie brauchen und wo das Modell nicht passt.
- Grafikkarte für KI: Worauf es bei lokalen Modellen ankommtFür KI zählt an einer Grafikkarte zuerst der Speicher, dann das Tempo. Welche Speicherklasse wie viele Modelle trägt und was der Schritt von 16 auf 24 GB bringt.
- Hermes Agent lokal: mit Ollama oder LM Studio nutzenHermes Agent lokal mit Ollama oder LM Studio: Er braucht mindestens 64.000 Token Kontext, ein Modell mit Werkzeugaufrufen und genug Speicher.
- KI selbst hosten: Was sich ändert, sobald mehrere zugreifenSelbst hosten heißt, dass einer betreibt und mehrere nutzen. Was dafür nötig ist, warum die Voreinstellungen dafür nicht gemacht sind und welche Fragen ab dem zweiten Nutzer keine Technikfragen mehr sind.
- Open Source KI: Welche Modelle wirklich offen sindDie meisten Modelle, die „Open Source KI“ heißen, geben nur die fertigen Modelldateien frei, nicht den Weg dorthin. Was der Begriff bedeutet, welche Familien es gibt und was davon auf eigener Hardware läuft.
- OpenClaw lokal: mit Ollama oder LM Studio einrichtenOpenClaw mit einem lokalen Modell über Ollama oder LM Studio: installieren, einrichten, passende Modelle wählen und wissen, was trotzdem ins Netz geht.
- Ornith 1.5: Welche der drei Größen auf Ihrem Rechner läuftOrnith 1.5 in drei Größen: Die kleinste läuft beim Ausprobieren auf 576 von 891 Geräten flüssig, die größte auf 9. Was jede braucht und wann ein Verbund hilft.
- Ollama oder LM Studio: Was ist der Unterschied, und welches passt zu Ihnen?Beide laden offene Sprachmodelle auf Ihren Rechner und rechnen mit demselben Unterbau. Was sie wirklich unterscheidet, was sie kosten und welche Daten dabei Ihr Haus verlassen.
- Was ist Ollama, und welche Alternativen gibt es?Ollama, LM Studio, llama.cpp und vLLM tauchen in vielen Anleitungen für lokale KI auf. Was jedes davon ist, wie die vier zusammenhängen und welches Sie wofür brauchen.
- Was kostet ChatGPT wirklich, und ab wann lohnt sich eigene Hardware?Die Rechnung hat vier Posten, und drei davon stehen auf keiner Preisliste. Was ein Modell über die Schnittstelle kostet, was eigene Hardware dagegenstellt, und ab welchem Punkt sich der Wechsel rechnet.