Claude Code 官方教程中文版
基於 Anthropic 官方文件重寫的 Claude Code 中文教程入口，覆蓋入門、配置、許可權、MCP、Skills、Subagents、Hooks 和 SDK。
這組教程不是把英文文件逐段翻譯成中文，而是把 Claude Code 官方事實重新整理成一條中文開發者能直接學習和查用的路徑：先能安裝登入，再能管配置許可權，最後能把 Skills、Subagents、Hooks、Commands 和 Agent SDK 組合起來。
適合誰讀：剛開始用 Claude Code 的開發者、正在給團隊配置 Claude Code 的技術負責人、需要把 Claude Code 能力產品化的工程師。你可以從頭學，也可以按當前問題直接跳到對應章節。
1. 這套教程覆蓋什麼
目前官方教程中文版覆蓋 3 組、14 章正文。
第一組：入門與安裝。
- Claude Code 是什麼。
- 怎麼安裝和更新。
- 怎麼登入與選擇認證方式。
- CLI、Desktop、IDE、Web、Mobile 和外部整合怎麼選。
第二組：核心配置與能力。
- settings 的 user、project、local、managed scope。
- permissions 的 allow、ask、deny、permission modes、sandbox 邊界。
- memory 的
CLAUDE.md、rules、auto memory、/memory排障。 - MCP 的 HTTP、stdio、scope、OAuth、Tool Search、許可權和輸出限制。
第三組：擴充套件與自動化。
- 擴充套件能力地圖。
- Skills。
- Subagents。
- Hooks。
- Commands。
- Agent SDK。
flowchart TD
Start["能安裝和登入"]
Config["能穩定配置"]
Boundary["能收緊許可權和記憶"]
Connect["能連線外部工具"]
Extend["能沉澱擴充套件能力"]
Automate["能做自動化和產品化"]
Start --> Config
Config --> Boundary
Boundary --> Connect
Connect --> Extend
Extend --> Automate
style Start fill:#e0f2fe,stroke:#0284c7,stroke-width:2px
style Boundary fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
style Automate fill:#dcfce7,stroke:#22c55e,stroke-width:2px2. 推薦學習順序
如果你是新手，按這個順序讀：
- 先讀入門與安裝，確認 Claude Code 是什麼、在哪些入口使用、怎麼安裝、怎麼登入。
- 再讀 settings，先把配置 scope 分清楚。
- 再讀 permissions，避免還沒理解許可權就放開工具。
- 再讀 memory，整理
CLAUDE.md、rules 和 auto memory。 - 再讀 MCP，只連線真正能減少複製貼上的外部系統。
- 最後讀擴充套件與自動化：Skills、Subagents、Hooks、Commands、Agent SDK。
如果你已經在使用 Claude Code，可以按問題跳轉：
- 安裝失敗、命令找不到：看“安裝與更新”。
- 登入、Console、Bedrock、Vertex、Foundry：看“登入與認證”。
- 配置不知道放哪一層：看“配置 Claude Code”。
- 許可權提示太多或太少：看“管理許可權”。
- Claude 老忘專案規則：看“使用記憶機制”。
- 想接 GitHub、Sentry、資料庫、Figma：看“連線 MCP”。
- 重複流程想沉澱：看“使用 Skills”。
- 想隔離探索或審查任務：看“配置 Subagents”。
- 想每次自動格式化、阻斷、通知：看“使用 Hooks”。
- 想理解
/命令：看“使用 Commands”。 - 想把 Claude Code 做進產品：看“使用 Agent SDK”。
3. 章節入口
入門與安裝
從產品定位、安裝、登入到平臺入口選擇，先讓 Claude Code 正確跑起來。
核心配置與能力
settings、permissions、memory、MCP：決定 Claude Code 是否能在真實專案裡穩定、安全地用。
擴充套件與自動化
Skills、Subagents、Hooks、Commands、Agent SDK：把重複經驗、隔離任務和產品化能力沉澱下來。
4. 這套教程怎麼寫
這裡遵循三個原則。
第一，事實以 Anthropic 官方文件為準。每篇正文末尾都保留官方來源連結，方便你對照英文原文。
第二，結構按真實使用順序重排。官方文件是 reference，這裡是學習路徑：先解決能不能用，再解決能不能穩定用，最後解決能不能擴充套件和產品化。
第三，邊界講清楚。Claude Code 裡很多概念容易混：CLAUDE.md 不是許可權系統，Skill 不是 Hook，MCP prompt 不是 MCP tool，Agent SDK 不是普通 Client SDK。每篇都會先講“它解決什麼，不解決什麼”。
不要跳過許可權和記憶：很多 Claude Code 使用問題表面是“模型不聽話”，實際是配置 scope、permissions、CLAUDE.md、auto memory、MCP 輸出和 Hooks 邊界沒有整理好。
5. 學完應該達到什麼狀態
讀完這 14 章，你應該能做到：
- 能按官方推薦方式安裝、更新和驗證 Claude Code。
- 能區分 Claude.ai 登入、Console API key、Bedrock、Vertex、Foundry。
- 能判斷配置該放 user、project、local 還是 managed。
- 能寫出可維護的 permissions allow、ask、deny。
- 能把長期規則放進
CLAUDE.md，把路徑規則拆進.claude/rules/。 - 能判斷什麼時候接 MCP，什麼時候只複製一段上下文。
- 能把重複流程做成 Skill。
- 能用 Subagent 隔離大量探索和審查。
- 能用 Hook 做確定性自動化。
- 能理解
/命令背後的 built-in、bundled skill、MCP prompt。 - 能判斷什麼時候進入 Agent SDK，而不是過早產品化。