01｜课程地图：先看懂 Claude Code 的完整能力版图
先确定学习顺序、能力边界和可直接复用的真实模板。
先确定学习顺序、能力边界和可直接复用的真实模板。
把自动补全想成只看眼前一句的输入法；Claude Code 更像坐在你旁边的结对工程师。它会先读地图，再提出路线，获得许可后改文件，最后跑检查。你仍然是驾驶员，目标、边界和验收都由你决定。
本课交付物
选择一个无风险的小仓库，只让 Claude Code解释入口文件、数据流和测试命令。要求它先不改代码，再把它的仓库地图与你手工观察的结果逐项核对。
核心讲解
从输入 claude 开始，到编排 agents、hooks、skills 和 MCP servers，全程配有可视化教程、可直接复制粘贴的模板，以及循序渐进的学习路径。
问题在哪里
你已经安装了 Claude Code。也试着跑了几个提示词。然后呢？
- 官方文档会介绍功能，但不会告诉你如何把它们组合起来。 你知道 slash commands 存在，但不知道怎样把它们和 hooks、memory、subagents 串起来，形成一个真正能节省数小时的工作流。
- 没有清晰的学习路径。 应该先学 MCP 还是 hooks？先学 skills 还是 subagents？结果往往是每样都看了一点，但没有一个真正掌握。
- 示例太基础。 一个 “hello world” 级别的 slash command，并不能帮你构建一个可用于生产环境的代码审查流水线，也无法让它结合 memory、委派给专门 agent、并自动执行安全扫描。
你实际上只用上了 Claude Code 10% 的能力，而剩下的 90% 你甚至不知道自己错过了什么。
本系列课程 如何解决这些问题
这不是另一份功能参考手册，而是一份结构化、可视化、以示例驱动的指南。它会教你如何使用 Claude Code 的每一项功能，并提供今天就能复制到项目里的真实场景模板。
| 官方文档 | 本指南 | |
|---|---|---|
| 形式 | 参考文档 | 带 Mermaid 图表的可视化教程 |
| 深度 | 功能说明 | 底层工作原理解析 |
| 示例 | 基础代码片段 | 可立即上手的生产级模板 |
| 结构 | 按功能组织 | 递进式学习路径（从入门到高级） |
| 上手方式 | 自主摸索 | 带时间预估的引导式路线图 |
| 自我评估 | 没有 | 交互式测验，帮你找出短板并生成个性化路径 |
你将获得：
- 10 个教程模块，覆盖 Claude Code 的所有核心功能，从 slash commands 到自定义 agent 团队
- 可复制粘贴的配置，包括 slash commands、
CLAUDE.md模板、hook 脚本、MCP 配置、subagent 定义，以及完整 plugin 打包 - Mermaid 图表，展示每个功能的内部工作机制，让你不仅知道“怎么做”，还知道“为什么这么做”
- 一条引导式学习路径，帮助你在 11 到 13 小时内从初学者成长为高级用户
- 内置自测能力，可以直接在 Claude Code 中运行
/self-assessment或/lesson-quiz hooks找出知识盲点
开始学习路线 ->
它是如何工作的
1. 先找到你的水平
完成自我评估测验，或者在 Claude Code 中运行 /self-assessment。系统会根据你已经掌握的内容，生成一份个性化学习路线。
2. 按引导路径学习
按照顺序学习 10 个模块，每个模块都建立在前一个模块的基础上。你可以一边学，一边把模板直接复制到自己的项目中。
3. 把多个功能组合成工作流
真正的威力来自功能组合。你会学到如何把 slash commands、memory、subagents 和 hooks 连接成自动化流水线，用于代码审查、部署和文档生成等任务。
4. 测试你的理解程度
每学完一个模块后运行 /lesson-quiz [topic]。测验会精准指出你漏掉的知识点，让你快速补齐短板。
已被开发者信赖
- GitHub stars，来自每天都在使用 Claude Code 的开发者
- Forks，许多团队已将这份指南改造成自己的工作流版本
- 持续维护中，会与每次 Claude Code 发布保持同步（最新版本：v2.1.112，2026 年 4 月）
- 社区驱动，贡献者会分享他们在真实工作中的配置和经验
不知道从哪里开始？
先做自我评估，或者直接按你的水平开始：
| Level | 你可以…… | 从这里开始 | 时间 |
|---|---|---|---|
| Beginner | 启动 Claude Code 并进行对话 | Slash Commands | 约 2.5 小时 |
| Intermediate | 使用 CLAUDE.md 和自定义命令 |
Skills | 约 3.5 小时 |
| Advanced | 配置 MCP servers 和 hooks | Advanced Features | 约 5 小时 |
完整学习路径，共 10 个模块：
| 顺序 | 模块 | 水平 | 时间 |
|---|---|---|---|
| 1 | Slash Commands | 初学者 | 30 分钟 |
| 2 | Memory | 初学者+ | 45 分钟 |
| 3 | Checkpoints | 中级 | 45 分钟 |
| 4 | CLI Basics | 初学者+ | 30 分钟 |
| 5 | Skills | 中级 | 1 小时 |
| 6 | Hooks | 中级 | 1 小时 |
| 7 | MCP | 中级+ | 1 小时 |
| 8 | Subagents | 中级+ | 1.5 小时 |
| 9 | Advanced Features | 高级 | 2 到 3 小时 |
| 10 | Plugins | 高级 | 2 小时 |
完整学习路线图 ->
15 分钟快速上手
# 1. 克隆这份指南
git clone
cd claude-howto
# 2. 复制你的第一个 slash command
mkdir -p /path/to/your-project/.claude/commands
cp 01-slash-commands/optimize.md /path/to/your-project/.claude/commands/
# 3. 试试看：在 Claude Code 中输入
# /optimize
# 4. 想更进一步？设置项目记忆：
cp 02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md
# 5. 安装一个 skill：
cp -r 03-skills/code-review-specialist ~/.claude/skills/
如果你想完成更完整的基础配置，这里有一个1 小时的关键配置方案：
# Slash commands（15 分钟）
cp 01-slash-commands/*.md .claude/commands/
# 项目记忆（15 分钟）
cp 02-memory/project-CLAUDE.md ./CLAUDE.md
# 安装一个 skill（15 分钟）
cp -r 03-skills/code-review-specialist ~/.claude/skills/
# 周末目标：继续添加 hooks、subagents、MCP 和 plugins
# 按学习路径逐步完成配置
本站实战工作台
先纠正一个最容易误导你的比喻
代码补全像一位反应很快的速记员：它看着光标附近的几行，猜下一段最可能出现什么。Claude Code 更像刚加入项目的结对工程师。它能在仓库里移动，读配置和测试，调用命令，修改多个文件，再根据真实输出修正判断。两者都会“生成代码”，但承担的工作完全不同。
这一区别决定了你该怎样下任务。对补全工具，你给半行代码；对 Coding Agent，你要给一张工作单：希望谁得到什么结果、允许碰哪些区域、哪些东西绝对不能动、用什么证据算完成。工作单越清楚，Agent 越不需要用猜测填空。
一次协作究竟发生了什么
把一次可靠协作拆开，会看到六个动作：理解目标、检查现场、提出路线、取得权限、小步实施、验证结果。它们不是仪式，而是六道防错关。
目标 → 仓库地图 → 可审查计划 → 受控修改 → 测试/页面证据 → 交付说明
↑ ↓
发现未知 ←──── 验收不通过 ←──── 修正
“仓库地图”至少回答入口在哪里、数据从哪里来、状态在哪里保存、现有测试怎样运行。没有这张地图就直接修改，和维修人员没看配电图就拆墙没有区别。
你与 Agent 的职责边界
你负责意图、取舍和授权。Agent 负责快速调查、机械执行和整理证据。比如“登录失败时显示更友好的提示”仍然缺少产品取舍：哪些错误可以透露给用户？中英文是否同步？是否影响安全？这些问题不能交给模型悄悄决定。
Agent 也不是最终事实来源。它说“测试通过”不算证据，命令的退出码和输出才算；它说“页面正常”不算证据，浏览器实际渲染、键盘操作和网络请求才算。
第一次只读仓库侦察
选择一个无生产密钥的小仓库，先禁止修改。给出下面的任务：
请先不要修改任何文件。阅读项目说明、依赖清单和入口文件，回答：
1. 用户请求从哪里进入；
2. 核心数据经过哪些模块；
3. 测试、构建和本地启动命令是什么；
4. 你仍不确定的三件事是什么。
每个结论都附文件路径或命令证据。
随后自己运行文件搜索和测试帮助命令。把 Agent 的地图分成“已证实、合理推断、仍未知”三栏。优秀结果不会假装全知，而会清楚标注证据边界。
一个常见失败：把流畅当成理解
Agent 可能快速给出漂亮的架构总结，却漏掉运行时配置或另一套入口。此时不要继续追问更多泛泛解释，而要缩小问题：“你说所有 API 都经过这个中间件，请给出注册位置，并搜索是否还有第二个应用实例。”让每个重要判断回到可检查对象。
本课验收
- 你能用自己的话区分补全、聊天模型和 Coding Agent。
- 仓库地图中的每条事实都有路径或命令输出。
- 整个实验没有修改文件。
- 至少发现一个 Agent 起初不知道、后来通过调查补齐的事实。
完成这一课后，你不需要相信 Agent“很聪明”。你需要确认它像一位专业同事那样工作：先看现场，说明依据，受控行动，用证据交付。