第 6 篇:从文件到系统,CLAUDE.md 与 hooks、subagents 的协作升级
CLAUDE.md 里的规则,Claude 遵守的概率是 70%-95%(取决于规则清晰度和上下文复杂度)。而 hooks 执行的概率是 100%——因为它不是靠 Claude "记住",而是由系统自动触发。Hooks 是 Claude Code 提供的自动化机制——在 Claude 工作流的特定节点,自动运行你预设的脚本或命令。这就是 hooks 和 subagents 的作用——把"Claud

📌 本篇核心目标:把前五篇搭建的"规则体系 + 验证机制"升级为"系统级协作"。掌握 hooks 的配置方法和适用场景,理解 subagents 在内容项目中的使用策略,以及如何把三者组合成一个完整的 AI 协作操作系统。
你已经走到了哪里
如果你跟着前五篇做下来,你现在拥有了:
-
一份精简的 CLAUDE.md(规则入口)
-
6 份 docs/ 专项文档(按需加载的细则库)
-
一套 frontmatter 规范和 schema 定义(内容治理的基础)
-
三套检查清单(质量兜底)
这套体系已经比 90% 的项目强了。但它有一个本质局限:
所有规则的执行,都依赖 Claude "记住并遵守"。
Claude 大部分时候会遵守。但正如第 5 篇讲的——它偶尔会遗漏步骤、跳过验证、忘记跑构建命令。
在人类团队中,我们不会把代码质量完全寄托在"开发者记得跑 lint"上——我们用 pre-commit hook 自动执行。我们不会把代码审查完全寄托在"审查者仔细看了每一行"上——我们用 CI pipeline 自动检查。
同样的逻辑适用于 AI 协作:
规则由 CLAUDE.md 定义,但执行不应该只靠 Claude 的"自觉"。
这就是 hooks 和 subagents 的作用——把"Claude 应该做的事"变成"系统自动做的事"。
Hooks:给 Claude Code 装上自动执行的神经系统
Hooks 是什么
Hooks 是 Claude Code 提供的自动化机制——在 Claude 工作流的特定节点,自动运行你预设的脚本或命令。
你可以把它理解为 Git hooks 的 Claude Code 版本:
Git hooks:在 commit/push 等节点自动运行脚本
Claude Code hooks:在 Claude 使用工具/完成任务等节点自动运行脚本
关键区别在于:hooks 是确定性的。
CLAUDE.md 里的规则,Claude 遵守的概率是 70%-95%(取决于规则清晰度和上下文复杂度)。而 hooks 执行的概率是 100%——因为它不是靠 Claude "记住",而是由系统自动触发。
用原文作者的话说:
如果在 CLAUDE.md 里写"不要执行 rm -rf",Claude 大约 70% 的情况会遵守。如果用 hook 拦截这个命令,遵守率是 100%。
Hook 的三要素
每个 hook 由三部分组成:
事件(Event) → 什么时候触发?
匹配器(Matcher)→ 匹配哪个工具或操作?
动作(Action) → 触发后执行什么?
Claude Code 支持的核心事件
Claude Code 提供了多个生命周期事件,对内容型项目最有用的是这几个:
PreToolUse → Claude 使用某个工具之前触发
可以拦截操作、拒绝执行
PostToolUse → Claude 使用完某个工具之后触发
可以做后置检查、自动格式化
Stop → Claude 完成回复时触发
可以做最终验证、发送通知
SubagentStop → subagent 完成任务时触发
可以检查 subagent 的工作结果
SessionStart → 会话开始时触发
可以加载上下文、初始化环境
怎么配置 Hooks
Hooks 在 Claude Code 的 settings.json 中配置,或者通过 /hooks 命令交互式创建。
配置格式:
{
更多推荐



所有评论(0)