Claude Code 中文教程
基於 Anthropic 官方文件、原始碼和釋出記錄重寫的 Claude Code 中文教程，連線翔宇工作流的真實專案實踐。
中文開發者的 Claude Code 官方教程中文版。這裡以 Anthropic 官方文件、原始碼和釋出記錄為事實基準，重新組織成適合中文開發者學習和操作的教程：安裝、登入、CLI、配置、許可權、MCP、Skills、Subagents、Hooks、外掛和 SDK。
這一站不是 Anthropic 官方文件的翻譯：每一篇都按"中文新手 → 第一性原理 → 循序漸進"重寫。理解篇負責心智模型，官方篇負責事實基準；兩條路徑同時跑，不替代彼此。
翔宇工作流主站負責另一件事：記錄真實專案裡怎麼用 Claude Code、怎麼踩坑、怎麼把工具變成長期工作流。教程站不替代主站實踐，只給主站提供穩定的事實基準。
兩條互補路徑
三層分工
- 教程站：吸收 Claude Code 官方資料，重寫成中文學習路徑，保持事實準確、結構穩定、便於檢索。
- 翔宇主站：承接 Claude Code 的個人實踐、專案覆盤、失敗經驗和工作流判斷。
- GitHub：保留公開內容源，方便追蹤變更、提交 Issue 或 PR。
推薦學習順序
第一次系統學習 Claude Code，不要直接從高階外掛或自動化開始。更穩的順序是：
- 先讀官方教程中文版，確認安裝、登入、CLI、專案上下文、許可權和基本命令。
- 再讀“從原理到實戰”，理解它為什麼能讀程式碼、改檔案、呼叫工具和執行命令。
- 然後回到真實專案，用一個小改動練習 plan、edit、test、review 的閉環。
- 最後再進入 MCP、Skills、Subagents、Hooks、外掛和 SDK，把重複流程沉澱成可複用能力。
這個站點的定位不是“把 Anthropic 文件翻譯一遍”。每篇文章都會盡量回答三個問題：官方能力是什麼、中文開發者容易誤解在哪裡、放到真實專案時應該如何驗收。
適合誰讀
- 剛開始使用 Claude Code，需要一套中文路徑避免在官方文件裡來回跳轉。
- 已經會用 CLI，但想系統理解許可權、上下文、MCP 和 agentic workflow。
- 正在把個人 prompt 升級為團隊規則、Skills 或自動化流程。
- 需要給學員或團隊成員一個穩定入口，而不是把零散連結發給他們。
如果你只想看最新產品細節，應該回官方文件核驗；如果你想看翔宇工作流怎麼在真實專案裡使用 Claude Code，再回主站實踐文章。
商業專案裡的學習目標
學完這套 Claude Code 教程後，最低標準不是“知道有哪些功能”，而是能在一個真實 repo 裡完成可審查任務：
- 讓 Claude Code 先讀專案規則和相關檔案，再開始修改。
- 能控制許可權、命令執行和外部工具訪問。
- 能把大任務拆成可驗證的小任務。
- 能要求它跑測試、解釋失敗、修根因，而不是跳過錯誤。
- 能把高頻經驗寫成專案規則、Skill 或團隊 SOP。
這些能力決定它能不能進入長期工作流。只會讓模型“幫我寫程式碼”還不夠，商業專案需要的是範圍控制、事實核驗、可回復 diff 和穩定交付。
入口選擇
站內兩條路徑可以交替讀：
- 想查功能和配置：進官方教程中文版，從目錄頁按模組找答案。
- 想理解使用邏輯：進從原理到實戰，按“為什麼這樣用”建立判斷。
真實專案裡通常先查官方教程確認事實，再回原理頁判斷任務邊界。比如遇到 MCP 問題，先確認 Claude Code 支援什麼配置和命令，再判斷這個 MCP 是否應該進入專案、是否需要憑據隔離、是否會擴大許可權面。這樣讀，教程站就不是資料堆疊，而是一個能指導工作流決策的索引。
更新原則
Claude Code 變化很快，教程站只保留穩定能力和可複用操作。涉及模型、套餐、平臺限制、釋出節奏或實驗功能時，以官方文件和釋出記錄為準；涉及翔宇工作流的真實用法時，以主站實踐文章為準。兩者分開，能避免教程頁寫成臨時新聞，也避免實踐頁承擔事實手冊的職責。
後續更新時，優先補會影響真實操作的內容：安裝認證、許可權邊界、MCP 配置、專案規則、工具呼叫、測試驗證和團隊複用。隻影響營銷文案或臨時 UI 位置的變化，不進入核心教程。
因此，這個入口頁只負責幫你選路；具體步驟進入官方教程，具體判斷進入原理實戰，具體案例回主站。
閱讀時建議從一個真實儲存庫帶著問題進入，而不是隻順序瀏覽目錄。帶著失敗命令、許可權疑問或遷移目標閱讀，吸收效率更高，也更容易形成可複用的工作流方法。
官方資料
- 官方文件索引：https://code.claude.com/docs/llms.txt
- Claude Code overview：https://code.claude.com/docs/en/overview
- 上游原始碼：https://github.com/anthropics/claude-code
延伸學習
- Claude Code 實戰文章：xiangyugongzuoliu.com/tag/claude-code
- 翔宇 AI 程式設計實操課：檢視課程介紹與學習路徑
- Claude Code 教程公開儲存庫：github.com/xiangyugongzuoliu/claude-code-tutorial