---
title: "Claude Code 中文教程"
description: "基于 Anthropic 官方文档、源码和发布记录重写的 Claude Code 中文教程，连接Aaron工作流的真实项目实践。"
verifiedAt: "2026-05-08"
---

中文开发者的 Claude Code 官方教程中文版。这里以 Anthropic 官方文档、源码和发布记录为事实基准，重新组织成适合中文开发者学习和操作的教程：安装、登录、CLI、配置、权限、MCP、Skills、Subagents、Hooks、插件和 SDK。

> [!NOTE]
> **这一站不是 Anthropic 官方文档的翻译**：每一篇都按"中文新手 → 第一性原理 → 循序渐进"重写。理解篇负责心智模型，官方篇负责事实基准；两条路径同时跑，不替代彼此。

Aaron工作流主站负责另一件事：记录真实项目里怎么用 Claude Code、怎么踩坑、怎么把工具变成长期工作流。教程站不替代主站实践，只给主站提供稳定的事实基准。

## 两条互补路径

<Cards>
  <Card title="📚 官方教程中文版" description="基于 Anthropic 官方资料重写的中文学习路径" href="/docs/claude-code/official" />
  <Card title="从原理到实战" description="用中文解释核心概念，帮助读懂官方能力边界" href="/docs/claude-code/understanding" />
</Cards>

## 三层分工

- 教程站：吸收 Claude Code 官方资料，重写成中文学习路径，保持事实准确、结构稳定、便于检索。
- Aaron主站：承接 Claude Code 的个人实践、项目复盘、失败经验和工作流判断。
- GitHub：保留公开内容源，方便追踪变更、提交 Issue 或 PR。

## 推荐学习顺序

第一次系统学习 Claude Code，不要直接从高级插件或自动化开始。更稳的顺序是：

1. 先读官方教程中文版，确认安装、登录、CLI、项目上下文、权限和基本命令。
2. 再读“从原理到实战”，理解它为什么能读代码、改文件、调用工具和运行命令。
3. 然后回到真实项目，用一个小改动练习 plan、edit、test、review 的闭环。
4. 最后再进入 MCP、Skills、Subagents、Hooks、插件和 SDK，把重复流程沉淀成可复用能力。

这个站点的定位不是“把 Anthropic 文档翻译一遍”。每篇文章都会尽量回答三个问题：官方能力是什么、中文开发者容易误解在哪里、放到真实项目时应该如何验收。

## 适合谁读

- 刚开始使用 Claude Code，需要一套中文路径避免在官方文档里来回跳转。
- 已经会用 CLI，但想系统理解权限、上下文、MCP 和 agentic workflow。
- 正在把个人 prompt 升级为团队规则、Skills 或自动化流程。
- 需要给学员或团队成员一个稳定入口，而不是把零散链接发给他们。

如果你只想看最新产品细节，应该回官方文档核验；如果你想看Aaron工作流怎么在真实项目里使用 Claude Code，再回主站实践文章。

## 商业项目里的学习目标

学完这套 Claude Code 教程后，最低标准不是“知道有哪些功能”，而是能在一个真实 repo 里完成可审查任务：

- 让 Claude Code 先读项目规则和相关文件，再开始修改。
- 能控制权限、命令执行和外部工具访问。
- 能把大任务拆成可验证的小任务。
- 能要求它跑测试、解释失败、修根因，而不是跳过错误。
- 能把高频经验写成项目规则、Skill 或团队 SOP。

这些能力决定它能不能进入长期工作流。只会让模型“帮我写代码”还不够，商业项目需要的是范围控制、事实核验、可回滚 diff 和稳定交付。

## 入口选择

站内两条路径可以交替读：

- 想查功能和配置：进官方教程中文版，从目录页按模块找答案。
- 想理解使用逻辑：进从原理到实战，按“为什么这样用”建立判断。

真实项目里通常先查官方教程确认事实，再回原理页判断任务边界。比如遇到 MCP 问题，先确认 Claude Code 支持什么配置和命令，再判断这个 MCP 是否应该进入项目、是否需要凭据隔离、是否会扩大权限面。这样读，教程站就不是资料堆叠，而是一个能指导工作流决策的索引。

## 更新原则

Claude Code 变化很快，教程站只保留稳定能力和可复用操作。涉及模型、套餐、平台限制、发布节奏或实验功能时，以官方文档和发布记录为准；涉及Aaron工作流的真实用法时，以主站实践文章为准。两者分开，能避免教程页写成临时新闻，也避免实践页承担事实手册的职责。

后续更新时，优先补会影响真实操作的内容：安装认证、权限边界、MCP 配置、项目规则、工具调用、测试验证和团队复用。只影响营销文案或临时 UI 位置的变化，不进入核心教程。

因此，这个入口页只负责帮你选路；具体步骤进入官方教程，具体判断进入原理实战，具体案例回主站。

阅读时建议从一个真实仓库带着问题进入，而不是只顺序浏览目录。带着失败命令、权限疑问或迁移目标阅读，吸收效率更高，也更容易形成可复用的工作流方法。

## 官方资料

- 官方文档索引：[https://code.claude.com/docs/llms.txt](https://code.claude.com/docs/llms.txt)
- Claude Code overview：[https://code.claude.com/docs/en/overview](https://code.claude.com/docs/en/overview)
- 上游源码：[https://github.com/anthropics/claude-code](https://github.com/anthropics/claude-code)

## 延伸阅读

- Claude Code 实践：[xiangyugongzuoliu.com/tag/claude-code](https://xiangyugongzuoliu.com/tag/claude-code)
- AI 编程实操课：[FlowUS 课程页](https://flowus.cn/xiangyugongzuoliu/share/d392dcad-b537-44ee-a3e2-56ff5af02bce)
- 公开仓库：[github.com/xiangyugongzuoliu/claude-code-tutorial](https://github.com/xiangyugongzuoliu/claude-code-tutorial)
