Was ist ein Agent-Harness? Einfach erklärt
Ein Agent-Harness umgibt das Modell mit Schleife, Tools, Berechtigungen und Sitzungsstatus. Erfahren Sie, wie er sich von Modell und Framework unterscheidet.
Was ein Agent-Harness ist
Ein Agent-Harness ist das Programm, das ein Sprachmodell umgibt und es in einen Agenten verwandelt. Es enthält die Schleife, die das Modell fortlaufend aufruft, die Tool-Definitionen, die das Modell verwenden darf, die Berechtigungsregeln, die festlegen, welche dieser Aufrufe tatsächlich ausgeführt werden, den Sitzungsstatus, der zwischen den Durchläufen erhalten bleibt, und das Arbeitsverzeichnis, in dem die Arbeit stattfindet. Das Modell kann darin ausgetauscht werden.
Dieser letzte Satz ist entscheidend. Ein Modell allein beantwortet eine Frage und vergisst Sie. Ein Harness fragt das Modell, was als Nächstes zu tun ist, führt den vom Modell angeforderten Befehl aus, übergibt das Ergebnis zurück und fragt erneut. Diese Wiederholung ist gemeint, wenn von einem „Agenten“ gesprochen wird. Wenn die Begriffe noch unklar sind, erklärt der Unterschied zwischen einem KI-Agenten, einem LLM und einem Assistenten die Begriffe, bevor Sie ein Tool auswählen.
Das Harness ist nicht das Modell
Die beiden werden verwechselt, weil Anbieter sie unter einem gemeinsamen Markennamen veröffentlichen.
dsh und DeepSeek sind unterschiedliche Produkte. DeepSeek Harness, veröffentlicht unter github.com/deepseek-ai/deepseek-harness am 13. August 2026 unter der MIT-Lizenz, ist ein Node-Programm, das Sie auf einem Rechner installieren. Die DeepSeek-Modelle sind Gewichte, die hinter einer API (Application Programming Interface) bereitgestellt werden. Verweisen Sie dsh auf ein Modell eines anderen Anbieters, funktioniert es weiterhin, weil das Harness lediglich etwas benötigt, das Nachrichten akzeptiert und Tool-Aufrufe zurückgibt.
Claude Code und Claude bilden dasselbe Paar. Claude Code ist ein Harness: ein Terminalprogramm mit einer Schleife, einem Berechtigungssystem sowie Datei- und Shell-Tools. Claude ist die Modellfamilie, die standardmäßig aufgerufen wird. Codex und Gemini CLI sind auf dieselbe Weise aufgeteilt.
Dieser Test schafft jedes Mal Klarheit. Sie installieren ein Harness. Sie rufen ein Modell auf. Wenn das Programm eine Version auf Ihrer Festplatte und eine Konfigurationsdatei in Ihrem Home-Verzeichnis hat, ist es ein Harness. Wenn es sich um eine Zeichenfolge innerhalb dieser Konfigurationsdatei handelt, etwa deepseek-flash, ist es das Modell.
Was die Schleife tatsächlich macht
Ein Durchlauf einer Harness-Schleife sieht so aus. Lesen Sie ihn langsam, denn fast jeder Unterschied zwischen Harnesses liegt in diesen fünf Schritten.
- Das Harness sendet die bisherige Konversation zusammen mit einer Liste von Tool-Definitionen an das Modell.
- Das Modell antwortet mit Text oder fordert den Aufruf eines dieser Tools an.
- Das Harness prüft diese Anforderung anhand seiner Berechtigungsregeln und führt sie entweder aus oder hält an, um Sie zu fragen.
- Das Harness führt das Tool aus, erfasst die Ausgabe und den Exit-Code und kürzt die Ausgabe, wenn sie sehr lang ist.
- Das Harness hängt dieses Ergebnis an die Konversation an und kehrt zu Schritt 1 zurück.
Schritt 3 ist der Bereich, in dem sich Harnesses im täglichen Einsatz am stärksten unterscheiden. Ein Harness, das vor jedem Befehl fragt, ist sicher und anstrengend. Ein Harness, das nie fragt, führt irgendwann einen destruktiven Befehl auf einem Pfad aus, den das Modell falsch angegeben hat. Claude Code unterstützt eine mittlere Einstellung: eine Allowlist von Befehlen, die ohne Nachfrage ausgeführt werden, sowie eine Eingabeaufforderung für andere Befehle.
Schritt 1 umfasst den restlichen Unterschied. Das Harness schreibt außerdem den System-Prompt, der jede dieser Anfragen begleitet. Claude Code gibt Ihnen direkten Zugriff auf diesen Regler, weil ein Ausgabestil den von ihm gesendeten System-Prompt bearbeitet und damit jede zurückkommende Antwort verändert. Die Konversation wächst mit jedem Durchlauf, und ein Modell hat ein festes Kontextfenster. Daher muss das Harness entscheiden, was verworfen, was zusammengefasst und was in eine Datei geschrieben und später wieder eingelesen wird. Diese Entscheidung ist der Hauptgrund dafür, dass zwei Harnesses, die dasselbe Modell steuern, unterschiedliche Arbeitsqualität liefern. Wenn diese fünf Schritte weiterhin abstrakt wirken, hilft es, einmal eine einfache eigene Schleife zu schreiben. Genau das lässt ein schrittweiser Lernpfad für AI-Agenten Sie früh erstellen.
Die meisten Harnesses binden inzwischen externe Tools über MCP (model context protocol) ein. MCP ist eine standardisierte Möglichkeit, ein Tool jedem Harness bereitzustellen, das dieses Protokoll unterstützt, sodass eine Integration mehrere Harnesses erreicht. MCP-Server auf einem VPS ausführen behandelt diesen Aspekt. Die Websuche ist üblicherweise das erste Tool, das hinzugefügt wird. den Agenten auf Ihre eigene SearXNG-Instanz verweisen hält die Suchanfragen von Drittanbietern fern und macht zugleich deutlich, dass jede Seite, die der Agent anschließend liest, eine nicht vertrauenswürdige Eingabe innerhalb der Schleife ist.
Harness oder Agent-Framework
Diese Frage stellt sich bei jedem neuen Harness, und die Antworten unterscheiden sich, teilweise weil auch die Anbieter unterschiedliche Definitionen verwenden. Hier ist die Fassung, die sich in der Praxis bewährt.
Ein Framework ist eine Bibliothek, die Sie importieren. Sie stellen den Agenten im Code zusammen, indem Sie die Schleife des Frameworks verwenden oder eine eigene schreiben. LangChain ist das bekannte Beispiel: Sie erhalten Bausteine und stellen den Agenten im Code zusammen.
Ein Harness ist ein Programm, das Sie ausführen. Die Schleife ist bereits implementiert, die Tools sind bereits vorhanden und das Berechtigungsmodell hat bereits Standardwerte. Sie erhalten mit dem ersten Befehl einen funktionierenden Agenten und konfigurieren ihn anschließend.
Der Installationstest gibt normalerweise den Ausschlag. Wenn Sie das Programm installieren und danach Code schreiben, ist es ein Framework. Wenn Sie es installieren und danach mit ihm sprechen, ist es ein Harness.
Die Abgrenzung ist tatsächlich umstritten. Die deutlichsten Belege finden sich in der eigenen Dokumentation von LangChain. Im Oktober 2026 bezeichnet sie Deep Agents als „Agent-Harness“ und zugleich als „eigenständige Bibliothek, die auf den grundlegenden Bausteinen von LangChain für Agenten aufbaut“. Das langchain-ai/deepagents-Repository bezeichnet sich selbst als „Agent-Harness mit vollständiger Ausstattung“. Beide Beschreibungen sind zutreffend. Deep Agents ist ein Python-SDK (Software Development Kit), das Sie importieren. Nach dem Installationstest ist es daher eine Bibliothek. Es liefert jedoch genug Standardverhalten mit, dass viele es wie ein Harness verwenden. Microsoft gab Hosted Agents im Foundry Agent Service am 9. Juli 2026 allgemein frei. In seinem Beitrag vom 22. Juli 2026 kündigte Microsoft außerdem die Veröffentlichung des Microsoft Agent Framework Harness an. Das zeigt, dass der Begriff inzwischen eine Produktkategorie und kein bloßer Fachjargon mehr ist.
Stellen Sie stattdessen die Frage, die Ihre Arbeitslast besser vorhersagt. Wenn Sie die Schleife schreiben, sind Sie für die Schleife verantwortlich: für Wiederholungsversuche, das Kürzen des Kontexts, Berechtigungsabfragen und die Aufzeichnung der Vorgänge. Wenn die Schleife mitgeliefert wird, übernehmen Sie die Lösung eines anderen für all diese Punkte. Das ermöglicht einen deutlich schnelleren Einstieg, lässt sich später aber schwerer ändern.
Wie sich eine Ausführungsumgebung von einem Chatfenster unterscheidet
Ein Chatfenster und eine Ausführungsumgebung zeigen Ihnen beide die Ausgabe des Modells. Der Unterschied besteht darin, auf wessen Computer die Arbeit ausgeführt wird. In einem Chatfenster wird jeder vom Modell ausgeführte Code innerhalb der Sandbox des Anbieters ausgeführt und arbeitet mit Dateien, die Sie hochgeladen haben. Eine Ausführungsumgebung führt Tools auf dem Computer aus, auf dem Sie sie gestartet haben, als der Benutzer, der sie gestartet hat, und greift dabei auf Ihre echten Dateien sowie die in ihrer Umgebung verfügbaren echten Zugangsdaten zu.
Das ist in zwei Sätzen der gesamte Vorteil und das gesamte Risiko. Der Agent kann die Arbeit jetzt tatsächlich ausführen. Der Agent kann die Arbeit aber auch löschen.
Die Harnesses, die tatsächlich eingesetzt werden
Diese Liste trägt bewusst das Datum 19 August 2026. Die Kategorie entwickelt sich wöchentlich weiter, und jede Übersicht ist schnell veraltet.
- Claude Code und Codex sind Harnesses der Anbieter. Sie sind primär für das Terminal ausgelegt, standardmäßig an die Modelle des jeweiligen Anbieters gebunden und bieten die ausgereifteste Berechtigungsverwaltung. Claude Code, Cursor, Codex und Copilot im Vergleich behandelt sie ausführlich.
- DeepSeek Harness (
dsh) steht unter der MIT-Lizenz und basiert auf einer Idee: Alles ist ein Plugin. Modelle, Tools, Sitzungen, Sandboxes und die Benutzeroberfläche sind daher austauschbare Komponenten. Jedes installierte Plugin läuft mit den Berechtigungen des Agents. Deshalb ist Prüfen, worauf ein dsh-Plugin zugreifen kann, bevor Sie es hinzufügen hier wichtiger als bei einem Harness mit festem Toolset. - Hermes von Nous Research ist ein allgemeiner autonomer Agent und kein reines Programmiertool. Er wurde im Februar 2026 unter der MIT-Lizenz veröffentlicht. Sein integrierter Speicher ist lokal: Erinnerungen und Skills liegen als Dateien unter
~/.hermes, der Sitzungsverlauf in einer lokalen SQLite-Datenbank. Das beschreibt die Situation nicht mehr vollständig, sobald Sie einen der optionalen externen Speicheranbieter wie Mem0 oder Hindsight aktivieren. Im Oktober 2026 weist die Hermes-Dokumentation darauf hin, dass ein aktiver Anbieter nach jeder Antwort jeden Gesprächsbeitrag sowie eine Kopie jedes integrierten Speichervorgangs erhält. Ihre Daten liegen dann also ebenfalls bei diesem Anbieter. Hindsight und Mem0 im Vergleich sollten Sie lesen, bevor Sie einen Anbieter aktivieren. Hermes auf einem VPS selbst hosten beschreibt die übrigen Schritte. - Omnigent ist ein Meta-Harness. Es steuert andere Harnesses, darunter Claude Code und Codex, über eine gemeinsame API mit geteilten Sitzungen, Ausgabenlimits und einer Sandbox auf Betriebssystemebene. Omnigent als Multi-Agent-Harness beschreibt den Nutzen dieses Ansatzes.
- OneCLI ist ein sandboxed Harness für Teams. Es basiert auf einem Gateway, das Zugangsdaten in die ausgehenden Anfragen des Agents einfügt. Der Agent selbst sieht dadurch niemals die echten Schlüssel.
Drei dieser Harnesses stehen häufig genug gemeinsam auf der engeren Auswahlliste, dass sich DeepSeek Harness, Claude Code und Omnigent im direkten Vergleich zu Modellbindung, Lizenz, Reifegrad und den Voraussetzungen für den Betrieb auf einem Server lohnt.
Der schnelle Start mit dsh besteht aus einem einzelnen Befehl. Wenn Sie ihn einmal ausführen, sehen Sie am schnellsten, was ein Harness ist. Auf dem Rechner muss Node.js installiert sein.
npx @deepseek-ai/dsh webDadurch wird die Web-UI (Benutzeroberfläche) auf http://127.0.0.1:3080 gestartet. Lesen Sie die README, bevor Sie sich darauf verlassen. dsh bezeichnet sich selbst als Entwicklervorschau und weist ausdrücklich auf mögliche Änderungen mit inkompatiblen Auswirkungen hin. Wenn der erste Befehl unmittelbar fehlschlägt oder einen unerwarteten Build abruft, bringt Sie Eine exakte dsh-Version festlegen und den npx-Cache leeren meistens wieder weiter. DeepSeek Harness auf einem VPS ausführen beschreibt die Serverinstallation. Warum diese Adresse mit 127.0.0.1 beginnt erklärt den Standard für die Loopback-Adresse.
Router stehen über dem Harness
Ein Model-Router ist ein lokaler Proxy zwischen dem Harness und der Provider-API. Claude Code Router ist ein gängiges Beispiel: Er bindet standardmäßig an 127.0.0.1:3456, nimmt die Anfragen entgegen, die Claude Code an seinen eigenen Anbieter gesendet hätte, und leitet sie an den von Ihnen konfigurierten Provider weiter. Das Harness erkennt nicht, dass sich etwas geändert hat.
Router gibt es, weil das Modell austauschbar ist. Damit belegen sie die zentrale Aussage dieses Beitrags besonders gut. Gleichzeitig bündeln sie Risiken, weil der Proxy jeden Prompt sieht und jeden Provider-Schlüssel enthält. Behandeln Sie ihn als Infrastruktur und nicht als Komfortfunktion. Wo ein Harness seine API-Schlüssel und Modelleinstellungen speichert beschreibt dasselbe Problem eine Ebene tiefer.
Was sich ändert, wenn das Harness auf einem VPS läuft
Vier Dinge ändern sich, wenn das Harness von Ihrem Laptop auf einen gemieteten Server umzieht.
Es läuft weiter, wenn Sie den Deckel schließen. Eine lange Aufgabe übersteht Ihren Arbeitsweg und den Akku Ihres Laptops. Starten Sie sie innerhalb von tmux und trennen Sie die Verbindung:
tmux new -s agent
# start the harness, then press Ctrl-b and then d to detach
tmux attach -t agentFür alles, was nach einem Reboot wieder gestartet werden soll, ist ein User-Service besser geeignet als eine Terminalsitzung:
loginctl enable-linger $USER
systemctl --user status my-agent.serviceloginctl enable-linger ist der Punkt, der oft übersehen wird. Ohne diese Einstellung beendet systemd standardmäßig den Service-Manager Ihres Benutzers 10 Sekunden nach dem Ende Ihrer letzten Sitzung. Ein User-Service hält den Agenten daher nach dem Logout nicht weiter am Laufen. dsh headless unter systemd ausführen enthält die Unit-Datei. Sobald eine Sitzung auf diesem Server läuft, können Sie eine zweite starten. Zwei Claude-Code-Sitzungen auf demselben System können miteinander Nachrichten austauschen. Dadurch kann die Sitzung, die Sie heute Morgen gestartet haben, der anderen eine Aufgabe übergeben, ohne dass Sie sie manuell weiterleiten müssen.
Es verwahrt Ihre Schlüssel. Der Provider-Key liegt jetzt in einer Konfigurationsdatei auf diesem Server. Prüfen Sie, wer die Datei lesen kann:
ls -l ~/.configJeder Prozess, der unter Ihrem Benutzer läuft, kann diese Datei lesen. Dazu gehören der Agent und alles, was der Agent auszuführen beschließt.
Es kann Ihre anderen Rechner erreichen. Ein VPS im selben privaten Netzwerk wie Ihre anderen Systeme gibt dem Agenten eine Route zu diesen Systemen. Genau das ist der Zweck. Es ist aber auch die Reichweite eines möglichen Schadens.
Es ist von überall erreichbar. Die meisten Harnesses stellen eine Weboberfläche bereit. Aus gutem Grund binden die meisten sie an Loopback. Prüfen Sie Ihre Konfiguration:
ss -tlnp | grep 3080127.0.0.1:3080 bedeutet, dass nur der Server selbst eine Verbindung herstellen kann. 0.0.0.0:3080 bedeutet, dass die Weboberfläche auf jeder Schnittstelle lauscht. Jeder, der die öffentliche Adresse des Servers erreichen kann, kann dann eine Verbindung herstellen, sofern eine vorgeschaltete Firewall den Port nicht blockiert. Stand Oktober 2026 lehnt dsh eine solche Wildcard-Adresse beim Start ab. Viele andere Weboberflächen akzeptieren jedoch eine solche Adresse. Erreichen Sie eine an Loopback gebundene Weboberfläche über einen SSH-Tunnel, statt die Bind-Adresse zu ändern:
ssh -N -L 3080:127.0.0.1:3080 you@your-serverÖffnen Sie anschließend http://127.0.0.1:3080 im Browser auf Ihrem Laptop. Der Datenverkehr läuft innerhalb der SSH-Sitzung. Dadurch wird nichts Neues im Internet veröffentlicht.
Jede dieser Eigenschaften ist zugleich das Sicherheitsargument
Lesen Sie die vier Eigenschaften noch einmal so, wie ein Angreifer sie lesen würde.
Der Agent läuft unbeaufsichtigt. Niemand bemerkt daher den Moment, in dem das Modell einen Pfad falsch interpretiert. Der Agent verwahrt Ihre Schlüssel. Eine lesbare Konfigurationsdatei reicht daher aus, um auf Ihr gesamtes Provider-Konto zuzugreifen. Der Agent kann Ihre anderen Rechner erreichen. Eine Prompt-Injection, also Anweisungen, die in einer Webseite oder Datei verborgen sind, die der Agent liest, kann dadurch Ihren Datenbankserver erreichen. Der Agent ist von überall erreichbar. Eine Weboberfläche, die an einer öffentlichen Adresse lauscht, ohne vorgeschaltete Firewall und ohne eigene Authentifizierung, ist für jeden, der sie findet, eine Shell. dsh gibt beim Start ein Process-Token in der ausgegebenen URL aus. Das ist hilfreich. Diese URL ist damit aber ein Zugangsdatenbestandteil. Teilen Sie sie daher ebenso sorgfältig wie ein Passwort.
Die Lösung ist in jedem Fall unspektakulär und immer dieselbe. Geben Sie dem Agenten ein eigenes, nicht privilegiertes Benutzerkonto statt Ihres Kontos:
sudo adduser --disabled-password --gecos "" agentBinden Sie die Weboberfläche an Loopback und greifen Sie über SSH darauf zu. Geben Sie dem Agenten die engsten Berechtigungen, mit denen er die Aufgabe noch abschließen kann. Der Abschnitt Geheimnisse aus KI-Agenten heraushalten behandelt dieses Thema ausführlich. Für alles, was läuft, während Sie nicht zuschauen, ist ein Wegwerf-System besser als ein sorgfältig abgesichertes System: Coding-Agenten in einer temporären VM ausführen und Claude Code sicher auf einem VPS ausführen verfolgen beide diesen Ansatz.
Benötigen Sie ein Agent-Harness?
Wenn Ihre Arbeit aus jeweils einer Frage besteht, reicht ein Chatfenster aus. Ein Harness fügt dann nur eine Schleife hinzu, die Sie überwachen müssen. Ein Harness lohnt sich, sobald eine Aufgabe viele Schritte mit echten Dateien umfasst oder weiterarbeiten muss, während Sie schlafen.
Der größte Teil dieser Kategorie ist noch jung. dsh wird in seiner eigenen README mit Stand Oktober 2026 als Developer Preview bezeichnet. Die übrigen Projekte entwickeln sich so schnell weiter, dass eine heute erstellte Konfigurationsdatei bereits im nächsten Monat angepasst werden muss. Deshalb sollten Sie Ihre Einrichtung klein und reproduzierbar halten und dokumentieren, was Sie geändert haben. Diese Zurückhaltung hilft auch innerhalb der Schleife. Eine Fähigkeit, die den Agenten zur kleinsten funktionierenden Änderung anhält, hinterlässt am Ende eines unbeaufsichtigten Laufs ein Diff, das Sie tatsächlich lesen können. Beginnen Sie mit einem Harness auf einem Server. Geben Sie ihm eine Aufgabe und einen eng begrenzten Schlüssel. Erweitern Sie seinen Zugriff erst, wenn diese erste Aufgabe eine Woche lang problemlos gelaufen ist. Die heute für den Betrieb geeigneten Self-Hosted-Agents sind ein sinnvoller Ausgangspunkt für die Auswahl des ersten Agents.
FAQ
Was ist ein Agent-Harness in einfachen Worten?
Es ist das Programm um das Modell herum. Das Modell erzeugt Text und fordert die Verwendung von Tools an. Das Harness führt die Schleife aus, die wiederholt Anfragen stellt, die vom Modell angeforderten Tools ausführt, die Regeln für zustimmungsfrei zulässige Tools durchsetzt und den Sitzungsstatus sowie die Dateien zwischen den Durchläufen verwaltet. Wenn Sie das Modell austauschen und das Harness weiterhin funktioniert, ist das der deutlichste Hinweis darauf, dass es sich um zwei getrennte Komponenten handelt.
Ist Claude Code ein Modell oder ein Harness?
Claude Code ist ein Harness. Es ist ein Terminalprogramm mit einer Schleife, einem Berechtigungssystem sowie integrierten Datei- und Shell-Tools. Claude ist die Modellfamilie, die es standardmäßig aufruft. Die gleiche Trennung gilt für DeepSeek Harness (dsh), ein Node-Programm, das Sie installieren, und die DeepSeek-Modelle, die über eine API bereitgestellt werden. Sie installieren ein Harness auf einem Rechner. Ein Modell rufen Sie über das Netzwerk auf.
Was ist der Unterschied zwischen einem Agent-Harness und einem Agent-Framework?
Ein Framework ist eine Bibliothek, die Sie importieren und gegen die Sie Code schreiben. Dabei verwenden Sie die bereitgestellte Schleife oder schreiben eine eigene. Ein Harness ist ein Programm, das Sie ausführen. Die Schleife, Wiederholungsversuche und Kontextverwaltung werden daher mit konfigurierbaren Standardwerten bereitgestellt, statt von Ihnen implementiert zu werden. In der Praxis ist die Abgrenzung unscharf: LangChain's Deep Agents ist ein importierbares SDK, dessen eigenes Repository es Stand Oktober 2026 als batteries-included agent harness bezeichnet. Fragen Sie sich, ob Sie die Schleife selbst schreiben werden. Die Antwort entscheidet, welcher Begriff zu Ihrer Situation passt.
Benötige ich einen VPS, um ein Agent-Harness auszuführen?
Nein. Jedes hier genannte Harness läuft auf einem Laptop. Ein Server ändert vier Dinge: Der Agent läuft weiter, wenn Sie den Deckel schließen. Er verwahrt Ihre Schlüssel auf einem ständig eingeschalteten Rechner. Er kann Ihre anderen Server erreichen. Sie können von jedem Gerät zu derselben Sitzung zurückkehren. Jeder dieser Punkte ist auch eine Sicherheitsüberlegung. Geben Sie dem Agenten daher ein eigenes Benutzerkonto und binden Sie jede Weboberfläche an 127.0.0.1.
Kann ich innerhalb desselben Harness ein anderes Modell verwenden?
Normalerweise ja. Das ist die entscheidende Eigenschaft eines Harness. Die meisten Harnesses erwarten in ihrer Konfiguration einen Modellnamen und eine Base-URL. Einen anderen Provider zu verwenden, erfordert daher eine Änderung und keine Neuentwicklung. Wenn sich ein Harness dagegen sperrt, kann ein lokaler Router wie Claude Code Router zwischen Harness und Provider geschaltet werden. Er übersetzt die Anfragen und bindet standardmäßig an 127.0.0.1:3456. Seien Sie bei diesem Proxy vorsichtig. Er sieht jeden Prompt und verwahrt jeden Schlüssel.