stormzhang/ai-coding-guide: 92 chinesische Kapitel zu Claude Code und Codex

Zwei Agenten, ein Repository, eine Sprache

Das Repository behandelt zwei Kommandozeilen-Agenten, die unterschiedliche Konfigurationsmodelle haben. Claude Code arbeitet laut der Kapitelübersicht mit CLAUDE.md, settings.json, Hooks, Subagents, Skills und einer Berechtigungsstufe, die pro Werkzeug eingestellt wird. Codex arbeitet mit AGENTS.md, config.toml, Sandbox und Freigabeschritten sowie einer Memory-Funktion namens Chronicle. Wer beide Werkzeuge parallel einsetzt, muss zwei verschiedene Satzdateien und zwei verschiedene Autorisierungslogiken lernen. Genau dort setzt das Repository an: Es legt die Begriffe beider Systeme nebeneinander, statt sie als austauschbare Varianten desselben Produkts zu behandeln. Die Zielgruppe ist ausdrücklich als Einsteiger ohne Kommandozeilen-Erfahrung beschrieben, und die Kapitel 01 bis 07 beider Reihen sind Einrichtung, Konto, Abrechnung und ein erster Durchlauf. Ein Hinweis auf die Sprache: Das Repository ist auf Chinesisch, die englische Datei README.en.md existiert, aber der beschriebene Umfang von 92 Artikeln und rund 520.000 Zeichen bezieht sich auf die chinesische Fassung.

Der Aufbau ist eine Route, kein Nachschlagewerk

Die 53 Kapitel zu Claude Code sind durchnummeriert und bauen aufeinander auf: erst Installation und API-Konfiguration, dann Projektinitialisierung mit /init, danach Kontextverwaltung, Berechtigungen und Sicherheit, und erst ab Kapitel 22 kommen MCP, Subagents, Plugins, Memory und Skills. Die 39 Kapitel zu Codex folgen demselben Muster von der Installation über die vier Einstiegspunkte bis zu Sandbox, Freigabe und Migration von Claude Code. Diese Reihenfolge ist die eigentliche Leistung des Projekts. Wer Hooks verstehen will, landet nicht direkt in Kapitel 33, sondern hat vorher die Kapitel zu Berechtigungen und Kontext gelesen, die erklären, warum ein Hook überhaupt nötig ist. Der Preis dafür ist, dass ein einzelnes Kapitel selten für sich steht. Kapitel 30 vergleicht CLAUDE.md, Skill, Hook, MCP und Subagent gegeneinander, setzt aber voraus, dass der Leser die fünf Begriffe schon aus den vorherigen Kapiteln kennt. Als Nachschlagewerk für einen einzelnen Befehl ist das Repository schlechter geeignet als die offizielle CLI-Referenz, die es selbst als Kapitel 34 verlinkt.

Was tatsächlich im Repository liegt

Der Umfang ist Text plus Bilder. Nach eigener Angabe enthält das Projekt 81 Abbildungen im SVG- oder PNG-Format, alle im dunklen Stil und mit der Vorgabe, dass ein Diagramm höchstens zehn Knoten hat. Das ist eine Designentscheidung mit Folgen: Wer ein komplexes Zusammenspiel aus mehreren Agenten und Werkzeugen erklären will, muss es auf mehrere kleine Bilder aufteilen. Die Topics des Repositories nennen agent, ai-coding, anthropic, chinese-tutorial, claude-code, cli, codex, llm, openai und tutorial. Aus der Repository-Beschreibung und der README geht kein ausführbarer Code hervor. Es gibt keine Testsuite, keine Beispieldateien und keine Skripte, die man klonen und starten könnte. Wer erwartet, dass ein Repository mit dem Wort guide ausführbare Beispiele enthält, wird enttäuscht. Die README spricht von vollständigen Befehlen und erwarteten Ausgaben pro praktischem Abschnitt, was sich auf den Fließtext der Artikel bezieht, nicht auf Dateien im Repository.

Die Website ist der eigentliche Lesepfad

Die README verweist für jede einzelne der 92 Lektionen auf eine URL unter coding.stormzhang.ai, jeweils mit einem Slug wie /claude-code/19-context-management oder /codex/08-cli. Das Repository selbst dient damit als Index und als Quelle für die Markdown-Dateien, während die Leseempfehlung auf die Website zeigt. Für die Bewertung ist das relevant: Wer das Projekt ausprobieren will, muss entscheiden, ob er die Dateien im Repository liest oder die Website. Die README begründet den Verweis mit einer besseren Darstellung im dunklen Terminalstil. Ein Repository, dessen Hauptprodukt eine separate Website ist, hat ein bekanntes Wartungsproblem: Die beiden Fassungen können auseinanderlaufen, und die README lässt nicht erkennen, welche Seite bei einem Widerspruch gilt. Die Kapitelnummern sind in beiden Fassungen identisch, was den Abgleich erleichtert.

Installation und Konfiguration: was konkret genannt wird

Die Einrichtung wird in beiden Reihen getrennt behandelt, weil die Werkzeuge unterschiedlich installiert und angemeldet werden. Kapitel 03 der Codex-Reihe trägt den Titel Installation und Anmeldung für Mac, Windows und Linux. Kapitel 02 der Claude-Code-Reihe behandelt Installation und Nutzung, Kapitel 04 die Wahl zwischen Abonnement-Anmeldung und API-Schlüssel und Kapitel 05 den Anschluss von Drittanbietern und inländischen Modellen. Auf der Konfigurationsseite nennt die Kapitelübersicht für Claude Code die Datei settings.json mit einer Unterscheidung zwischen Benutzer- und Projektebene, die Umgebungsvariablen in Kapitel 42 und die Datei CLAUDE.md, die mit dem Befehl /init erzeugt wird. Für Codex nennt die Übersicht die Datei config.toml sowie AGENTS.md. Das sind die einzigen konkreten Bezeichner, die sich aus dem vorliegenden Material sicher ableiten lassen. Die vollständigen Befehle und erwarteten Ausgaben stehen laut README in den Artikeln selbst und nicht in der README, sodass ich hier keine Befehlszeilen wiedergeben kann.

Wo das Material dünn wird

Die README macht eine starke Zusage: Jedes neue Konzept werde in drei Schritten erklärt, mit Szenario, Alltagsvergleich und praktischem Fall, und jede Lektion enthalte mindestens drei Stellen mit persönlicher Erfahrung aus erster Hand samt konkreten Zahlen. Solche Selbstzusagen lassen sich aus dem Repository nicht überprüfen, und sie sind auch kein Qualitätsmerkmal. Ein größeres Problem ist die Quellenlage der Inhalte. Die README nennt developers.openai.com/codex und code.claude.com/docs/zh-CN als Faktenbasis und grenzt sich gegen Spekulation Dritter ab. Das ist die richtige Haltung, bedeutet aber auch: Wo die offizielle Dokumentation schweigt oder sich ändert, hat das Repository keine eigene Messung, auf die es zurückfallen könnte. Ein weiterer Punkt betrifft die Ausrichtung. Die README bezeichnet Codex mit 39 Kapiteln als Haupteinstieg und behält Claude Code mit 53 Kapiteln bei. Die Kapitelzahl sagt nichts über die Aktualität der älteren Claude-Code-Reihe, und ob alle 53 Artikel gegen die aktuellen Versionen abgeglichen wurden, geht aus dem Material nicht hervor. Wer eine dieser Lektionen als verbindlich behandelt, sollte den Stand der verlinkten offiziellen Seite prüfen.

Alternative: die offizielle Dokumentation selbst

Die naheliegende Alternative ist die Dokumentation, die das Repository als Quelle nennt: developers.openai.com/codex und code.claude.com/docs/zh-CN. Der Unterschied liegt nicht im Inhalt, sondern in der Form. Die offizielle Dokumentation ist nach Funktionen gegliedert und setzt voraus, dass der Leser weiß, welches Problem er lösen will. Das Repository ist nach Lernreihenfolge gegliedert und setzt voraus, dass der Leser noch nicht weiß, welche Funktion er braucht. Für einen Einsteiger ist die zweite Form nützlicher, für einen erfahrenen Nutzer, der eine Option in config.toml nachschlägt, die erste. Ein zweiter Unterschied ist die Sprache. Beide offiziellen Seiten bieten chinesische Fassungen, aber die Struktur bleibt die einer Produktdokumentation, nicht die eines Kurses. Wer bereits mit einem der beiden Agenten arbeitet und nur ein bestimmtes Verhalten verstehen will, ist mit der offiziellen Seite schneller, weil er nicht durch 53 Kapitel navigieren muss, um bei Kapitel 33 zu landen.

Lizenz, Wartung und was vor dem Einstieg zu prüfen ist

Das Repository steht unter der MIT-Lizenz, angegeben in der README und in der Datei LICENSE. Diese Lizenz erlaubt Weitergabe und Bearbeitung, verlangt aber den Erhalt des Urheberrechtsvermerks und des Lizenztextes. Für ein Textprojekt ist das die übliche Wahl, und sie hat eine praktische Folge: Wer Teile in eigene Schulungsunterlagen übernimmt, muss die Herkunft kennzeichnen. Das ist eine Beschreibung der Lizenzbedingungen und keine Rechtsberatung. Zur Wartung lässt sich aus dem Material wenig sagen. Der letzte Push liegt laut Repository-Metadaten im September 2026, das Repository ist nicht archiviert, und es wurden keine Releases abgerufen. Ein versionierter Stand, an dem man sich festhalten könnte, existiert damit nicht. Wer das Repository als Grundlage für ein eigenes Schulungsprogramm nutzt, sollte vorher zwei Dinge klären: ob die Kapitel zu den von ihm eingesetzten Versionen von Claude Code und Codex passen, und ob die Website oder die Markdown-Dateien im Repository die maßgebliche Fassung sind. Beide Fragen lassen sich nur durch einen Blick in das jeweilige Kapitel beantworten, nicht durch die README.

Redaktionelles Fazit

Wer chinesisch liest und Claude Code oder Codex zum ersten Mal einrichtet, findet hier eine nach Themen sortierte Route von der Installation bis zu Hooks und MCP, die kein anderes mir bekanntes Repository in dieser Dichte abdeckt. Wer ausführbaren Code, Tests oder eine englische Fassung braucht, sollte nicht einsteigen: Das Repository liefert Prosa und statische Bilder, und die englische Datei README.en.md ist nur die Kurzfassung des Einstiegs. Vor dem Vertrauen in ein einzelnes Kapitel lohnt der Abgleich mit der dort verlinkten offiziellen Dokumentation, denn das Repository nennt selbst developers.openai.com/codex und code.claude.com/docs/zh-CN als Quelle und veröffentlicht keine Prüfstände.

Offizielle Quellen

1. Issues
2. License: MIT
3. Project website
4. README
5. stormzhang/ai-coding-guide on GitHub