---
title: "Claude Code 中文教程"
description: "基於 Anthropic 官方文件、原始碼和釋出記錄重寫的 Claude Code 中文教程，連線Aaron工作流的真實專案實踐。"
verifiedAt: "2026-05-08"
---

中文開發者的 Claude Code 官方教程中文版。這裡以 Anthropic 官方文件、原始碼和釋出記錄為事實基準，重新組織成適合中文開發者學習和操作的教程：安裝、登入、CLI、配置、許可權、MCP、Skills、Subagents、Hooks、外掛和 SDK。

> [!NOTE]
> **這一站不是 Anthropic 官方文件的翻譯**：每一篇都按"中文新手 → 第一性原理 → 循序漸進"重寫。理解篇負責心智模型，官方篇負責事實基準；兩條路徑同時跑，不替代彼此。

Aaron工作流主站負責另一件事：記錄真實專案裡怎麼用 Claude Code、怎麼踩坑、怎麼把工具變成長期工作流。教程站不替代主站實踐，只給主站提供穩定的事實基準。

## 兩條互補路徑

<Cards>
  <Card title="📚 官方教程中文版" description="基於 Anthropic 官方資料重寫的中文學習路徑" href="/zh-Hant/docs/claude-code/official" />
  <Card title="從原理到實戰" description="用中文解釋核心概念，幫助讀懂官方能力邊界" href="/zh-Hant/docs/claude-code/understanding" />
</Cards>

## 三層分工

- 教程站：吸收 Claude Code 官方資料，重寫成中文學習路徑，保持事實準確、結構穩定、便於檢索。
- Aaron主站：承接 Claude Code 的個人實踐、專案覆盤、失敗經驗和工作流判斷。
- GitHub：保留公開內容源，方便追蹤變更、提交 Issue 或 PR。

## 推薦學習順序

第一次系統學習 Claude Code，不要直接從高階外掛或自動化開始。更穩的順序是：

1. 先讀官方教程中文版，確認安裝、登入、CLI、專案上下文、許可權和基本命令。
2. 再讀“從原理到實戰”，理解它為什麼能讀程式碼、改檔案、呼叫工具和執行命令。
3. 然後回到真實專案，用一個小改動練習 plan、edit、test、review 的閉環。
4. 最後再進入 MCP、Skills、Subagents、Hooks、外掛和 SDK，把重複流程沉澱成可複用能力。

這個站點的定位不是“把 Anthropic 文件翻譯一遍”。每篇文章都會盡量回答三個問題：官方能力是什麼、中文開發者容易誤解在哪裡、放到真實專案時應該如何驗收。

## 適合誰讀

- 剛開始使用 Claude Code，需要一套中文路徑避免在官方文件裡來回跳轉。
- 已經會用 CLI，但想系統理解許可權、上下文、MCP 和 agentic workflow。
- 正在把個人 prompt 升級為團隊規則、Skills 或自動化流程。
- 需要給學員或團隊成員一個穩定入口，而不是把零散連結發給他們。

如果你只想看最新產品細節，應該回官方文件核驗；如果你想看Aaron工作流怎麼在真實專案裡使用 Claude Code，再回主站實踐文章。

## 商業專案裡的學習目標

學完這套 Claude Code 教程後，最低標準不是“知道有哪些功能”，而是能在一個真實 repo 裡完成可審查任務：

- 讓 Claude Code 先讀專案規則和相關檔案，再開始修改。
- 能控制許可權、命令執行和外部工具訪問。
- 能把大任務拆成可驗證的小任務。
- 能要求它跑測試、解釋失敗、修根因，而不是跳過錯誤。
- 能把高頻經驗寫成專案規則、Skill 或團隊 SOP。

這些能力決定它能不能進入長期工作流。只會讓模型“幫我寫程式碼”還不夠，商業專案需要的是範圍控制、事實核驗、可回復 diff 和穩定交付。

## 入口選擇

站內兩條路徑可以交替讀：

- 想查功能和配置：進官方教程中文版，從目錄頁按模組找答案。
- 想理解使用邏輯：進從原理到實戰，按“為什麼這樣用”建立判斷。

真實專案裡通常先查官方教程確認事實，再回原理頁判斷任務邊界。比如遇到 MCP 問題，先確認 Claude Code 支援什麼配置和命令，再判斷這個 MCP 是否應該進入專案、是否需要憑據隔離、是否會擴大許可權面。這樣讀，教程站就不是資料堆疊，而是一個能指導工作流決策的索引。

## 更新原則

Claude Code 變化很快，教程站只保留穩定能力和可複用操作。涉及模型、套餐、平臺限制、釋出節奏或實驗功能時，以官方文件和釋出記錄為準；涉及Aaron工作流的真實用法時，以主站實踐文章為準。兩者分開，能避免教程頁寫成臨時新聞，也避免實踐頁承擔事實手冊的職責。

後續更新時，優先補會影響真實操作的內容：安裝認證、許可權邊界、MCP 配置、專案規則、工具呼叫、測試驗證和團隊複用。隻影響營銷文案或臨時 UI 位置的變化，不進入核心教程。

因此，這個入口頁只負責幫你選路；具體步驟進入官方教程，具體判斷進入原理實戰，具體案例回主站。

閱讀時建議從一個真實儲存庫帶著問題進入，而不是隻順序瀏覽目錄。帶著失敗命令、許可權疑問或遷移目標閱讀，吸收效率更高，也更容易形成可複用的工作流方法。

## 官方資料

- 官方文件索引：[https://code.claude.com/docs/llms.txt](https://code.claude.com/docs/llms.txt)
- Claude Code overview：[https://code.claude.com/docs/en/overview](https://code.claude.com/docs/en/overview)
- 上游原始碼：[https://github.com/anthropics/claude-code](https://github.com/anthropics/claude-code)

## 延伸閱讀

- Claude Code 實踐：[xiangyugongzuoliu.com/tag/claude-code](https://xiangyugongzuoliu.com/tag/claude-code)
- AI 程式設計實操課：[FlowUS 課程頁](https://flowus.cn/xiangyugongzuoliu/share/d392dcad-b537-44ee-a3e2-56ff5af02bce)
- 公開儲存庫：[github.com/xiangyugongzuoliu/claude-code-tutorial](https://github.com/xiangyugongzuoliu/claude-code-tutorial)
