Claude Code 开源指南：结构化学习路径与实战示例

你有没有过这样的体验？花了不少时间安装好 Claude Code，兴致勃勃地打开终端，输入第一个提示词……感觉还不错。但然后呢？好像就不知道该做什么了。

翻过官方文档，知道它有很多功能，比如斜杠命令、钩子、MCP，可这些功能点散落各处，不知道如何把它们组合起来，解决实际问题。结果就是，每次使用 Claude Code，依然停留在“聊天式问答”的层面，和直接用网页版感觉没什么本质区别。

今天要介绍的这个开源项目，就是为了终结这种尴尬而生的。

项目是什么？

luongnv89/claude-howto —— 一份可视化、示例驱动的 Claude Code 完整使用指南。

它并非官方文档的简单翻译，也不是功能的罗列堆砌。它为你设计了一条从入门到高级的结构化学习路径，并且配备了 Mermaid 流程图、可以直接复制粘贴的配置模板，以及真实可用的工作流示例。

官方文档 vs 这份指南

作者在 README 里直截了当地放了一张对比表：

维度	官方文档	这份指南
形式	功能参考文档	可视化教程 + Mermaid 图
深度	功能描述	讲清楚底层原理
示例	基础代码片段	生产可用的模板，直接复制
结构	按功能组织	渐进式学习路径（入门→高级）
自测	无	内置 quiz，找出你的知识盲区

简单来说，官方文档告诉你“有什么”，而这份指南则专注于告诉你“怎么用”以及“为什么这么用”。

10 个模块，11-13 小时，从零到高手

整个指南被精心划分为 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（子 Agent）	中级+	1.5 小时
9	Advanced Features（高级特性）	高级	2-3 小时
10	Plugins（插件系统）	高级	2 小时

如果你不确定该从哪里开始，可以在 Claude Code 里运行 /self-assessment 命令，它会根据你当前的水平推荐个性化的学习路径。

15 分钟快速上手

不想一上来就啃完整个路径？作者贴心地准备了一个 15 分钟的“最小可行方案”：

# 第一步：克隆指南
git clone https://github.com/luongnv89/claude-howto.git
cd claude-howto

# 第二步：复制第一个斜杠命令
mkdir -p /path/to/your-project/.claude/commands
cp 01-slash-commands/optimize.md /path/to/your-project/.claude/commands/

# 第三步：在 Claude Code 里试用
# /optimize

# 第四步：设置项目记忆
cp 02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md

只需四步，大约15分钟，你就能立刻感受到 Claude Code 能力的不同之处。

真正的威力：把功能串起来

单独使用某个功能，效果有限。这份指南最有价值的部分，在于教你如何将多个功能组合成自动化工作流。

来看三个真实的场景示例：

场景一：自动化 Code Review

用户输入：/review-pr

Claude 自动执行：
1. 加载项目记忆（编码规范）
2. 通过 GitHub MCP 拉取 PR 内容
3. 派发给 code-reviewer 子 Agent
4. 派发给 test-engineer 子 Agent
5. 汇总两个 Agent 的结论
6. 输出完整 Review 报告

场景二：自动生成 API 文档

用户输入：帮我给 auth 模块生成 API 文档

Claude 自动执行：
1. 加载项目记忆（文档规范）
2. 识别文档生成意图，自动触发 doc-generator skill
3. 派发给 api-documenter 子 Agent
4. 生成带示例的完整文档

场景三：一键部署到生产

用户输入：/deploy production

Claude 自动执行：
1. 触发 pre-deploy hook（验证环境）
2. 派发给 deployment-specialist 子 Agent
3. 通过 Kubernetes MCP 执行部署
4. 监控部署进度
5. 触发 post-deploy hook（健康检查）
6. 汇报部署结果

这才是 Claude Code 的正确打开方式——它的核心不是聊天，而是智能工作流编排。

几个值得单独说的功能

Hooks（事件钩子）

这是很多人没用过但极其强大的功能。Hooks 支持 4 种类型、25 个事件，可以在 Claude 执行任何操作的前后自动触发自定义脚本：

• 写文件前，自动格式化代码
• 提交代码前，自动运行测试套件
• 每次操作后，自动进行安全扫描
• 有重要通知时，自动发送 Slack 消息

配置示例如下：

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Write",
      "hooks": ["~/.claude/hooks/format-code.sh"]
    }],
    "PostToolUse": [{
      "matcher": "Write",
      "hooks": ["~/.claude/hooks/security-scan.sh"]
    }]
  }
}

Checkpoints（存档回溯）

Claude Code 会在每次用户输入时自动创建存档点。如果你不小心把代码改乱了，或者想尝试不同思路，只需要按两下 Esc 键或输入 /rewind 命令，就可以选择：

1. 恢复代码 + 对话
2. 只恢复对话
3. 只恢复代码
4. 从这里开始总结
5. 算了，不回滚

对于需要“先试试看”的探索性开发，这个功能简直是救命稻草。

Memory（持久记忆）

指南详细讲解了三层记忆体系，让你告别重复的背景说明：

• ~/.claude/CLAUDE.md — 个人偏好与习惯，所有项目通用。
• ./CLAUDE.md — 项目级规范与约定，方便团队成员共享上下文。
• ./src/api/CLAUDE.md — 目录级特定规则，实现精细化的控制。

你可以把团队编码规范、项目架构决策、API设计原则等内容写进对应的文件，Claude 会在相关操作时自动加载这些记忆，无需你每次手动解释。

还能导出成电子书

如果你喜欢离线阅读，或者想在移动设备上学习，这份指南支持一键导出为电子书：

uv run scripts/build_epub.py

运行这条命令，即可将整个指南打包成 EPUB 格式的电子书，其中包含渲染好的 Mermaid 图表，方便你随时随地查阅。对于这种系统性的技术文档，拥有一个离线的、结构清晰的版本是非常实用的。

项目信息

• GitHub：github.com/luongnv89/claude-howto
• Stars：9,900+
• Forks：690+
• 许可证：MIT
• 维护状态：持续更新，与 Claude Code 版本同步（当前基于 v2.2.0，2026 年 3 月）
• 兼容性：Claude Sonnet 4.6 / Opus 4.6 / Haiku 4.5 均可用

许多开发者在安装好 Claude Code 后，可能只利用了它不到 10% 的潜力。这份开源实战指南的目标很明确：帮你把剩下那 90% 的能力也充分发掘出来，真正提升开发效率与体验。如果你想深入了解这个强大的AI编程工具，不妨从这份高质量的指南开始你的探索。