---
title: "Claude Code 官方教程中文版"
description: "基於 Anthropic 官方文件重寫的 Claude Code 中文教程入口，覆蓋入門、配置、許可權、MCP、Skills、Subagents、Hooks 和 SDK。"
canonical: "https://xiangyugongzuoliu.com/tag/claude-code"
verifiedAt: "2026-05-05"
---

這組教程不是把英文文件逐段翻譯成中文，而是把 Claude Code 官方事實重新整理成一條中文開發者能直接學習和查用的路徑：先能安裝登入，再能管配置許可權，最後能把 Skills、Subagents、Hooks、Commands 和 Agent SDK 組合起來。

> [!NOTE]
> **適合誰讀**：剛開始用 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。

```mermaid
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. 章節入口

<Cards>
  <Card title="入門與安裝" description="從產品定位、安裝、登入到平臺入口選擇，先讓 Claude Code 正確跑起來。" href="/zh-Hant/docs/claude-code/official/00-getting-started" />
  <Card title="核心配置與能力" description="settings、permissions、memory、MCP：決定 Claude Code 是否能在真實專案裡穩定、安全地用。" href="/zh-Hant/docs/claude-code/official/01-core-capabilities" />
  <Card title="擴充套件與自動化" description="Skills、Subagents、Hooks、Commands、Agent SDK：把重複經驗、隔離任務和產品化能力沉澱下來。" href="/zh-Hant/docs/claude-code/official/02-extensions-automation" />
</Cards>

## 4. 這套教程怎麼寫

這裡遵循三個原則。

第一，事實以 Anthropic 官方文件為準。每篇正文末尾都保留官方來源連結，方便你對照英文原文。

第二，結構按真實使用順序重排。官方文件是 reference，這裡是學習路徑：先解決能不能用，再解決能不能穩定用，最後解決能不能擴充套件和產品化。

第三，邊界講清楚。Claude Code 裡很多概念容易混：`CLAUDE.md` 不是許可權系統，Skill 不是 Hook，MCP prompt 不是 MCP tool，Agent SDK 不是普通 Client SDK。每篇都會先講“它解決什麼，不解決什麼”。

> [!IMPORTANT]
> **不要跳過許可權和記憶**：很多 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. 官方資料入口

- [Claude Code overview](https://code.claude.com/docs/en/overview)
- [Claude Code quickstart](https://code.claude.com/docs/en/quickstart)
- [Claude Code settings](https://code.claude.com/docs/en/settings)
- [Configure permissions](https://code.claude.com/docs/en/permissions)
- [How Claude remembers your project](https://code.claude.com/docs/en/memory)
- [Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp)
- [Extend Claude Code](https://code.claude.com/docs/en/features-overview)
- [Commands](https://code.claude.com/docs/en/commands)
- [Agent SDK overview](https://code.claude.com/docs/en/agent-sdk/overview)
