claude-reviews-claude：一份由 Claude 親自拆解 Claude Code 原始碼的 17 章文件
Claude reads its own source code — 17-chapter architectural deep-dive into Claude Code v2.1.88. EN/ZH bilingual.
秒懂
- 它是什麼？
- 這個倉庫不是工具，而是一份針對 Claude Code v2.1.88 的架構分析文件，由 Claude 在讀完 1,902 個檔案、47.7 萬行 TypeScript 後撰寫，並以 EN/ZH 雙語發佈。判斷重點在於：它作為理解 agent harness 的參考材料是否可靠，而不是它能否被安裝。
- 適合誰用？
- 這份文件適合正在設計 agent harness 的工程師，以及想理解 Claude Code 內部結構但不想自行還原 source map 的人。它不適合想找可安裝套件或可執行工具的人，倉庫裡沒有這種東西。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 167 天前。
- 用什麼語言寫的？
- GitHub 沒有提供這個儲存庫的主要語言。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月15日）與我們的分析，不構成法律意見。
開源專案深度解析
它解決的是「讀不懂」而不是「跑不動」
Claude Code 的原始碼並非以可讀形式公開。README 說明，這份分析基於 v2.1.88 的 TypeScript 原始碼，並在「源碼獲取」一節列出兩個社群還原倉庫：instructkr/claw-code 與 ChinaSiro/claude-code-sourcemap，後者標註為從 Source Map 提取。也就是說，想自己讀的人得先找到還原版本，再面對 1,902 個檔案與 47.7 萬行程式碼。這個專案的價值就在這裡：它把散落的檔案整理成 17 個章節，每章對應一個子系統，並附上規模數字，例如查詢引擎 1,296 行、權限流水線 9.5 千行、橋接系統 1.17 萬行。目標讀者是正在設計或評估 agent harness 的工程師，以及需要理解 Claude Code 行為邊界的人。它不提供函式庫、CLI 或 SDK，沒有可安裝的產物。
核心迴圈：一個「笨迴圈」加上一整套生產級外殼
README 用一張流程圖描述主迴圈：使用者輸入進入 QueryEngine.query()，呼叫 Claude API 進行串流；若 stop_reason 為 end_turn 就輸出結果，若為 tool_use 則經過權限檢查、執行工具、把結果注入後回到迴圈起點。文件把這個設計哲學寫成一句話，大意是智能存在於 LLM 中，腳手架只是一個迴圈，而 42 個以上的工具、7 層縱深防禦、4 層壓縮與多 Agent 協調都是圍繞它搭建的生產級 harness。這個框架解釋了為什麼專案要用 17 章來寫一個迴圈：複雜度不在迴圈本身，而在它外圍的狀態管理、權限、上下文組裝與失敗恢復。章節 1 處理查詢引擎（大腦），章節 2 處理 42 個以上工具如何註冊、驗證與執行，章節 3 處理協調器如何衍生平行工作執行緒、分發訊息並彙總結果。
17 章的劃分方式與各章規模
目錄從章節 0 的架構總綱開始，涵蓋 17 個子系統的全景導覽、工程卓越點與可遷移設計模式，接著是查詢引擎、工具系統、多智能體協調器、插件系統、鉤子系統、Bash 執行引擎、權限流水線、Swarm 智能體、會話持久化、上下文裝配、壓縮系統、啟動與引導、橋接系統、UI 與狀態管理、服務與 API 層、基礎設施與配置，最後是章節 17 的遙測、隱私與營運控制。README 為多數章節標了程式碼規模：插件系統 1.88 萬行、鉤子系統 8 千行、Bash 引擎 1.15 萬行、會話持久化 7.6 千行、上下文裝配 8.3 千行、壓縮系統 3.9 千行、服務與 API 層 1.2 萬行、基礎設施與配置 1.5 萬行。這些數字本身就是一種導讀：它們告訴你哪些子系統值得優先讀。幾個章節的主題值得留意：章節 8 的 Swarm 提到信箱 IPC、後端檢測與權限委託；章節 9 的會話持久化提到僅追加 JSONL 儲存、parent-UUID 鏈與 64KB 輕量恢復；章節 11 的壓縮系統分為微壓縮、會話記憶壓縮與 LLM 摘要壓縮三層。
怎麼讀：GitHub Pages 而非 clone
README 明確建議線上閱讀，理由是 Pages 版本支援全文搜尋、暗色模式與章節導航，閱讀體驗優於 GitHub 原生的 Markdown 渲染。中文版入口是 openedclaude.github.io/claude-reviews-claude/zh-CN/，各章節路徑形如 /zh-CN/chapters/01-query-engine、/zh-CN/chapters/07-permission-pipeline、/zh-CN/chapters/17-telemetry-privacy-operations，總綱在 /zh-CN/overview。英文版為 README_EN.md。這裡沒有安裝步驟、沒有 npm 或 bun 指令、沒有設定檔鍵值可以照抄，因為它是一份文件而不是可執行的專案。如果你的工作流程需要離線閱讀或把內容納入內部知識庫，你得自行處理 Pages 內容的抓取與保存，倉庫本身不提供這種匯出機制。
來源可追溯性：這是二手分析，不是一手驗證
最需要說清楚的限制在這裡。這份分析的對象是 Claude Code v2.1.88，但該版本的原始碼並非由 Anthropic 以可讀形式發佈，而是由社群從 Source Map 還原。分析建立在還原版本之上，因此任何機制描述都經過兩層轉手：先從打包產物還原成 TypeScript，再被閱讀並寫成章節。這不代表內容有誤，但代表你無法只憑這個倉庫驗證任何一句話。若某個機制對你的決策有影響，唯一可靠的作法是回到 README 列出的兩個還原倉庫，找到對應檔案自行確認。另一個限制是版本綁定：v2.1.88 之後的改動不會反映在文件裡，而 Claude Code 的更新節奏並不慢，越晚閱讀，落差越大。
與直接讀還原原始碼的差異
替代方案不是另一個同類專案，而是直接閱讀 instructkr/claw-code 或 ChinaSiro/claude-code-sourcemap 的原始碼。兩者差別在於工作性質。讀原始碼得到的是未經解讀的事實，你能看到實際的函式簽名、錯誤處理分支與型別定義，代價是要自己建立 1,902 個檔案之間的對應關係，並自行判斷哪些是核心路徑、哪些是邊角邏輯。讀這份文件得到的是已經組織過的敘事與規模標註，代價是接受了作者的取捨：哪些子系統被寫成獨立章節、哪些細節被略過、哪些設計被評價為卓越。務實的作法是兩者並用，先用文件建立地圖，再對照原始碼確認你真正關心的那幾條路徑。
授權與維護成本
倉庫採用 MIT 授權，這意味著你可以轉載、改作、納入內部文件，只需保留授權聲明。這對想把內容整理進團隊 wiki 的讀者是有利的。至於維護成本，需要看清楚的幾點：倉庫沒有發佈任何 release，因此沒有版本化的內容快照可供鎖定；README 以「Season 1 完結、全 17 集」的連載語氣描述自身，這暗示內容是以批次方式產出而非持續滾動更新；最後推送時間為 2026-04-01。若你的用途是長期引用，建議在引用時一併記錄你讀的是哪個 commit，因為倉庫沒有 release tag 可以作為錨點。
誰該讀、誰該跳過
如果你正在設計 agent 的執行迴圈、工具註冊機制或權限分層，章節 1、2、7 提供了具體的規模與結構參照，能省下不少摸索時間。如果你關心多智能體協調或長會話的上下文壓縮，章節 3、8、11 是直接相關的。如果你只是想找一個能裝進專案的套件，這個倉庫沒有任何這種東西，請直接跳過。若你的系統與 Claude Code 的架構差異很大，例如你用的是單一工具、無沙箱、無持久化會話的極簡設計，那麼這 17 章的大部分內容與你的問題無關，讀起來會像在讀別人的系統設計史。
編輯結論
這份文件適合正在設計 agent harness 的工程師，以及想理解 Claude Code 內部結構但不想自行還原 source map 的人。它不適合想找可安裝套件或可執行工具的人，倉庫裡沒有這種東西。採用前先確認三件事：你需要的章節是否已涵蓋（例如章節 17 的遙測與營運控制），你的版本是否落在 v2.1.88 附近，以及你是否接受分析內容無法從倉庫本身獨立驗證。若你要引用其中任何機制描述，先去倉庫列出的還原來源（instructkr/claw-code 或 ChinaSiro/claude-code-sourcemap）比對對應檔案。
社群筆記