claude-reviews-claude を読む：Claude Code v2.1.88 を Claude 自身が分解した17章
Claude reads its own source code — 17-chapter architectural deep-dive into Claude Code v2.1.88. EN/ZH bilingual.
ひと目でわかる
- これは何？
- 47.7万行の TypeScript を題材にした、Claude Code の内部アーキテクチャ解説ドキュメント。コードを動かすツールではなく、読むための資料であり、採用判断は「読む価値があるか」で下すべき性質のリポジトリだ。
- 誰に向いている？
- Claude Code の内部構造を設計資料として読みたいエンジニア、とくにエージェントループやツール登録、権限パイプラインの実装パターンを自分のプロダクトに流用したい人に向く。逆に、動くコードやライブラリを求めている人には無意味だ。
- 商用利用できる？
- できます。MIT は寛容なライセンスで、著作権表示とライセンス表示を残せば、使用・改変・販売が可能です。
- 今もメンテナンスされている？
- されています。最後のコミットは 167 日前です。
- 何の言語で書かれている？
- GitHub はこのリポジトリの主な言語を示していません。
回答はプロジェクトの GitHub データ（最終同期：2026年9月15日）と当サイトの分析に基づくもので、法的助言ではありません。
オープンソース詳細解説
このリポジトリが埋めるのは「コードはあるが地図がない」という穴
Claude Code のソースコードは、Anthropic 自身が公開しているわけではない。README によれば、コミュニティが復元した TypeScript ソースが別リポジトリとして存在し、claude-reviews-claude はそれを題材にした分析ドキュメントだ。対象は v2.1.88、規模は 1,902 ファイル、477,439 行の TypeScript。この規模のコードベースを前にすると、ファイル名を眺めて主要な型を追うだけでも数日かかる。どこから読めば全体像が掴めるのか、どのモジュールがどのモジュールに依存しているのかは、コードそのものからは読み取りにくい。
このリポジトリは、その地図の部分を17章で埋めようとしている。章立ては QueryEngine、Tool System、Coordinator、Plugin System、Hook System、Bash Engine、Permission、Agent Swarms、Session Persistence、Context Assembly、Compact System、Startup & Bootstrap、Bridge System、UI と状態管理、Services/API 層、Infrastructure、Telemetry と続く。対象読者は、Claude Code をそのまま使いたい人ではなく、エージェント型 CLI の内部設計を自分の実装に取り込みたい人だ。
注意すべきは、これが「動かすためのソフトウェア」ではないという点である。パッケージとしてインストールする対象ではなく、GitHub Pages で公開されている読み物として配布されている。
17章の並びは実行の流れではなく依存の流れで決まっている
README の章一覧を見ると、第1章が QueryEngine、第2章が Tool System、第3章が Coordinator と、ユーザー入力から応答までの流れに近い順で並んでいる。しかし第4章以降は Plugin、Hook、Bash、Permission と、実行時に差し込まれる拡張点や制約の話に移る。つまり「起動してから終了するまで」の時系列ではなく、中心となるループから外側の関心事へ広げる構成だ。
各章にはコード規模の目安が添えられている。Plugin System は1.88万行、Hook System は8千行、Bash Engine は1.15万行、Permission は9.5千行、Swarm は6.8千行、Session Persistence は7.6千行、Context Assembly は8.3千行、Compact System は3.9千行、Startup & Bootstrap は7.6千行以上、Bridge System は1.17万行、Services/API 層は1.2万行、Infrastructure は1.5万行。この数字の並び自体が読み方を示している。Plugin と Bridge と Infrastructure が突出して重く、Compact System は相対的に軽い。どこに複雑さが集中しているかが、章を開く前に見える。
第0章の Overview は17サブシステムの全景と「可迁移设计模式」を扱うと説明されている。個別章に入る前にここを読むかどうかで、以降の理解速度は変わるだろう。
中心にあるのは「LLM が賢く、足場はループにすぎない」という主張
README のアーキテクチャ概覧は、Claude Code を6つの柱で説明する。System Prompt、Tool System、Query Loop、Context Management、Permission/Security、Multi-Agent、Skill & Plugin。図の中心には QueryEngine.query() があり、Claude API をストリーミングで呼び、stop_reason が end_turn なら出力、tool_use なら権限チェック、ツール実行、結果の注入を経てループの先頭に戻る。この往復がすべての土台だと説明されている。
ここで README が使う表現が「笨循环（愚直なループ）」だ。42以上のツール、7層の防御、4層の圧縮、マルチエージェント調整。それらはすべて、この単純なループを製品品質にするための足場だと位置づけている。設計思想の主張としては明快で、読む側の期待値も揃う。個別の章を「賢いオーケストレーション」の話として読むと外れる。実際には、ループの外側にどれだけの検査と状態管理が積まれているかの話になる。
この主張が正しいかどうかは、このリポジトリだけでは判定できない。ただ、章の構成そのものがこの見方に沿って組まれていることは確かだ。
読み始める手順と、リポジトリをローカルに置く場合の注意
最も手軽な入口は GitHub Pages 版だ。README は https://openedclaude.github.io/claude-reviews-claude/zh-CN/ を推奨し、全文検索、ダークモード、章ナビゲーションに対応すると説明している。英語版は README_EN.md から辿れる。GitHub 上の Markdown レンダリングよりも Pages 版のほうが読みやすいというのが作者の主張で、17章を横断して用語を検索するなら Pages 版の検索に頼るのが現実的だ。
ローカルに複製する場合は通常の git clone でよい。リポジトリは MIT ライセンスで、ライセンスファイルは LICENSE。既定ブランチは main。ビルドやインストールの手順は README には示されていない。少なくとも取得できた範囲では、npm install や bun install を前提とした記述はなく、生成物を配布するパッケージではないと見るのが妥当だ。
注意点がひとつある。分析対象のソースコード自体はこのリポジトリには含まれていない。README は instructkr/claw-code と ChinaSiro/claude-code-sourcemap という別リポジトリを参照先として挙げている。章を読みながら原典を確認したいなら、これらを別途 clone して並べる必要がある。ライセンスはこのリポジトリのものであり、参照先リポジトリのライセンスや入手経路については README に説明がない。ここは自分で確認する範囲だ。
版が固定されていること、そして著者が Claude であること
最大の制約は、分析対象が v2.1.88 という一点に固定されていることだ。Claude Code は継続的に更新される製品であり、章番号や行数、モジュール構成は将来のバージョンで変わりうる。README もリリースノートも、この分析を追従更新する仕組みには触れていない。したがって「現在の Claude Code の構造」を知るためにこの資料を読むのは筋が悪い。ある時点のスナップショットとして読むのが正しい。
二つ目の制約は著者の性質だ。README は「这份完整的架构分析是由 Claude 撰写的」と明記し、1,902 ファイル、477,439 行を読んだ上で書かれたと述べている。これはつまり、内容は AI による二次的な記述であって、Anthropic の公式ドキュメントでも一次資料でもない。図や行数の引用が正確かどうかを、このリポジトリ単体で検証する手段は提供されていない。
この二点は欠陥ではなく、この資料の位置づけそのものだ。バージョン固定のスナップショットであり、AI が書いた解説であるという前提で読めば、17章は十分に密度がある。前提を外して「Claude Code の仕様書」として扱うと、いずれ古い記述に当たる。
代替になるのは復元ソースそのもの、あるいは公式の説明
このリポジトリの代替として最も直接的なのは、README が挙げている instructkr/claw-code や ChinaSiro/claude-code-sourcemap だ。違いは明白で、これらは分析ではなくソースコードそのものを提供する。アプローチとしては、原典を自分で読むか、誰かの読解を読むかという差になる。原典は正確だが、1,902 ファイルを前にした入口がない。このリポジトリは入口を提供する代わりに、解釈が挟まる。両方を並べて読み、章の記述をソースで裏取りするのが最も無駄が少ない。
もうひとつの選択肢は、Anthropic が提供する公式の説明を読むことだ。ただし公式ドキュメントは内部実装の詳細までは踏み込まない。QueryEngine の12ステップの状態機械や、Permission の7層構造といった粒度の情報は期待できない。内部の設計判断を知りたいなら、このリポジトリか復元ソースのどちらかに進むことになる。
第三の道として、自分でエージェント CLI を書いてみるという手もある。読解を読むより時間はかかるが、得られる理解は一次体験になる。このリポジトリは、その出発点として章立てを流用する使い方もできる。
維持コストは低いが、内容の鮮度は保証されない
MIT ライセンスなので、章の引用、翻訳、自社ドキュメントへの転載はライセンス条件の範囲で行える。ここで注意したいのは、このリポジトリのライセンスがカバーするのは分析テキストであって、分析対象の Claude Code のソースではないという点だ。ソースの権利関係は別の問題であり、README はそこに触れていない。転載や再配布を検討する場合は、テキストとソースを分けて考える必要がある。
メンテナンスの観点では、このリポジトリは依存パッケージを持たない読み物なので、破壊的変更やセキュリティ更新に追われる種類のコストは発生しない。発生するのは内容の陳腐化コストだ。対象バージョンが v2.1.88 に固定されている以上、Claude Code 側が変われば記述と現物がずれる。追従するかどうかは作者の判断に委ねられており、README には更新方針の記載がない。
読む側のコストとしては、GitHub Pages 版を読むだけならほぼゼロ。原典と突き合わせるなら、別リポジトリの clone と、該当章のモジュールを探す手間が加わる。17章すべてを突き合わせるのは現実的ではないので、自分の関心のある章に絞るのが妥当だ。
編集部の結論
Claude Code の内部構造を設計資料として読みたいエンジニア、とくにエージェントループやツール登録、権限パイプラインの実装パターンを自分のプロダクトに流用したい人に向く。逆に、動くコードやライブラリを求めている人には無意味だ。採用前に確認すべきは、分析対象が v2.1.88 という特定バージョンに固定されている点と、本文が Claude による二次的な記述であって一次資料ではない点。原典を読みたいなら README が挙げる instructkr/claw-code や ChinaSiro/claude-code-sourcemap を並行して開き、章の記述とソースを突き合わせる作業を前提にしたほうがいい。
コミュニティノート