Claude Code 官方教程中文版
基于 Anthropic 官方文档重写的 Claude Code 中文教程入口，覆盖入门、配置、权限、MCP、Skills、Subagents、Hooks 和 SDK。
这组教程不是把英文文档逐段翻译成中文，而是把 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:2px2. 推荐学习顺序
如果你是新手，按这个顺序读：
- 先读入门与安装，确认 Claude Code 是什么、在哪些入口使用、怎么安装、怎么登录。
- 再读 settings，先把配置 scope 分清楚。
- 再读 permissions，避免还没理解权限就放开工具。
- 再读 memory，整理
CLAUDE.md、rules 和 auto memory。 - 再读 MCP，只连接真正能减少复制粘贴的外部系统。
- 最后读扩展与自动化：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. 章节入口
入门与安装
从产品定位、安装、登录到平台入口选择，先让 Claude Code 正确跑起来。
核心配置与能力
settings、permissions、memory、MCP：决定 Claude Code 是否能在真实项目里稳定、安全地用。
扩展与自动化
Skills、Subagents、Hooks、Commands、Agent SDK：把重复经验、隔离任务和产品化能力沉淀下来。
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，而不是过早产品化。