Agent-Harness
Definition
Ein Agent-Harness ist die Software rund um ein KI-Modell, die daraus einen arbeitenden Agenten macht: sie stellt Tools, Dateizugriff, Berechtigungen, Gedächtnis und die Schleife bereit, die Aktionen verkettet. Das Modell denkt, das Harness legt fest, was es sehen und tun darf.
Von Ronan Liedmeier, Fractional Head of Growth und Kursautor · Veröffentlicht 17. Oktober 2026 · Zuletzt aktualisiert 17. Oktober 2026
Auch genannt: Agent Harness, agentisches Harness, Agent Scaffold
Dasselbe Modell kann sich in zwei verschiedenen Harnesses sehr unterschiedlich verhalten.
So funktioniert es
Das Glossar von Claude Code sagt es klar: Claude Code ist das Harness, Claude ist das Modell darin. Ein Harness übernimmt vier Aufgaben:
- Tools: welche Aktionen es gibt und worauf jede zugreifen darf.
- Kontext: was das Modell bei jedem Schritt sieht (Anweisungsdateien, geladene Skills, frühere Ergebnisse) und was zusammengefasst wird, wenn der Platz knapp wird.
- Berechtigungen: welche Aktionen frei laufen und welche auf die Freigabe durch einen Menschen warten.
- Die Agent-Schleife selbst, auch die Frage, wann sie stoppt.
Innerhalb eines Harness hilft eine Trennung: Regeln, die immer greifen, etwa Hooks im Code, und Anweisungen, die das Modell nach eigenem Urteil anwendet, etwa eine Anweisungsdatei fürs Projekt.
Beispiel
Eine Agentur lässt Claude Code jede Nacht ohne Aufsicht laufen. Der Lauf holt die Werbeausgaben von drei Plattformen in einen Kundenreport. Das Harness gibt ihm nur lesende Tools für die Werbeplattformen, einen Hook, der jeden API-Aufruf in ein Audit-Log schreibt, und pro Kunde eine eigene Anweisungsdatei. Tagsüber nutzt das Team dasselbe Modell im Chat. Den nächtlichen Lauf kann es allein lassen, weil die Tools nur lesen und jeder Aufruf im Log steht.
Häufiger Fehler
Das Modell für Verhalten verantwortlich machen, das aus dem Harness kommt. Ein Agent bearbeitet zum Beispiel Dateien, die er nicht anfassen sollte, weil der Schreibzugriff offen geblieben ist. Prüf die Tool-Liste und die Berechtigungen, bevor du das Modell wechselst.
In AI Academy lernen
- Claude Code als Agentur-OSExperte · 10 Min.
Verwandte Begriffe
- Claude Code
- Claude Code ist ein KI-Agent von Anthropic, der direkt in deinen Dateien und im Terminal arbeitet: Er liest ein Projekt, bearbeitet Dateien, führt Befehle aus und verbindet sich mit anderen Tools. Er ist für Softwarearbeit gebaut, taugt aber auch für Aufgaben mit Dateien, APIs und festen Abläufen.
- Agent-Schleife
- Eine Agent-Schleife ist der wiederkehrende Ablauf, mit dem ein KI-Agent eine Aufgabe erledigt: er plant einen Schritt, ruft ein Tool auf, liest das Ergebnis und entscheidet, ob er weitermacht oder aufhört. Die Schleife endet, wenn das Ziel erreicht ist oder ein Limit greift.
- Context Engineering
- Context Engineering ist das Festlegen, welche Informationen ein KI-Modell bei jedem Arbeitsschritt sieht: Anweisungen, Dokumente, Tool-Beschreibungen, Gedächtnis und Gesprächsverlauf. Es erweitert Prompt Engineering von der Formulierung einer Anfrage auf alles, was drumherum geladen wird.
- KI-Guardrails
- KI-Guardrails sind Prüfungen und Grenzen rund um ein KI-System, die unsichere oder falsche Eingaben und Ausgaben blockieren oder markieren, bevor sie Schaden anrichten. Die stärksten laufen als Code außerhalb des Modells. Auch eine geschickt formulierte Anfrage kommt an ihnen nicht vorbei.