claude-reviews-claude: eine 17-teilige Architekturanalyse von Claude Code v2.1.88

Ein Modell liest den Code, der sein eigenes Verhalten bestimmt

Das Repository beschreibt sich selbst als Versuch, den Quelltext von Claude Code v2.1.88 vollständig zu lesen und in eine strukturierte Analyse zu überführen. Laut README umfasst die Codebasis 1.902 Dateien und 477.439 Zeilen TypeScript, ausgeführt auf Bun, mit einer Terminal-Oberfläche auf Basis von React und Ink. Die Zielgruppe sind nicht Anwender, die Claude Code bedienen, sondern Entwickler, die ein agentisches CLI-System bauen oder ein bestehendes bewerten wollen. Der Nutzen liegt in der Gliederung: 17 Kapitel mit Kapitelnummern, jeweils mit Zeilenangaben zum untersuchten Subsystem, etwa 1.296 Zeilen für die QueryEngine oder 11.500 Zeilen für die Bash-Ausführung. Wer eine vergleichbare Architektur entwirft, kann diese Aufteilung als Prüfliste verwenden und sehen, welche Subsysteme ein solches Werkzeug überhaupt benötigt. Das ist der eigentliche Wert, nicht die Feststellung, dass ein Modell seinen eigenen Code gelesen hat.

Der Kern ist ein Werkzeugzyklus, alles andere ist Rahmen

Die Analyse stellt einen Ablauf in den Mittelpunkt, den das README selbst als dummen Zyklus bezeichnet: Nutzereingabe, Aufruf von QueryEngine.query(), ein Streaming-Aufruf an die Claude-API, danach eine Verzweigung. Endet der Aufruf mit stop_reason = end_turn, wird die Antwort ausgegeben. Endet er mit stop_reason = tool_use, folgen eine Berechtigungsprüfung, die Ausführung des Werkzeugs und das Zurückspielen des Ergebnisses in den nächsten Schleifendurchlauf. Die Formulierung aus dem README, die Intelligenz liege im LLM und das Gerüst sei nur eine Schleife, beschreibt diese Konstruktion treffend. Bemerkenswert ist die Konsequenz: Sitzungszustand, Kontextverwaltung und Kompression sind nicht Teil des Zyklus, sondern liegen daneben und müssen ihn über mehrere Runden hinweg tragen. Das erklärt, warum das Repository den Kompressions- und den Persistenzkapiteln eigenen Raum gibt. Ein einzelner Durchlauf braucht diese Schichten nicht. Ein Gespräch über Stunden schon.

42 Werkzeuge, sieben Sicherheitsebenen, vier Kompressionsstufen

Nach der Darstellung im README besteht das System aus sechs Säulen: einem Systemprompt mit Identität, Regeln und Beschreibungen für mehr als 42 Werkzeuge, dem Werkzeugsystem, dem Abfragezyklus als zwölfstufiger Zustandsmaschine, der Kontextverwaltung, der Berechtigungs- und Sicherheitsschicht sowie der Koordination mehrerer Agenten. Die Zahlen sind im README aufgeführt und nicht unabhängig überprüfbar. Für die Berechtigungen nennt das Repository sieben Ebenen der Verteidigung in der Tiefe, aufgeteilt auf Konfigurationsregeln, Werkzeugprüfungen und Betriebssystem-Sandbox. Die Kontextverwaltung arbeitet laut README mit vier Kompressionsstufen, an anderer Stelle ist von drei Stufen die Rede: Mikrokompression, Sitzungsgedächtnis und LLM-Zusammenfassung. Diese Uneinheitlichkeit zwischen Architekturgrafik und Kapitelbeschreibung ist ein redaktioneller Mangel, den man beim Lesen im Blick behalten sollte. Die Persistenz verwendet dem README zufolge ein reines Anhänge-JSONL-Format mit parent-UUID-Kette und einer leichten Wiederherstellung ab 64 KB. Das ist ein konkretes Detail, das sich in eigenen Entwürfen prüfen lässt.

Lesen im Browser statt Klonen

Das Repository liefert keine Software, die man installiert. Es gibt keinen Build, keine Testsuite und keinen ausführbaren Einstiegspunkt. Die dokumentierte Nutzung ist das Lesen der Kapitel, entweder über GitHub Pages unter openedclaude.github.io/claude-reviews-claude/zh-CN/ oder direkt im Repository. Die Pages-Variante bietet laut README Volltextsuche, Dunkelmodus und Kapitelnavigation. Ein Klon ist nur nötig, wenn man die Markdown-Quellen lokal durchsuchen oder in eine eigene Dokumentation einbinden will. Wer die Analyse mit dem tatsächlichen Quelltext abgleichen möchte, wird auf zwei Community-Repositories verwiesen: instructkr/claw-code und ChinaSiro/claude-code-sourcemap, letzteres mit aus Source Maps extrahiertem TypeScript. Beide sind Dritte, nicht Teil dieses Projekts. Wer die Analyse als Grundlage für eigene Arbeit nutzt, sollte diesen Umweg einplanen, denn ohne den Quelltext bleibt jede Aussage der Kapitel eine Behauptung über Code, den man nicht selbst eingesehen hat.

Die Grenze verläuft zwischen Dokumentation und Betrieb

Die offensichtlichste Einschränkung ist die Versionsbindung. Die gesamte Analyse bezieht sich auf Claude Code v2.1.88. Ändert sich die interne Struktur, veralten Kapitel stillschweigend, weil es keine Prüfmechanik gibt, die eine Abweichung meldet. Ein zweiter Punkt betrifft die Herkunft: Die Analyse beruht auf community-rekonstruiertem Quelltext, nicht auf einer offiziellen Veröffentlichung durch Anthropic. Ob die rekonstruierte Fassung mit dem ausgelieferten Programm übereinstimmt, lässt sich aus dem Material nicht belegen. Drittens fehlt jede Messung. Das README nennt Zeilenzahlen und Dateimengen, aber keine Laufzeitdaten, keine Speicherprofile, keine Vergleichswerte. Wer wissen will, wie sich die Kompressionsstufen auf die Antwortqualität auswirken, findet hier keine Antwort. Und schließlich ist das Projekt für die Fehlersuche am eigenen System ungeeignet. Es beschreibt, wie Claude Code gebaut ist, nicht, warum eine bestimmte Sitzung abgebrochen ist.

Was andere Quellen anders machen

Als Alternative bietet sich die offizielle Claude-Code-Dokumentation an. Der Unterschied liegt nicht in der Qualität, sondern in der Richtung. Die offizielle Dokumentation beschreibt das Verhalten von außen: welche Befehle existieren, welche Konfigurationsdateien gelesen werden, welche Berechtigungsmodi es gibt. Sie ist für den Betrieb gedacht und wird mit dem Produkt gepflegt. Dieses Repository beschreibt die Innenseite: welche Klasse den Zyklus trägt, wie Werkzeuge registriert werden, wie die Kompression mehrstufig greift. Beide Quellen beantworten verschiedene Fragen. Wer eine Erweiterung schreiben will, braucht die offizielle Schnittstellendokumentation, weil die interne Struktur kein Vertrag ist und sich ohne Ankündigung ändern darf. Wer beurteilen will, ob das Design eines agentischen Werkzeugs tragfähig ist, findet in der internen Analyse mehr Substanz. Die Kapitel zu Berechtigungen und zur Bash-Ausführung sind dort am nützlichsten, wo sie konkrete Mechanismen statt Absichten beschreiben.

Zweisprachig, MIT-lizenziert, ohne Release-Zyklus

Der Inhalt liegt auf Englisch und Chinesisch vor, mit einer Sprachumschaltung im README. Das verdoppelt den redaktionellen Aufwand bei jeder Änderung, und die Uneinheitlichkeit zwischen vier und drei Kompressionsstufen deutet darauf hin, dass diese Pflege nicht überall gleichmäßig erfolgt. Das Repository steht unter der MIT-Lizenz. Das erlaubt die Übernahme von Text in eigene Unterlagen auch in kommerziellen Zusammenhängen, sofern der Urheberrechtshinweis und der Lizenztext erhalten bleiben. Zu beachten ist, dass die Lizenz das Repository selbst betrifft, nicht den analysierten Claude-Code und nicht die verlinkten Community-Rekonstruktionen. Wer Passagen übernimmt, sollte den Hinweis auf die analysierte Version v2.1.88 mitführen, sonst wird aus einer Momentaufnahme eine Aussage ohne Datum. Für die Wartung gibt das Material wenig her: Es gibt keine abgerufenen Releases, der letzte Push liegt laut Repository-Metadaten im April 2026, und ein Verfahren zum Nachführen bei neuen Claude-Code-Versionen ist nicht beschrieben. Das Projekt ist damit eher eine Momentaufnahme als eine fortlaufend gepflegte Referenz.

Redaktionelles Fazit

Wer die interne Struktur von Claude Code verstehen will, ohne selbst 477.439 Zeilen TypeScript zu lesen, findet hier eine gegliederte Einstiegsquelle mit Kapitelnummern und Querverweisen. Wer belastbare Aussagen über das Verhalten einer bestimmten Claude-Code-Version braucht, sollte zuerst prüfen, ob die analysierte Fassung v2.1.88 noch der eingesetzten entspricht, und die Kapitel 7 (Permission Pipeline) und 11 (Compact System) gegen den eigenen Quelltext abgleichen. Vor jedem Zitat in eigener Dokumentation ist zusätzlich zu klären, ob die community-rekonstruierte Codebasis, auf der die Analyse beruht, denselben Stand wie das offizielle Release hat.

Offizielle Quellen

1. Issues
2. License: MIT
3. openedclaude/claude-reviews-claude on GitHub
4. Project website
5. README