御舆：解码 Agent Harness: Ein chinesisches Fachbuch zerlegt Claude Codes Runtime
《御舆：解码 Agent Harness》42万字拆解 AI Agent 的Harness骨架与神经 —— Claude Code 架构深度剖析，15 章从对话循环到构建你自己的 Agent Harness。在线阅读网站：
Auf einen Blick
- Was ist das?
- Das Repository lintsinghua/claude-code-book ist kein Code, sondern ein 15 Kapitel umfassendes Buch über die Architektur von Claude Code. Es beschreibt, wie ein Agent Harness aus Dialogschleife, Werkzeugsystem und Berechtigungs-Pipeline zusammengesetzt ist. Wer eine Bibliothek zum Einbinden sucht, ist hier falsch.
- Für wen ist es gedacht?
- Wer einen Agent Harness baut oder Claude Code nicht nur bedienen, sondern verstehen will, findet hier die einzige mir bekannte zusammenhängende Beschreibung der Innenschichten, allerdings auf Chinesisch und ohne Garantie auf Aktualität. Wer eine Bibliothek zum Einbinden, eine englische Referenz oder einen gepflegten Changelog braucht, sollte woanders suchen.
- Darf ich es kommerziell nutzen?
- Nicht ohne Erlaubnis. GitHub findet in diesem Repository keine Lizenzdatei, und ohne Lizenz sind standardmäßig alle Rechte vorbehalten: Sie dürfen den Code lesen, aber nicht wiederverwenden. Prüfen Sie die README oder fragen Sie die Autoren, bevor Sie ihn nutzen.
- Wird es noch gepflegt?
- Ja. Die letzten Commits kamen vor 11 Tagen.
- In welcher Sprache ist es geschrieben?
- Hauptsächlich Python, laut der Sprachstatistik von GitHub.
Die Antworten beruhen auf den GitHub-Daten des Projekts (zuletzt abgeglichen am 15. September 2026) und auf unserer Analyse. Sie sind keine Rechtsberatung.
TIEFGEHENDE OPEN-SOURCE-ANALYSE
Ein Buch im Repository-Gewand
Das Repository enthält nach eigener Beschreibung 42 万字, also rund 420 000 chinesische Schriftzeichen, verteilt auf 15 Kapitel und vier Anhänge. Es ist als Buch organisiert, nicht als Software: Die Wurzel enthält Kapiteldateien wie 00-前言.md und Ordner wie 第一部分-基础篇, dazu ein Verzeichnis en/ mit einer englischen Ausgabe. Die Primärsprache ist im Repository als Python angegeben, was irreführt. Python taucht nur in den Prüfskripten auf, etwa scripts/check_book.py und tests/. Der eigentliche Inhalt ist Prosa in Markdown, teilweise mit Mermaid-Diagrammen.
Der Titel 御舆 stammt aus dem 考工记, einer alten chinesischen Schrift über Handwerk. Das Vorwort vergleicht den Wagenkasten, der die Insassen trägt, mit der Laufzeitumgebung, die einen Agenten trägt: Die Dialogschleife treibt die Aufgabe voran, das Werkzeugsystem führt Aktionen aus, die Berechtigungs-Pipeline zieht Grenzen. Wer ein npm-Paket erwartet, wird enttäuscht. Wer ein Lehrbuch über die inneren Schichten eines Agenten sucht, findet hier eines.
Wen das adressiert, und wen nicht
Die Zielgruppe lässt sich aus der Leserführung im README ableiten. Für den Erstdurchlauf empfiehlt das Buch die Reihenfolge 前言, dann 01, 02, 04, 15. Wer selbst bauen will, soll mit dem Grundlagen- und dem Ingenieursteil beginnen und die Teile zwei und drei erst heranziehen, wenn Gedächtnis und Erweiterbarkeit dazukommen. Diese Empfehlung verrät die Absicht: ein mentales Modell aufbauen, bevor Details kommen.
Das Buch richtet sich an Entwickler, die einen Agenten nicht nur benutzen, sondern nachbauen oder erweitern wollen. Es beschreibt ausdrücklich Werkzeuge, Berechtigungen, Gedächtnis, Kontextverwaltung und Mehr-Agenten-Orchestrierung als zusammenhängende Subsysteme. Für Anwender, die Claude Code nur installieren und Prompts schreiben wollen, ist der Stoff zu tief. Für Teams, die eine eigene Laufzeit entwerfen, ist er genau die Ebene, auf der Entscheidungen fallen. Ein Hinweis im README ist wichtig: Das Buch ist eine unabhängige technische Analyse, keine offizielle Publikation von Anthropic.
Die behauptete Mechanik: QueryDeps, Werkzeugprotokoll, vierstufige Kompression
Die Kapitelübersicht nennt konkrete Mechanismen, und sie sind spezifisch genug, um sie zu prüfen. Kapitel 02 beschreibt eine Hauptschleife als asynchronen Generator in einem while(true), mit fünf Yield-Ereignissen, zehn Abbruchgründen und einer Abhängigkeitsinjektion namens QueryDeps. Kapitel 03 führt ein Protokoll Tool<I,O,P> mit fünf Bestandteilen ein, dazu eine Fabrik buildTool und eine gierige Partitionierung für Nebenläufigkeit. Kapitel 04 skizziert eine vierstufige Berechtigungs-Pipeline, fünf Berechtigungsmodi und einen spekulativen Klassifikator, der laut Kapitelübersicht ein Promise.race über zwei Sekunden fährt.
Die Kapitel 06 und 07 sind die inhaltlich interessantesten. Kapitel 06 nennt vier geschlossene Gedächtnistypen und die Regel, nur Informationen zu speichern, die sich nicht ableiten lassen, mit einer MEMORY.md als Index. Kapitel 07 arbeitet mit einer Formel für das effektive Fenster und vier Stufen progressiver Kompression: Snip, MicroCompact, Collapse, AutoCompact, abgesichert durch ein Circuit-Breaker-Muster. Das ist eine konkrete Architekturerzählung, keine Werbebroschüre. Ob die Stufen in dieser Reihenfolge und mit diesen Namen im heutigen Claude Code existieren, kann ich nicht bestätigen, und das Buch selbst weist darauf hin, dass Funktionsflags und Werkzeugverfügbarkeit von Build- und Laufzeitkonfiguration abhängen.
Was das Buch über sich selbst einräumt
Der Abschnitt 阅读说明 ist bemerkenswert ehrlich für ein technisches Werk dieser Art. Er verlangt vom Leser, drei Dinge auseinanderzuhalten: Verhalten, das sich im Quellcode bestätigen lässt, Architektur-Rekonstruktion und didaktische Beispiele. Außerdem stellt er klar, dass Anzahl- und Laufzeitbeispiele keine Zusage für die aktuelle Ausgabe darstellen. Das ist die entscheidende Einschränkung dieses Projekts: Es beschreibt einen beweglichen Gegenstand. Claude Code wird von Anthropic weiterentwickelt, das Buch kann nur den Stand einfangen, den der Autor analysiert hat. Der letzte Push liegt laut Repository-Metadaten bei 2026-09-05, doch daraus folgt nicht, dass jedes Kapitel denselben Stand abbildet.
Für einen Ingenieur heißt das: Das Buch liefert Hypothesen über Aufbau und Entwurfsentscheidungen, keine Spezifikation. Wer auf ein Detail baut, muss es am echten Verhalten nachmessen. Die Anhänge mildern das Problem, weil sie als Nachschlagewerk angelegt sind: Anhang A listet 16 Kernmodule, einen Abhängigkeitsbaum, sechs Datenflusspfade und zehn Entwurfsmuster. Anhang C führt 89 Funktionsflags in 13 Kategorien mit Kompilierzeit- oder Laufzeittyp. Das sind die Stellen, an denen ein Leser am schnellsten merkt, ob das Buch noch zur eigenen Version passt.
Prüfwerkzeuge statt Vertrauen
Das Repository bringt eigene Kontrollen mit, und die sind der praktischste Teil des Ganzen. Vor einem Beitrag verlangt das README zwei Befehle: python3 scripts/check_book.py und python3 -m unittest discover -s tests. Die Mermaid-Prüfung braucht Node.js 22 oder höher, danach npm ci und npm run check:diagrams. Wer das Buch als Quelle für eigene Arbeit nutzt, kann diese Prüfungen lokal laufen lassen, um zu sehen, ob der Bestand konsistent ist. Das ersetzt keine Verifikation der Aussagen über Claude Code, zeigt aber, ob Links, Struktur und Diagramme intakt sind.
Bemerkenswert ist der Hinweis, dass bei zweisprachigen Inhalten die englische Fassung mitgeprüft werden soll. Das deutet auf zwei parallel gepflegte Textbestände hin, was den Wartungsaufwand erhöht. Die englische Fassung liegt unter en/, und das README verlinkt sie über en/README.md. Wie vollständig sie ist, lässt sich aus dem Material nicht ableiten.
Wartung, Lizenz und die Frage der Aktualität
Die Lizenz ist im Repository als unknown angegeben, das README nennt jedoch CC BY-NC-SA 4.0 für den Text. Das bedeutet: Namensnennung, keine kommerzielle Nutzung, Weitergabe von Bearbeitungen unter derselben Lizenz. Für die interne Weitergabe in einem Unternehmen ist die NC-Klausel der kritische Punkt, und wer das Buch in Schulungsmaterial einbaut, sollte das vorher klären. Das README sagt außerdem ausdrücklich, dass die Buchlizenz fremden Quellcode nicht abdeckt. Wer Codeausschnitte aus dem Buch übernimmt, braucht dafür eine eigene Grundlage.
Der Wartungsaufwand liegt beim Autor und bei Beiträgen über Issue oder PR. Das README verlangt dafür Kapitel, Abschnitt, Änderungsvorschlag und Quelle, bei Darstellungsproblemen zusätzlich Plattform und Reproduktionsschritte. Es gibt keine abgerufenen Releases, also keinen versionierten Stand, an dem man sich festhalten könnte. Ein Leser, der Zitate mit Standangabe braucht, hat hier ein Problem: Er kann nur auf den letzten Push verweisen, nicht auf eine Ausgabe.
Die Alternative: Primärquellen und ausführbarer Code
Der nächste Vergleich liegt nahe: Anthropics eigene Dokumentation und der veröffentlichte Quellcode von Claude Code. Der Unterschied ist grundsätzlich. Primärquellen zeigen, was tatsächlich läuft, aber sie erklären die Entwurfsentscheidungen nicht und ordnen die Teile nicht zu einem Modell. Das Buch tut das Gegenteil: Es liefert die Ordnung und die Begründungen, aber auf dem Stand eines bestimmten Moments und in einer Sprache, die nicht jeder Leser des Quellcodes spricht.
Ein zweiter Vergleich: ausführbare Beispielprojekte, die einen minimalen Agenten samt Werkzeugaufruf und Schleife hinstellen. Solche Projekte lassen sich starten und debuggen, sie decken aber die Randfälle nicht ab, um die es hier geht: Berechtigungsstufen, Kontextkompression, Fork-Vererbung, MCP-Brücken. Kapitel 15 verspricht eine sechsschrittige Umsetzungsroute, Lösungen für zirkuläre Abhängigkeiten, ein vierstufiges Observability-System und ein Sicherheitsbedrohungsmodell. Wenn dieses Kapitel hält, was die Übersicht nennt, ist es der Teil, der sich am ehesten gegen ausführbaren Beispielcode behaupten kann. Prüfen lässt sich das nur durch Lesen.
Wohin der Blick zuerst gehen sollte
Wer das Buch auswerten will, sollte mit den Anhängen beginnen, nicht mit Kapitel 1. Anhang D enthält laut Übersicht 100 zweisprachige Begriffe mit Querverweisen und Kapitelverweisen. Das ist der schnellste Weg festzustellen, ob die verwendete Terminologie zur eigenen Version von Claude Code passt. Danach Anhang C mit den 89 Funktionsflags: Wenn ein Flag, auf das man sich stützt, dort als Kompilierzeit-Flag geführt wird, ändert das die Erwartung an das Laufzeitverhalten.
Der schwächste Punkt des Projekts ist die fehlende Versionierung und die unbekannte Lizenzangabe in den Repository-Metadaten, die im Widerspruch zur CC-BY-NC-SA-4.0-Angabe im README steht. Der stärkste Punkt ist die Bereitschaft, zwischen bestätigtem Verhalten, Rekonstruktion und Lehrbeispiel zu unterscheiden. Diese Trennung ist der Grund, warum das Buch als Ausgangspunkt taugt und nicht als Endpunkt.
Redaktionelles Fazit
Wer einen Agent Harness baut oder Claude Code nicht nur bedienen, sondern verstehen will, findet hier die einzige mir bekannte zusammenhängende Beschreibung der Innenschichten, allerdings auf Chinesisch und ohne Garantie auf Aktualität. Wer eine Bibliothek zum Einbinden, eine englische Referenz oder einen gepflegten Changelog braucht, sollte woanders suchen. Vor dem Vertrauen in ein Detail zuerst das betreffende Kapitel lesen, dann das Repository klonen und mit python3 scripts/check_book.py sowie python3 -m unittest discover -s tests prüfen, ob die Prüfungen überhaupt laufen; ob die beschriebenen Mechanismen dem heutigen Claude Code entsprechen, lässt sich nur am Quellcode von Anthropic selbst verifizieren, den das Buch nicht mitliefert.
Community-Notizen