在 2026 年 3 月 31 日，一份意外的洩漏事件，讓 Claude Code v2.1.88 版本中多達 51.2 萬行的 TypeScript 原始碼公諸於世，在開源社群中引起廣泛討論。這起事件促成了一項名為「Claude Code 完全指南 V2」的開源專案，旨在將這些程式碼與社群的深度解析整合，提供一套從零開始也能理解的學習資源。這份指南不僅是一本技術手冊，更像是一個互動式的學習平台，透過多種格式與輔助工具，幫助開發者深入理解 Claude Code 這個以大型語言模型（LLM）為核心的作業系統。
指南特色與 V1 版本的演進
「Claude Code 完全指南 V2」的規模與內容深度，使其在眾多技術文件中脫穎而出。它總共包含了 20 篇文章、187 個章節，輔以超過 100 張精美的架構圖和逾 60 個資料表格。為了提供更全面的學習體驗，該指南還設計了 8 個實戰實驗室（Lab）與 50 題的自我測驗，讓學習者能夠在實作與評估中鞏固知識。
相較於其前身 V1 版本，V2 版本在多個面向進行了大幅度的革新與擴展。首先在內容篇幅上，V1 僅有 12 篇文章、114 個章節，而 V2 則增加到 20 篇文章、187 個章節，幾乎翻倍。在文件框架上，V1 使用 Docsify，而 V2 則選用了 VitePress，並加入了暗色模式、全文搜索以及行動裝置適配等現代化功能，大幅提升了閱讀體驗。
V2 版本也引入了許多 V1 所沒有的全新內容。其中包括了提示詞工程（Prompt Engineering）、記憶系統（Memory System）、多項隱藏功能（Hidden Features），以及針對 Hooks 生態系統與 Token 經濟學的深度剖析。此外，實戰 Lab 的導入，也讓學習者有機會親手操作，將理論知識轉化為實際技能。圖表方面，V2 版本從 V1 的大約 30 個圖表躍升至超過 100 個 Mermaid 流程圖與逾 60 個資料表格，強化了視覺輔助學習的豐富度。輸出格式也從 V1 的單一網頁模式，擴展為網頁、PDF 及 HTML 離線包等多種選擇，方便不同情境下的閱讀需求。最後，V2 版本還引入了 50 題的三級自測系統，為學習者提供了方便的自我評估工具。
內容架構：系統性地剖析 Claude Code
這份指南的內容架構設計得相當縝密，從入門到深入，循序漸進地引導讀者理解 Claude Code 的內部運作。
指南的開頭設定了「前言」，提供了導讀、學習路線圖、術語表以及環境搭建的指引，為新手鋪平了道路。接著，在「第 1 篇」中，詳細闡述了洩漏事件的始末、原始碼的規模以及社群如何重建的背景故事，讓讀者了解專案的緣起。
「第 2 篇」是專為初學者設計的快速上手指南，內容涵蓋了安裝流程、首次對話、常用命令速查以及節省使用成本的技巧，旨在幫助新用戶快速入門。「第 3 篇」則進入了核心架構的全景概覽，探討了這個 LLM 核心作業系統的設計理念，包括其四個主要入口與目錄結構。
「第 4 篇」被視為全書最重要的部分，詳細拆解了 QueryEngine 的八個步驟核心循環，深入解釋了 Claude Code 如何處理查詢與生成回應。「第 5 篇」聚焦於提示詞工程，分析了動態拼裝、快取經濟學以及嚴格約束的機制。
「第 6 篇」深入討論了工具系統，描述了 42 個工具及其 14 個步驟的治理流水線。「第 7 篇」則關注於權限與安全議題，介紹了六種模式、七個步驟的評估管道以及沙箱機制。
在記憶管理方面，「第 8 篇」探索了上下文管理的三層壓縮技術，確保上下文永不超限。「第 9 篇」則進一步揭示了記憶系統的內部運作，特別是 CLAUDE.md 文件和 KAIROS 的「做夢機制」。
「第 10 篇」拓展到多 Agent 系統，解析了「蜂群」概念與驗證 Agent（Verification Agent）的角色。而「第 11 篇」則介紹了 Claude Code 終端使用者介面（UI）的實現，採用了自行開發的 React/Ink 渲染器。
「第 12 篇」闡述了 Bridge 橋接機制，實現了命令列界面（CLI）與整合開發環境（IDE）的雙向通訊。「第 13 篇」則探討了狀態管理，包括 createStore 的使用與資料持久化。
在服務與整合方面，「第 14 篇」涵蓋了 MCP、LSP 和 OAuth 等核心技術。有趣的是，「第 15 篇」披露了一些隱藏功能，例如「臥底模式」（Undercover Mode）以及「夥伴寵物」（Buddy Pet）。
「第 16 篇」詳細介紹了 Hooks、Skills 和 Plugins 等生態系統的設計與運作。「第 17 篇」則從效能與成本的角度，深入分析了 Token 經濟學。
最後幾篇則側重於維運管理，「第 18 篇」討論了遙測與生命週期管理。而「第 19 篇」是實戰 Lab 的集大成，引導讀者從零開始建構一個簡化版的 Agent。指南的結尾是「第 20 篇」，對其內容進行了總結，並對 AI Agent 的壁壘提出了看法。最後，「附錄」包含了原始碼索引、速查表、50 題自測題庫以及推薦閱讀列表。
學習路徑建議
為了滿足不同背景學習者的需求，指南提供了三條建議的學習路徑：
- 小白入門路徑：適合編程初學者，建議閱讀「前言」以及「第 1 至 5 篇」，預計學習時長為 8 至 12 小時。這條路徑旨在幫助新手快速掌握基礎知識。
- 開發者進階路徑：適用於有程式設計經驗的開發者，建議閱讀「第 3 至 10 篇」並完成 Lab 實作，預計學習時長為 15 至 20 小時。此路徑著重於深入理解核心模組與系統設計。
- 架構師深入路徑：專為資深工程師設計，建議完整閱讀全部 20 篇文章，預計學習時長為 30 至 40 小時。此路徑將提供最全面的技術洞察與系統理解。
本地運行與相關專案
該專案也提供了簡單的本地運行方法，只需幾個命令即可在本地環境中瀏覽文件：
bash
git clone https://github.com/bcefghj/claude-code-complete-guide_v2.git
cd claude-code-complete-guide_v2
npm install
npm run docs:dev
<h1>之後可以透過瀏覽器訪問 http://localhost:5173</h1>
若要建構靜態網站或本地預覽建構結果，則可使用：
bash
<h1>建構靜態站點</h1>
npm run docs:build
<h1>本地預覽建構結果</h1>
npm run docs:preview
此外，該專案也列出了一些相關的參考專案，以便讀者進一步探索。其中包括了被洩漏的 v2.1.88 完整 TypeScript 原始碼（Claude-Code-Source），專門收集全網原始碼解讀資料的（Claude-Code-Source-Analysis），以及 V1 版本的「claude-code-complete-guide」。
在參考資源方面，除了 Anthropic Claude Code 官方文件外，還提及了幾個 GitHub 上備受關注的社群專案，例如擁有 10.9K 星標的深度分析專案（sanbuphy/claude-code-source-code）、2.6K 星標的全面指南（claude-code-ultimate-guide）以及 16K 星標、旨在協助讀者快速掌握相關知識的（claude-howto）。
聲明與授權
該專案明確聲明其僅用於教育學習目的。Claude Code 原始碼的版權仍屬於 Anthropic, PBC 所有。本專案以 MIT 授權條款發布，鼓勵開放協作與知識共享。
「Claude Code 完全指南 V2」於 2026 年 4 月 2 日正式發布，其豐富的內容、多樣的格式以及詳細的解釋，無疑為廣大的開發者與學習者提供了一個深入理解 Claude Code 這個複雜體系的寶貴機會。透過其結構化的內容編排與多重學習路徑，無論是初學者還是資深架構師，都能從中獲得對 LLM 核心作業系統的全面洞察。