claude-reviews-claude : une analyse architecturale de Claude Code, écrite par Claude

Un objet documentaire, pas un paquet

Le nom du dépôt induit en erreur : rien ici ne s'installe. Il n'y a pas de dépendance à ajouter, pas de binaire à compiler, pas de serveur à lancer. Le README décrit un projet déployé sur GitHub Pages, avec recherche plein texte, mode sombre et navigation par chapitres, et recommande explicitement la lecture en ligne plutôt que le rendu Markdown natif de GitHub. Le dépôt contient donc du texte et une configuration de site, pas une bibliothèque.

Le problème résolu est précis. Claude Code v2.1.88 représente, selon le README, 1 902 fichiers et 477 439 lignes de TypeScript. Personne ne lit cela linéairement pour comprendre comment un agent de codage organise ses boucles, ses outils et ses permissions. Le projet vend une traversée guidée de cette masse, en 17 chapitres thématiques, chacun relié à un sous-système identifié. Le public visé est l'ingénieur qui conçoit lui-même un agent, ou qui doit décider s'il adopte Claude Code et veut savoir ce qu'il y a sous le capot avant de le faire.

Le mécanisme réel : une boucle, six piliers

Le README expose une thèse architecturale simple et la répète sous forme de schéma : l'intelligence réside dans le modèle, le reste n'est qu'un harnais de production autour d'une boucle. Cette boucle est décrite pas à pas. L'utilisateur saisit une entrée, QueryEngine.query() appelle l'API Claude en streaming, puis examine stop_reason. Si la valeur est end_turn, le résultat est renvoyé. Si la valeur est tool_use, le système enchaîne une vérification de permission, l'exécution de l'outil, puis la réinjection du résultat dans la boucle. Le README qualifie cette boucle de «笨循环», littéralement une boucle bête.

Autour d'elle, six piliers sont nommés : le system prompt (identité, règles, descriptions de plus de 42 outils), le système d'outils, la gestion de contexte avec quatre niveaux de compression, la sécurité avec sept couches de défense en profondeur, les clusters multi-agents avec trois backends et sept types de tâches, et enfin les skills et plugins avec six sources et le protocole MCP. Le chapitre 1 décrit QueryEngine comme un fichier de 1 296 lignes gérant les requêtes LLM, la boucle d'outils et l'état de session. Le chapitre 2 annonce plus de 42 outils en modules autonomes. Ces chiffres proviennent du README et des titres de chapitres, pas d'une inspection du code de Claude Code lui-même.

Lire le dépôt : Pages plutôt que git clone

La mise en route tient en une URL. Le README pointe vers https://openedclaude.github.io/claude-reviews-claude/zh-CN/ pour la version chinoise, et chaque chapitre possède son propre lien, par exemple /zh-CN/chapters/01-query-engine ou /zh-CN/chapters/07-permission-pipeline. La version anglaise est accessible depuis README_EN.md et depuis le sélecteur de langue du site.

Pour qui veut lire le dépôt hors ligne, un git clone du dépôt sur la branche main suffit, mais le README prévient que le rendu Markdown de GitHub est moins confortable que le site. Aucune clé de configuration, aucun fichier de paramètres, aucune variable d'environnement n'est mentionné dans le matériel fourni : il n'y a rien à configurer, ce qui est cohérent avec la nature documentaire du projet.

Le README indique aussi que l'analyse porte sur le code source TypeScript de Claude Code v2.1.88, et renvoie vers deux dépôts communautaires de code restauré : instructkr/claw-code et ChinaSiro/claude-code-sourcemap. C'est le seul chemin proposé pour confronter le texte au code, puisque le dépôt analysé n'est pas distribué ici.

Ce que le dépôt ne prouve pas

Le README affirme que l'analyse a été écrite par Claude après lecture des sources. Cette affirmation n'est pas vérifiable à partir du matériel fourni, et elle n'a pas à être crue sur parole : ce qui compte est que chaque chapitre soit cohérent avec le code de v2.1.88, ce que seul un lecteur disposant des sources restaurées peut établir.

La limite la plus concrète est la version. L'analyse est ancrée sur v2.1.88, et rien n'indique dans le matériel fourni qu'un mécanisme de suivi ou de mise à jour soit prévu lorsque Claude Code évolue. Une documentation architecturale qui décrit un logiciel propriétaire en mouvement rapide vieillit par nature. Le README présente d'ailleurs le contenu comme une «Season 1» de 17 épisodes, une métaphore de publication par lots qui suggère un ensemble fini plutôt qu'un document entretenu en continu.

Deuxièmement, le dépôt n'est pas une source de vérité juridique ni un audit de sécurité. Le chapitre 17 aborde la télémétrie, la vie privée et les contrôles opérationnels, mais lire une description de sept couches de permissions ne remplace pas l'inspection du code qui les implémente. Un lecteur qui cherche à évaluer la posture de sécurité de Claude Code pour un déploiement réglementé doit aller au code, pas au commentaire.

Face à une simple lecture du code restauré

L'alternative évidente est de cloner instructkr/claw-code ou ChinaSiro/claude-code-sourcemap et de lire le TypeScript directement. La différence d'approche est nette. Le code restauré donne l'état exact, y compris les fichiers que personne ne documente, mais il ne fournit aucune hiérarchie : savoir que QueryEngine fait 1 296 lignes ne dit pas quelles lignes portent la logique de boucle et quelles lignes gèrent les cas d'erreur. Le dépôt d'analyse fait l'inverse : il impose une sélection et un ordre, au prix d'une couche d'interprétation entre le lecteur et le code.

Pour un lecteur qui doit modifier ou étendre Claude Code, le code source reste indispensable. Pour un lecteur qui conçoit son propre agent et cherche des motifs transposables (boucle pilotée par stop_reason, validation d'outils en modules, compression à plusieurs niveaux), la lecture ordonnée du dépôt fait gagner du temps, à condition d'accepter que les conclusions soient celles d'un tiers.

Il faut aussi noter que l'analyse existe en anglais et en chinois. Un lecteur francophone n'a donc pas de version dans sa langue, et devra choisir entre les deux. Ce n'est pas un défaut en soi, mais cela fait partie du coût d'entrée réel.

Coût de maintenance et licence

Le dépôt est publié sous licence MIT, ce qui autorise la réutilisation, la modification et la redistribution du texte, y compris à des fins commerciales, sous réserve de conserver l'avis de licence. Cela ne dit rien du statut du code de Claude Code lui-même, qui n'est pas distribué ici et dont la licence n'est pas mentionnée dans le matériel fourni. Reprendre des extraits de code cités dans les chapitres est donc une question distincte de la licence MIT du dépôt, et le README ne l'aborde pas.

En termes de maintenance, le coût se limite à suivre les mises à jour du dépôt : il n'y a pas de dépendance transitive, pas de surface d'attaque logicielle, pas de montée de version à gérer. La date du dernier push indiquée est le 1er avril 2026, et aucune release n'est répertoriée dans le matériel fourni. Le risque n'est pas technique mais éditorial : si Claude Code change de version majeure, le contenu reste figé sur v2.1.88 sans obligation de mise à jour.

Conclusion éditoriale

Ce dépôt convient à qui veut une lecture guidée de l'architecture de Claude Code v2.1.88 sans éplucher 477 439 lignes de TypeScript, et à qui travaille en anglais ou en chinois. Il ne convient pas à qui cherche un composant installable, un audit de sécurité ou une source de référence sur laquelle construire. Avant de s'y fier, il faut vérifier que le chapitre 0 (Overview) et le chapitre 17 (Telemetry, Privacy and Operations) sont à jour par rapport à la version de Claude Code que l'on utilise réellement, et confronter au moins un chapitre à l'un des deux dépôts de code restauré cités dans le README.

Sources officielles

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