GitHub热榜开源项目，Claude Code 10模块系统学习指南

本文深度解读GitHub热榜第一的Claude Code开源教程仓库。项目包含10个精心设计的模块，从Slash Commands、Memory基础功能到Hooks、MCP、Subagents高级应用，提供125+个可复制模板。适合有基础的开发者系统学习Claude Code，15分钟快速上手，一个周末掌握工程级实战技能。附完整学习路径和自测系统。

相关链接：

• 项目地址：https://github.com/luongnv89/claude-howto
• 学习路径：LEARNING-ROADMAP.md
• 功能目录：CATALOG.md

---

前言：你装了 Claude Code，然后呢？

你装了 Claude Code，跑了几个 prompt，然后呢？

官方文档列出了 Slash Commands、Hooks、MCP、Subagents 等十几项功能——每一项你都"知道"，但没有一项你"用熟"。问题不在于功能太多，而在于没有人告诉你：这些功能应该按什么顺序学、怎么组合、什么时候该用哪个。

GitHub 上有一个仓库试图解决这个问题。根据项目 README 中的 Trending badge，它曾登上 GitHub Trending 第一名。MIT 开源，10 个教程模块覆盖 Claude Code 全部能力，配有 Mermaid 架构图和可直接使用的模板。它叫 claude-howto，标语只有一句话：Master Claude Code in a Weekend。

---

一、项目概览：字典 vs 教科书

一句话定位：claude-howto 是一个结构化、可视化、示例驱动的 Claude Code 教程仓库——它不仅是功能参考，还提供了学习路径和实操模板。

先看基本面：

指标	数据
GitHub Trending	第一名
开源协议	MIT
教程模块	10 个
学习时长	11-13 小时
语言支持	英语、越南语、中文、乌克兰语、日语
版本	v2.1.160（README）/ v2.1.176（CATALOG.md）
兼容模型	Claude Sonnet 4.6、Claude Opus 4.8、Claude Haiku 4.5

官方文档和这个项目的关系，可以用一个类比说清楚：

官方文档是"字典"，这个项目是"教科书"。 字典告诉你每个词的释义，教科书告诉你这些词怎么组成一篇文章。

README 中的对比表精确地描述了这种差异——官方文档是按功能组织的参考文档，提供基础代码片段；而 claude-howto 是按学习路径组织的可视化教程，提供可直接使用的模板，并配有 Mermaid 架构图展示功能的内部工作原理。

项目由开发者 luongnv89 创建并维护，从最近的 commit 记录来看（截至 2026 年 6 月仍有多次提交），维护状态活跃。每次 Claude Code 发布新版本，教程内容都会同步更新。

---

二、核心亮点：不只是内容多，设计思路本身值得学习

1. 渐进式学习路径——三级分层体系

项目最核心的设计决策是三级分层学习体系。LEARNING-ROADMAP.md 将学习者分为三个级别：

级别	内容	时间
Level 1: Beginner	Slash Commands + Memory + Checkpoints + CLI 基础	~3 小时
Level 2: Intermediate	Skills + Hooks + MCP + Subagents	~5 小时
Level 3: Advanced	Planning Mode + Auto Mode + Agent Teams + Plugins + CI/CD	~5 小时

每个级别都有明确的前置依赖检查和成功标准。例如，进入 Level 2 之前，你需要确认自己已经会创建和使用 Slash Commands、已经配置了 CLAUDE.md、知道如何创建和恢复 Checkpoints。

更关键的是，项目提供了自评估 Quiz 来帮你定位起点。在 LEARNING-ROADMAP.md 中有 8 个自检项：

• 勾选 0-2 项 → 从 Level 1 开始
• 勾选 3-5 项 → 从 Level 2 开始
• 勾选 6-8 项 → 直接进入 Level 3

这避免了"从头学浪费时间"和"跳级听不懂"的两难困境。

2. 可视化架构图——Mermaid 绘制的内部原理

每个模块都配有 Mermaid 绘制的架构图，这是项目区别于普通教程的标志性特征。

以 Slash Commands 模块为例，它不仅展示了命令的使用方法，还用两张 Mermaid 图分别呈现了：

• 命令架构图：用户输入如何分流到内置命令、Skill、Plugin 和 MCP Prompt
• 命令生命周期序列图：从用户输入 /optimize 到最终返回结果的完整交互流程

MCP 模块同样用 Mermaid 绘制了 MCP 架构图和生态系统图，展示 Claude 如何通过 MCP Server 连接 GitHub、数据库、Slack、Google Docs 等外部服务。

这些图不是装饰——它们回答的是"为什么这样设计"，而不仅仅是"怎么用"。

3. 可直接使用的模板——复制到目录即可运行

项目中的模板不是 hello world 级别的演示代码，而是可以直接放进项目使用的配置：

类型	数量	示例
Slash Commands	8 个	/optimize、/pr、/generate-api-docs、/commit 等
CLAUDE.md 模板	3 种粒度	项目级、目录级、个人级
Subagent 定义	9 个	code-reviewer、test-engineer、secure-reviewer 等
Hook 脚本	8+ 个	代码格式化、预提交检查、安全扫描等
MCP 配置	4 个	GitHub、数据库、文件系统、多服务器组合
Plugin 示例	3 个	PR Review、DevOps Automation、Documentation
Skill 目录	6 个	code-review-specialist、brand-voice 等

这些模板的共同特点是：复制到对应目录即可使用，不需要额外适配。

4. 自我评估体系——学完就知道自己会不会

项目内置了两个评估 Skill（位于 .claude/skills/ 目录下），直接在 Claude Code 中运行：

• /self-assessment：评估你在全部 10 个功能领域的掌握程度，提供"快速模式"（2 分钟）和"深度模式"（5 分钟）两种选择，生成个性化技能画像和学习路径
• /lesson-quiz [topic]：针对特定模块的测试题，例如运行 /lesson-quiz hooks 就会测试你对 Hooks 模块的掌握情况

这个设计解决了一个常见问题：学完之后不知道自己到底学会了没有。

---

三、架构与技术实现：教程仓库居然有工程级 CI/CD

1. 目录架构设计

项目的目录结构遵循一个清晰的原则：数字前缀 = 学习顺序。从 01-slash-commands 到 10-cli，编号不是字母排序，而是学习路径的顺序。

claude-howto/
├── 01-slash-commands/    # 8 个示例命令
├── 02-memory/            # CLAUDE.md 模板
├── 03-skills/            # Skill 示例
├── 04-subagents/         # 9 个 Agent 定义
├── 05-mcp/               # MCP 配置模板
├── 06-hooks/             # Hook 脚本
├── 07-plugins/           # Plugin 示例
├── 08-checkpoints/       # Checkpoint 指南
├── 09-advanced-features/ # 高级特性
├── 10-cli/               # CLI 完整参考
├── scripts/              # 构建与验证脚本
├── LEARNING-ROADMAP.md   # 学习路径
└── CATALOG.md            # 功能目录（125 项）

每个模块内部遵循统一结构：一个 README.md 作为主文档，加上可复制的模板文件。CATALOG.md 汇总了全部 125 个功能项（68+ Slash Command、17 Subagent、15 Skill、3 Plugin、9 MCP Server、8 Hook、3 Memory 文件），方便快速查找。

2. 质量保障体系——5 项 Pre-commit 检查

这是一个教程仓库，但它的 CI/CD 配置比很多应用项目都严格。Pre-commit hooks 在每次提交前运行 5 项检查：

检查项	工具	作用
markdown-lint	markdownlint-cli	Markdown 格式和结构规范
cross-references	自定义 Python 脚本	验证相对链接、锚点、代码围栏
mermaid-syntax	自定义 Python 脚本	确保所有 Mermaid 代码块可解析
link-check	自定义 Python 脚本	验证外部 URL 可达
build-epub	自定义 Python 脚本	确保 EPUB 构建不报错

scripts/ 目录下有 7 个脚本文件，配合 pytest（支持 Python 3.10/3.11/3.12）、ruff、mypy、bandit 组成完整的质量保障链。

3. EPUB 离线阅读

项目支持一键生成 EPUB 电子书：

uv run scripts/build_epub.py

该脚本调用 Kroki.io API 将 Mermaid 图表渲染为 PNG，然后将所有 Markdown 转换为 EPUB 兼容的 HTML，生成带封面和嵌套目录的完整电子书。使用异步并发请求加速图表渲染（默认最大并发数 10）。

注意：EPUB 构建依赖网络连接（需要访问 Kroki.io API），Markdown 源文件本身不需要网络即可阅读。

---

四、快速上手：15 分钟感受到变化

15 分钟快速体验

前提：已安装 Claude Code 并完成基本配置。

# 1. 克隆仓库
git clone https://github.com/luongnv89/claude-howto.git
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/

5 条命令，从零到拥有一个可用的代码优化命令、一份项目记忆配置和一个代码审查 Skill。

1 小时基础配置

1. Slash Commands（15 分钟）：复制全部示例命令到 .claude/commands/
2. 项目记忆（15 分钟）：基于 project-CLAUDE.md 模板创建你项目的 CLAUDE.md
3. 安装 Skill（15 分钟）：部署 code-review-specialist Skill
4. 组合试用（15 分钟）：看看命令、记忆和自动 Skill 如何协同工作

周末完整路径

时间	内容
周六上午（3h）	Level 1——Slash Commands + Memory + Checkpoints + CLI 基础
周六下午（3h）	Level 2——Skills + Hooks + MCP + Subagents
周日（4h）	Level 3——Advanced Features + Plugins + CLI Mastery + CI/CD 集成

---

五、实战案例：单个功能是工具，组合起来才是工作流

1. 自动化代码审查流水线

这是项目中展示的最完整的工作流示例，组合了 Slash Commands + Subagents + Memory + MCP 四种能力：

用户: /review-pr

Claude 执行流程:
1. 加载项目记忆（编码规范）
2. 通过 GitHub MCP 获取 PR 内容
3. 委派给 code-reviewer subagent 进行代码质量分析
4. 委派给 test-engineer subagent 进行测试策略评估
5. 综合两个 subagent 的发现
6. 生成完整的审查报告

关键在于：这不是简单的"让 Claude 看一下代码"，而是一个有明确分工的多 Agent 协作流水线。code-reviewer 专注于代码质量和设计模式，test-engineer 专注于测试覆盖率和策略。项目中提供了这两个 subagent 的完整定义文件，复制到 .claude/agents/ 目录即可使用。

2. CI/CD 集成——Headless Mode

Claude Code 支持非交互式运行，可直接嵌入 CI/CD 流水线：

# 非交互模式运行测试并生成报告
claude -p "Run tests and generate report"

# JSON 输出供脚本处理
claude -p --output-format json "list all functions"

# 带约束的审查（限制轮数）
claude -p --max-turns 3 --output-format json "review code"

3. 安全审计——只读模式

项目提供的 secure-reviewer subagent（位于 04-subagents/secure-reviewer.md）配置为只读模式——只能读取和分析代码，不能执行任何修改操作。结合 Hooks 模块中的 security-scan.sh 脚本，可以在每次代码写入后自动触发安全扫描。

---

六、不足与注意事项

客观地说，这个项目也有一些需要注意的地方：

1. 不是官方文档的替代品。README 明确表示两者是互补关系——“start here to learn, reference the docs when you need specifics”
2. 需要 Claude Code 订阅。项目本身免费开源，但 Claude Code 的使用需要 Anthropic 的订阅（具体费用请参考 Anthropic 官网）
3. 网络依赖。EPUB 构建需要访问 Kroki.io API
4. 版本跟踪压力。Claude Code 更新频率较高，建议定期 git pull 获取最新版本
5. 学习曲线仍在。11-13 小时的学习量对于周末计划来说仍然不小，Level 3 难度较高

---

七、总结

回到开头的问题：你装了 Claude Code，跑了几个 prompt，然后呢？

claude-howto 给出的答案是：然后你需要一本教科书，而不是一本字典。

它用三级渐进式学习路径解决了"按什么顺序学"的问题，用 Mermaid 架构图解决了"为什么这样设计"的问题，用可直接使用的模板解决了"怎么用到实际项目中"的问题，用自我评估体系解决了"学没学会"的问题。

一句话总结：这是一个用工程化思维解决"学习 AI 工具"这个问题的开源项目——它不仅教你用 Claude Code，它本身的设计模式也值得学习。

行动号召：如果你已经装了 Claude Code，现在就 clone 这个仓库，花 15 分钟复制一个 Slash Command 试试。你会立刻理解这个项目的价值。

本文基于 claude-howto 项目实际文档撰写，版本信息截至 2026 年 7 月。所有代码示例、功能列表和技术细节均来自项目源文件。

---

• 🎬 博客主页：https://xiaoy.blog.csdn.net

• 🎥 本文由 呆呆敲代码的小Y 原创 🙉

• 🎄 学习专栏推荐：Unity系统学习专栏

• 🌲 游戏制作专栏推荐：游戏制作

• 🌲Unity实战100例专栏推荐：Unity 实战100例 教程

• 🏅 欢迎点赞 👍 收藏 ⭐留言 📝 如有错误敬请指正！

• 📆 未来很长，值得我们全力奔赴更美好的生活✨

• ------------------❤️分割线❤️-------------------------

资料白嫖，技术互助

学习路线指引（点击解锁）	知识定位	人群定位
🧡 Unity系统学习专栏	入门级	本专栏从Unity入门开始学习，快速达到Unity的入门水平
💛 Unity实战类项目	进阶级	计划制作Unity的 100个实战案例！助你进入Unity世界，争取做最全的Unity原创博客大全。
❤️ 游戏制作专栏	难度偏高	分享学习一些Unity成品的游戏Demo和其他语言的小游戏！
💚 游戏爱好者万人社区	互助/吹水	数万人游戏爱好者社区，聊天互助，白嫖奖品
💙 Unity100个实用技能	Unity查漏补缺	针对一些Unity中经常用到的一些小知识和技能进行学习介绍，核心目的就是让我们能够快速学习Unity的知识以达到查漏补缺