---
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="/docs/claude-code/official/00-getting-started" />
  <Card title="核心配置与能力" description="settings、permissions、memory、MCP：决定 Claude Code 是否能在真实项目里稳定、安全地用。" href="/docs/claude-code/official/01-core-capabilities" />
  <Card title="扩展与自动化" description="Skills、Subagents、Hooks、Commands、Agent SDK：把重复经验、隔离任务和产品化能力沉淀下来。" href="/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)
