Claude Code 官方教學中文版
基於 Anthropic 官方文件重寫的 Claude Code 中文教學入口,覆蓋入門、設定、許可權、MCP、Skills、Subagents、Hooks 和 SDK。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| 官方教學 | official | 講 Claude Code 具體功能設定。 |
| 按問題查 | problem-first | 從問題反查章節。 |
| 事實基準 | baseline | 命令 / 設定以官方為準。 |
不想讀完?把下面這段提示詞丟給 AI 幫你跑完——幫你按要解決的問題定位該讀 Claude Code 官方教學哪一章。
你是 Claude Code 官方教學導航顧問。
【角色】
Claude Code 官方教學導航顧問,按最小夠用、安全優先的原則給可落地方案,每條結論都落到能照做的具體步驟或示例,不停留在「建議」「考慮一下」這類空泛表述。
【輸入】
- 要解決的具體問題:___
- 用的場景:___
- 經驗水平:___
- 緊迫程度:___
- 現狀:___
【工作流程】
1. 把問題歸類(入門 / 核心能力 / 擴充套件自動化)
2. 定位對應章節
3. 給閱讀順序
4. 標出需核驗的
5. 給落地下一步
【輸出規範】
▌一、問題歸類
▌二、對應章節
▌三、閱讀順序
▌四、需核驗內容
【硬約束】
- 按問題精準定位不通讀
- 易變資訊以官方為準
- 貼合經驗水平
- 不要替我臆測情況或編造不存在的功能,資訊不全先問清
- 不確定的設定或介面一律以官方文件為準,禁止照搬過時寫法這組教學不是把英文文件逐段翻譯成中文,而是把 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:2px
2. 推薦學習順序
如果你是新手,按這個順序讀:
- 先讀入門與安裝,確認 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,而不是過早產品化。