2026 年 3 月 31 日，一場意外讓科技界得以一窺 Anthropic Claude Code CLI 的奧秘。由於 npm 套件中未經清理的 .map 檔案遭到洩漏，這份工具的完整 TypeScript 原始碼因此曝光於世，而這項發現最早是由 @Fried_rice 公開。Source Map 檔案的特性在於，它能夠將編譯後的程式碼完整映射回原始的 TypeScript 原始碼，使得開發者社群得以完整還原這份關鍵代碼。
在這樣的背景下，由 Wang Yanshu 所主導的開源專案 catyans/claude-code-source-analysis 應運而生，旨在針對這份還原後的原始碼進行一次全面的深度分析。這項專案聚焦於逐模組的架構解讀，試圖描繪出 Claude Code CLI 錯綜複雜卻又精妙的內部運作機制。從 GitHub 上的數據來看，該專案已獲得 194 個星號與 104 個分叉，顯示其在開發者社群中的高度關注與價值。
專案規模與核心技術棧
這份洩漏的原始碼，在規模上令人印象深刻。根據分析，整個專案涵蓋了將近 1,884 個 .ts/.tsx 檔案，總計超過 512,664 行程式碼。這龐大的程式碼量，為這款 CLI 工具的複雜性提供了直接佐證。
在技術棧方面，Claude Code CLI 採用了現代開發中廣泛使用的技術：
- 運行時環境：選用了 Bun，這是一種以速度著稱的 JavaScript 運行時，顯示出對性能的追求。
- 主要開發語言：項目完全以 TypeScript 編寫，並啟用了嚴格模式（strict），這有助於提升程式碼的健壯性與可維護性。
- 使用者介面框架：雖然是 CLI 工具，但它結合了 React 框架與自訂的 Ink 渲染器，這在傳統 CLI 應用中較為少見，暗示著一個高度互動且視覺化的終端介面。
- 命令列解析：藉助 Commander.js 處理命令列參數，確保了靈活且易用的命令接收能力。
- 資料結構驗證：Zod v4 被用於進行 Schema 驗證，保障了資料的正確性和一致性。
模組化架構的深度剖析
catyans/claude-code-source-analysis 專案的價值，在於它將龐大的原始碼分解為 18 個核心章節，每個章節都針對一個獨立子系統進行詳盡的解讀。這套分析框架為理解 Claude Code CLI 提供了清晰的路徑。
00 總覽
這部分對專案的基本概況、所採用的技術棧、其檔案目錄結構以及各章節的索引指引做了全面的介紹，為後續的深度分析奠定了基礎。
01 啟動流程
Claude Code CLI 的啟動流程被描述為一個多階段的流水線。專案分析揭示，它支援高達 91 個不同的命令列選項，並提供了 6 種不同的執行模式，這顯示了其高度的可配置性與彈性。
02 查詢引擎
作為核心功能之一，查詢引擎由一個高度複雜的 Generator 狀態機驅動。這套引擎具備 7 級錯誤恢復機制，支援流式處理，並能有效管理 Token 預算，確保在處理大量資料時的穩定性與效率。
03 工具系統
工具系統是 Claude Code CLI 的一大亮點，提供了超過 30 個方法供外部呼叫。透過 buildTool 工廠模式進行工具建立，並採用並發分區策略來優化工具的執行效率。
04 BashTool 詳解
專案詳細分析了 BashTool 的內部結構，揭示了其三層安全防護機制以及高達 23 項安全檢查。此外，工具還能根據權限規則進行匹配，有效控制外部命令的執行，降低潛在風險。
05 AgentTool 與多 Agent
在人工智慧領域，多代理系統是複雜任務處理的關鍵。分析顯示，Claude Code CLI 支援 Agent 的生成與管理，並透過 Coordinator 進行編排。這種機制還包括團隊管理和訊息路由功能，使得多個 Agent 能夠協同工作，完成複雜任務。
06 檔案與搜索工具
這部分涵蓋了多種與檔案操作及內容搜索相關的工具，例如檔案讀寫（FileRead/Write/Edit）、全域搜尋（Glob）、正則表達式搜尋（Grep）以及網路資料抓取（WebFetch）等，總計 9 個工具，提供了強大的檔案系統互動能力。
07 權限系統
權限系統是確保 CLI 工具安全運行的核心環節。它採用了 ResolveOnce 機制來防止競態條件，同時處理 6 路並發競爭，並提供了 7 種不同的權限模式，從而精確控制各項操作的許可權限。
08 狀態管理
專案使用一個包含超過 150 個欄位的 AppState 來管理應用程式的整體狀態。透過一個僅有 35 行程式碼的純函數 Store，並在 6 個同步點進行狀態更新，實現了高效且可預測的狀態管理。
09 服務層
服務層設計彈性，支援多種 Provider API，並採用 MCP 協議進行通訊。特別的是，它包含了 5 種上下文壓縮策略，旨在優化網路傳輸效率，尤其對於大型模型的互動至關重要。
10 IDE 整合 (Bridge)
為了與整合開發環境（IDE）無縫結合，Claude Code CLI 內建了 Bridge 功能。它採用 V1/V2 兩種傳輸路徑，支援 JWT 令牌的刷新調度，並能處理多會話工作竊取，確保在複雜開發環境中的穩定連接與效能。
11 記憶系統
記憶系統是 Agent 智慧行為的基礎，它支援檔案記憶以持久化資訊。系統內建 4 種不同類型的記憶，並利用 Sonnet 語義召回功能來檢索相關資訊。此外，還設有團隊記憶機制，促進多個 Agent 間的知識共享。
12 Skill 與插件系統
為了擴展功能，Claude Code CLI 提供了 Skill 與插件系統。該系統支援懶惰提取（lazy extraction）和 O_EXCL 安全寫入，確保插件安裝的可靠性與安全性，並支援插件的熱載入，無需重啟即可應用新增功能。
13 UI 渲染層
儘管是終端工具，Claude Code CLI 的 UI 渲染層卻設計得十分精巧。它並非直接使用 Ink 函式庫，而是實現了完整的 React reconciler，結合 Yoga 佈局引擎，並額外支援雙緩衝、硬體滾動和虛擬滾動等特性，旨在提供流暢且高效的終端互動體驗。
14 命令系統
命令系統涵蓋了多達 103 個不同的命令，這些命令被分為 3 種主要類型。系統支援命令的並行載入，並能根據當前上下文過濾可用命令，提高使用者操作效率。
15 Feature Flags 與編譯優化
為了實現靈活的功能開關和性能優化，專案採用了 Feature Flags。這包括編譯時的死程式碼消除，以減少最終發布的程式碼體積。運行時則藉助 GrowthBook 進行功能管理，在產品生命週期中進行了 12 次配置遷移，確保系統的持續演進。
16 資料流與架構模式
這一章節深入探討了 Claude Code CLI 內部 12 個跨切面、具高度通用性的設計模式，揭示了其資料在不同模組間流動的機制與遵循的架構原則。
17 其他子系統
除了上述核心功能外，專案還包含了其他有趣的子系統，例如模擬 Vim 操作的狀態機、隱藏的 Buddy 彩蛋、語音功能、支援遠端會話，以及能以 Server 模式運行的能力，這些都豐富了工具的功能性與使用者體驗。
18 架構設計總結
最後一個章節對整個專案的架構設計進行了總結。它提煉出了 7 大設計原則，並回顧了為提升性能所做的各項優化，以及如何構建一個分層的安全架構，確保系統的穩定性與安全性。
核心架構一覽
透過視覺化的架構圖，可以更直觀地理解 Claude Code CLI 各主要組成部分之間的關係：
整個系統的執行始於 main.tsx，這是 CLI 的入口點。根據使用模式，程式碼流將分流至三個主要通道：REPL（基於 React 的互動式終端）、Bridge（用於 IDE 整合）或 SDK/Print（執行非互動式任務）。
無論哪個入口，最終都會匯聚到核心的 QueryEngine。這是一個基於 AsyncGenerator 的狀態機，負責處理複雜的查詢邏輯。
QueryEngine 再進一步與數個關鍵的支撐模組互動：
- 工具系統：一個包含 39 個獨立工具的模組，執行各種功能。
- 權限系統：負責分層的權限管理，確保操作的合法性。
- 服務層：處理 API 介面與 MCP 協議，實現外部通訊。
- 狀態管理：透過 AppState 統一管理應用程式的各種數據。
亮點發現
在眾多技術細節中，catyans/claude-code-source-analysis 專案特別強調了一個顯著的亮點，那就是其「自訂 React 終端渲染器」。這不同於直接使用現成的 Ink 函式庫，而是專案團隊自行實現了一套完整的 React reconciler，並整合了 Yoga 佈局引擎。這項工作不僅展現了深厚的技術實力，更說明了開發團隊對於終端使用者體驗的極致追求，即便在文字介面下，也要提供接近圖形界面的流暢與精準顯示，這也為終端應用開發樹立了一個高標準。
總體而言，這份意外洩漏的 Claude Code CLI 原始碼，透過 Wang Yanshu 的細緻分析，為我們揭開了 Anthropic 在構建複雜 AI 輔助開發工具方面的深層技術藍圖。無論是其龐大的程式碼規模、先進的技術棧選用，或是精心設計的模組化架構與創新性的終端渲染方案，都為理解當前及未來 AI 輔助開發工具的發展方向提供了寶貴的參考。