Claude Code 进阶教程：用 claude-howto 按 10 个模块搭出自己的工作流

用了一段时间 Claude Code，多数人会卡在同一个地方：斜杠命令、CLAUDE.md、Skills、Hooks、MCP、子 Agent 每样都听说过，单拿出来也会用，可一到真实项目里就不知道该先配哪个，更不知道怎么把它们串起来。

官方文档负责讲清楚每个功能"是什么"，至于"怎么组合"，基本得靠自己摸索。GitHub 上的开源项目 claude-howto（luongnv89/claude-howto，MIT 协议，目前超过 4 万 Star）补的就是这一块。它把 Claude Code 的功能拆成 10 个教程模块，每个模块都附了能直接复制进项目的配置文件，还排好了学习顺序。

这篇按"先跑起来、再按顺序学、最后组合成工作流"的思路，带你把这个仓库用起来。

claude-howto 解决的是哪类问题

项目 README 把痛点总结成三条，基本说中了大多数人的状态：

• 文档讲了功能，却没讲怎么把斜杠命令、Hooks、记忆和子 Agent 串成一条真正省时间的流程；
• 没有清晰的学习路径，不知道 MCP 和 Hooks 谁先谁后，结果样样都看过、样样不精；
• 示例太基础，一个 hello world 级别的斜杠命令，离"带记忆、能分派子 Agent、自动做安全扫描"的代码审查流程差得很远。

它给出的东西也对应这三点：10 个教程模块覆盖从斜杠命令到插件的全部主要功能；每个模块都有可复制的模板，包括斜杠命令、CLAUDE.md 模板、Hook 脚本、MCP 配置、子 Agent 定义和完整的插件包；另外还内置了自测命令，学完可以直接在 Claude Code 里检查自己漏了什么。仓库内容会跟着 Claude Code 版本更新，最近一次同步到 v2.1.310。

第一步：15 分钟先跑通一个命令

不用先通读，先让一个配置在自己项目里生效，后面学起来会快很多。README 给的起步方式只有几行：

# 1. 克隆仓库
git clone https://github.com/luongnv89/claude-howto.git
cd claude-howto

# 2. 复制第一个斜杠命令到你的项目
cp 01-slash-commands/optimize.md /path/to/your-project/.claude/commands/

然后在项目里打开 Claude Code，输入 /optimize，它就会按这个命令文件里的说明对当前代码做优化分析。

想再往前走一步，可以顺手把项目记忆和一个 Skill 装上：

# 项目记忆
cp 02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md

# 安装一个 Skill（个人级别）
cp -r 03-skills/code-review-specialist ~/.claude/skills/

这三步做完，你已经同时用上了斜杠命令、项目记忆和 Skill，接下来再去学更复杂的部分会更有体感。如果你的 Claude Code 还没装好或者还没接入可用的 API，可以先看 AIGoCode 使用指南，把注册、创建 API Key 和接入 Claude Code 这几步走完。

第二步：按推荐顺序学 10 个模块

claude-howto 的模块目录编号和推荐学习顺序并不一致。比如 Checkpoints 的目录是 08-checkpoints，在学习路径里却排在第 3 个。照着下面这张表的顺序学就行：

全部学完大约 11 到 13 个小时，一个周末能啃下来。已经有基础的话，可以按自己的水平跳着进：

• 入门：会启动 Claude Code、能正常对话，从斜杠命令开始，约 2.5 小时；
• 中级：已经在用 CLAUDE.md 和自定义命令，从 Skills 开始，约 3.5 小时；
• 进阶：已经配过 MCP 和 Hooks，直接看进阶功能，约 5 小时。

拿不准自己在哪一级，可以在 Claude Code 里运行 /self-assessment 做一次自测，它会按结果给你一份学习路线。

每个模块里最值得先拿走的东西

10 个模块不必一次全配上，下面按模块列出最常用的模板，先挑和自己项目最相关的。

斜杠命令：optimize.md（代码优化分析）、pr.md（准备 Pull Request）、generate-api-docs.md（生成 API 文档）。复制到项目的 .claude/commands/ 目录后，用 /optimize、/pr 这样的命令调用。

记忆：除了项目根目录的 project-CLAUDE.md，还有一个目录级模板 directory-api-CLAUDE.md，可以放进 src/api/CLAUDE.md，只在处理 API 目录时生效。关于 CLAUDE.md、rules、skills 和权限各自放在哪，可以对照这篇 Claude Code 的 .claude 文件夹怎么配。

Skills：code-review-specialist（带脚本的完整代码审查）、brand-voice（品牌语气一致性检查）、doc-generator（API 文档生成）。Skill 会在相关任务出现时自动调用，可以装到个人目录 ~/.claude/skills/，也可以装到项目的 .claude/skills/。

子 Agent：code-reviewer（代码质量分析）、test-engineer（测试策略与覆盖率）、documentation-writer（技术文档）、secure-reviewer（只读的安全审查）、implementation-agent（完整功能实现）。复制到 .claude/agents/ 后，主 Agent 会按任务自动分派。

Hooks：仓库里有 format-code.sh（写完代码自动格式化）、pre-commit.sh（提交前跑测试）、security-scan.sh（安全扫描）、log-bash.sh（记录所有 bash 命令）等脚本。按 README 的说法，Hooks 目前支持 5 种类型（command、http、prompt、mcp_tool、agent）和 33 个事件，分为工具、会话、任务、生命周期 4 类。最常用的是 PostToolUse：在 ~/.claude/settings.json 里给 Write 工具挂上格式化和安全扫描两个脚本，Claude 每次写完文件都会自动执行。

检查点：每次提交提示词都会自动创建检查点。按两次 Esc 或输入 /rewind，可以在 6 个选项里选择：同时恢复代码和对话、只恢复对话、只恢复代码、从这里开始总结、总结到这里为止，或者取消。想同时试两种实现方案时很好用。

进阶功能：包括规划模式、扩展思考（Alt+T 或 Option+T 切换）、后台任务，以及 6 种权限模式：default（手动确认）、acceptEdits、plan、auto、dontAsk、bypassPermissions。

插件：仓库自带 pr-review、devops-automation、documentation 三个插件包。注意这个仓库没有提供插件市场，所以不能用 /plugin install 安装，要在仓库根目录用本地加载的方式：

claude --plugin-dir ./07-plugins/pr-review

第三步：把模块组合成工作流

单个功能学会以后，claude-howto 真正有价值的地方在于告诉你哪些功能搭在一起用。README 列了 7 个典型组合：

以"自动化代码审查"为例，大致是这样配合的：CLAUDE.md 记下项目的代码规范，GitHub MCP 负责拉取 PR 内容，主 Agent 把审查拆给 code-reviewer 和 test-engineer 两个子 Agent，最后汇总成一份审查报告，整个流程用一个斜杠命令触发。

"复杂重构"这个组合也值得一试：先用规划模式定好改动范围，再靠检查点随时回退，Hooks 负责每次写完自动格式化和跑检查。大改动出错的成本会低很多。

学完一个模块就自测一次

每学完一个模块，可以在 Claude Code 里运行 /lesson-quiz 加上主题名，比如 /lesson-quiz hooks。它会出题检查你对这个模块的理解，指出遗漏的知识点。学到后面回头再测一次前面的模块，查漏补缺的效果更好。

几点使用建议

• 先抄后改：模板都是可以直接用的，但别原样塞进项目。尤其是 Hook 脚本和权限相关配置，先读一遍脚本内容，再按自己项目的目录和命令改。
• 一次只加一层：斜杠命令跑通了再加 Hooks，Hooks 稳定了再接 MCP。一下子全配上，出了问题很难定位是哪一层。
• 安全审计用只读子 Agent：secure-reviewer 本身就是只读设计，涉及安全扫描的流程尽量让它来做，避免审查时顺手改了代码。

如果你想用 Claude Code 跑这套工作流，可以通过 AIGoCode 接入，在模型页里查看当前可用的 Claude 模型和分组价格。周末抽一段时间，把 10 个模块从头走一遍，你的 Claude Code 用法会比只会聊天多出一大截。