Claude Code 中文教程
基于 Anthropic 官方文档、源码和发布记录重写的 Claude Code 中文教程，连接翔宇工作流的真实项目实践。
📖 本篇术语速查表
| 英文 / 缩写 | 中文 | 一句话解释 |
|---|---|---|
| Claude Code | CC | Anthropic 官方的终端 AI 编程 agent。 |
| 两条线 | two tracks | 理解篇打底，官方篇查细节。 |
| 按需进入 | entry | 按目标选先读哪条线。 |
不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你按目标决定先读 Claude Code 的理解篇还是官方篇。
你是 Claude Code 教程导航顾问。
【角色】
Claude Code 教程导航顾问，按最小够用、安全优先的原则给可落地方案，每条结论都落到能照做的具体步骤或示例，不停留在「建议」「考虑一下」这类空泛表述。
【输入】
- 我的目标：___
- 对 Claude Code 的了解：___
- 最想解决的问题：___
- 可投入时间：___
- 经验水平：___
【工作流程】
1. 按目标区分两条线用途
2. 给先读哪条的建议
3. 排推荐顺序
4. 标出可跳读的
5. 给第一步
【输出规范】
▌一、两条线用途
▌二、先读哪条
▌三、推荐顺序
▌四、按需跳读 + 第一步
【硬约束】
- 按目标选线不强行通读
- 先理解后查手册
- 贴合经验水平
- 不要替我臆测情况或编造不存在的功能，信息不全先问清
- 不确定的配置或接口一律以官方文档为准，禁止照搬过时写法中文开发者的 Claude Code 官方教程中文版。这里以 Anthropic 官方文档、源码和发布记录为事实基准，重新组织成适合中文开发者学习和操作的教程：安装、登录、CLI、配置、权限、MCP、Skills、Subagents、Hooks、插件和 SDK。
这一站不是 Anthropic 官方文档的翻译：每一篇都按"中文新手 → 第一性原理 → 循序渐进"重写。理解篇负责心智模型，官方篇负责事实基准；两条路径同时跑，不替代彼此。
翔宇工作流主站负责另一件事：记录真实项目里怎么用 Claude Code、怎么踩坑、怎么把工具变成长期工作流。教程站不替代主站实践，只给主站提供稳定的事实基准。
两条互补路径
三层分工
- 教程站：吸收 Claude Code 官方资料，重写成中文学习路径，保持事实准确、结构稳定、便于检索。
- 翔宇主站：承接 Claude Code 的个人实践、项目复盘、失败经验和工作流判断。
- GitHub：保留公开内容源，方便追踪变更、提交 Issue 或 PR。
推荐学习顺序
第一次系统学习 Claude Code，不要直接从高级插件或自动化开始。更稳的顺序是：
- 先读官方教程中文版，确认安装、登录、CLI、项目上下文、权限和基本命令。
- 再读“从原理到实战”，理解它为什么能读代码、改文件、调用工具和运行命令。
- 然后回到真实项目，用一个小改动练习 plan、edit、test、review 的闭环。
- 最后再进入 MCP、Skills、Subagents、Hooks、插件和 SDK，把重复流程沉淀成可复用能力。
这个站点的定位不是“把 Anthropic 文档翻译一遍”。每篇文章都会尽量回答三个问题：官方能力是什么、中文开发者容易误解在哪里、放到真实项目时应该如何验收。
适合谁读
- 刚开始使用 Claude Code，需要一套中文路径避免在官方文档里来回跳转。
- 已经会用 CLI，但想系统理解权限、上下文、MCP 和 agentic workflow。
- 正在把个人 prompt 升级为团队规则、Skills 或自动化流程。
- 需要给学员或团队成员一个稳定入口，而不是把零散链接发给他们。
如果你只想看最新产品细节，应该回官方文档核验；如果你想看翔宇工作流怎么在真实项目里使用 Claude Code，再回主站实践文章。
商业项目里的学习目标
学完这套 Claude Code 教程后，最低标准不是“知道有哪些功能”，而是能在一个真实 repo 里完成可审查任务：
- 让 Claude Code 先读项目规则和相关文件，再开始修改。
- 能控制权限、命令执行和外部工具访问。
- 能把大任务拆成可验证的小任务。
- 能要求它跑测试、解释失败、修根因，而不是跳过错误。
- 能把高频经验写成项目规则、Skill 或团队 SOP。
这些能力决定它能不能进入长期工作流。只会让模型“帮我写代码”还不够，商业项目需要的是范围控制、事实核验、可回滚 diff 和稳定交付。
入口选择
站内两条路径可以交替读：
- 想查功能和配置：进官方教程中文版，从目录页按模块找答案。
- 想理解使用逻辑：进从原理到实战，按“为什么这样用”建立判断。
真实项目里通常先查官方教程确认事实，再回原理页判断任务边界。比如遇到 MCP 问题，先确认 Claude Code 支持什么配置和命令，再判断这个 MCP 是否应该进入项目、是否需要凭据隔离、是否会扩大权限面。这样读，教程站就不是资料堆叠，而是一个能指导工作流决策的索引。
更新原则
Claude Code 变化很快，教程站只保留稳定能力和可复用操作。涉及模型、套餐、平台限制、发布节奏或实验功能时，以官方文档和发布记录为准；涉及翔宇工作流的真实用法时，以主站实践文章为准。两者分开，能避免教程页写成临时新闻，也避免实践页承担事实手册的职责。
后续更新时，优先补会影响真实操作的内容：安装认证、权限边界、MCP 配置、项目规则、工具调用、测试验证和团队复用。只影响营销文案或临时 UI 位置的变化，不进入核心教程。
因此，这个入口页只负责帮你选路；具体步骤进入官方教程，具体判断进入原理实战，具体案例回主站。
阅读时建议从一个真实仓库带着问题进入，而不是只顺序浏览目录。带着失败命令、权限疑问或迁移目标阅读，吸收效率更高，也更容易形成可复用的工作流方法。
官方资料
- 官方文档索引：https://code.claude.com/docs/llms.txt
- Claude Code overview：https://code.claude.com/docs/en/overview
- 上游源码：https://github.com/anthropics/claude-code
延伸学习
- Claude Code 实战文章：xiangyugongzuoliu.com/tag/claude-code
- 翔宇 AI 编程实操课（国内） · 翔宇 AI 编程实操课（海外）
- Claude Code 教程公开仓库：github.com/xiangyugongzuoliu/claude-code-tutorial