AI 程式設計教學中文版
官方教學中文版

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. 推薦學習順序

如果你是新手,按這個順序讀:

  1. 先讀入門與安裝,確認 Claude Code 是什麼、在哪些入口使用、怎麼安裝、怎麼登入。
  2. 再讀 settings,先把設定 scope 分清楚。
  3. 再讀 permissions,避免還沒理解許可權就放開工具。
  4. 再讀 memory,整理 CLAUDE.md、rules 和 auto memory。
  5. 再讀 MCP,只連線真正能減少複製貼上的外部系統。
  6. 最後讀擴充套件與自動化: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. 章節入口

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,而不是過早產品化。

6. 官方資料入口

本頁目錄