--- title: "法律人学Claude｜第十一期：给AI这匹野马套上缰绳——Hooks机制" section: "法律AI教程" slug: "2026-04-07-法律人学Claude｜第十一期-给AI这匹野马套上缰绳——Hooks机制" canonical_url: "https://fazhuli.cn/tutorials/t_1beg8fzb33a" date: "2026-04-07" author: "吕盈辉" tags: ["Claude Code", "VSCode", "基础教程"] --- # 法律人学Claude｜第十一期：给AI这匹野马套上缰绳——Hooks机制 作者：吕盈辉 发布日期：2026-04-07 ## 摘要 不知道你经历过这个场景没？ ## 正文 不知道你经历过这个场景没？ 接了一个新客户，需要提供一份法律服务报价方案。 时间紧，你用AI辅助起草，里面涉及了几个关键法条作为服务依据。 做完之后，你有个习惯，发出去之前最后核查一遍。这一查，发现AI引用的某条条文措辞有偏差——不是现行版本的原文，是它"理解性地概括"出来的，还模仿得像模像样。 你心里一凉。这是新客户，报价方案里出现错误法条，直接发过去，客户大概率觉得你不专业，单子就黄了。 本来用AI是为了降本增效，结果差点因为AI搞丢重要客户。 这不是Claude不聪明，是你没给它规则。 它不知道引用法条要逐字核准，除非每次都告诉它。而且即便说了，它也可能在某次任务繁忙时"自己判断一下差不多就行了"。 Hooks解决的就是这个问题。 ## 一、先说一个概念：Harness Engineering 在讲Hooks之前，想先说说一个词——Harness Engineering，暂且翻作"驾驭工程"。 把Claude想象成一匹很聪明但没有固定纪律的马。你可以告诉它你是谁（CLAUDE.md）、你的工作习惯（Memory）、要用什么流程处理任务（Skill）。这些都是引导，Claude可以照做，也可以"理解性地偏离"。 Harness Engineering要解决的问题是： 把这套引导设计成一个有约束力的框架，让Claude无法绕过你的规则 。 这四种机制的差距，放一起看就清楚了： ![image](https://mmbiz.qpic.cn/mmbiz_png/eRZqoqddscKa9wPcBygRIORicv1xjvPst5iaMyOM2VXUBQtMYKqF7RQhXu78iaAAVhJXuaXAFKGiayGqtQbDC59HNvXqMcLOjVyibSzYhytIrxyI/640?wx_fmt=png&from=appmsg) Hooks是这里面唯一真正强制性的一层。 CLAUDE.md告诉Claude"你应该这样做"，Hooks告诉系统"不管Claude有没有记住，这个动作必须发生"。两者要配合用——CLAUDE.md管思维方向，Hooks管关键节点的强制动作。合起来，才算是完整的harness。 ![马与缰绳——Harness Engineering类比](https://mmbiz.qpic.cn/sz_mmbiz_png/et3ibfiaM9ia2yH9oDZpuKOd00fyn72xYTmL9l2FcqkMVCEDsticiaMhfdW7XdS6mfHsbVZZAeuhuaJ3vyxZJezmeJPpicpmicEcaQF1ibMgfXtDPLI/640?wx_fmt=png) ## 二、Hooks是什么 原理很简单：在Claude调用某个工具的 之前 或 之后 ，自动触发你预先设定好的动作，这个机制是硬编码的必选项，不是软性约束的可选项。 比如： - Claude要修改文件——修改之后，自动git commit留痕 - Claude要输出引用了法条的内容——输出之后，自动调用北大法宝核验条文 这些动作不经过Claude的"判断"，直接由系统执行。你不用每次在对话里提醒它，因为规则写死在配置文件里了。 理解Hooks需要搞清楚四件事。 触发时机。 PreToolUse 是Claude调用工具之前，可以拦截审查； PostToolUse 是工具调用之后，可以补充动作或记录日志。类比一下：PreToolUse是出发前检查装备，PostToolUse是回来后交接汇报。 触发条件。 可以精确指定某个工具，比如只在Claude"写文件"时触发；也可以用 * 匹配所有工具调用。 触发动作。 执行的是一段系统命令，比如git commit、调用MCP工具、发出通知。退出结果决定后续：正常退出则Claude继续；返回错误则Claude收到提示但可以继续；强制中断则该操作无法进行。 ![Hooks工作机制流程图](https://mmbiz.qpic.cn/sz_mmbiz_png/et3ibfiaM9ia2y3IyEiaSqoaEXgJiaYIbK7nUZBhWqPtcoLqBQOtMLh5QpcV5oicPrSnJF9Ax4diauSBxhnw1whMxqqwuy7Xy7tsWeuszkHBuAb1hg/640?wx_fmt=png) 配置位置： 全局Hook写在 ~/.claude/settings.json ，对所有项目生效；案件级Hook写在案件文件夹的 .claude/settings.json ，只对该案件生效。 操作方式： 在对话框输入 /update-config ，告诉Claude要配置什么规则，它帮你写进配置文件。 ![image](https://mmbiz.qpic.cn/mmbiz_png/eRZqoqddscLqJXCjjAgN3z6hNBo65g5JLjnCfge339vSHTib0Z6vLmkXd4EF4Rbx9ib3FCqOdqYF0IssNA1Yo0lFFZyzkicoBbCnxVvK67vnicY/640?wx_fmt=png&from=appmsg) ## 三、实战一：引用法条，自动北大法宝核验 这就是我开头那个差点出事的场景。解法是这样的： 1. 确认北大法宝MCP已配置好（参考 [法律人学Claude｜第七期：给Claude装上"外挂"——CLI与MCP工具使用指南](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247484016&idx=1&sn=b9c133c92439c778f48d79bb03a1fbb1&scene=21#wechat_redirect) ） 2. 在对话框输入 /update-config ，点击Add a hook 3. 告诉Claude："每次你输出包含法条引用的内容后，必须调用北大法宝MCP工具核验该条文的现行有效版本。如果条文内容有出入，在回复末尾注明差异" 4. Claude生成配置写入 settings.json ，重启Claude Code 5. 测试：让Claude分析一份合同违约条款，看是否自动触发核验 效果是这样的：Claude在回复末尾会自动出现"已通过北大法宝核验，条文内容准确"，或者"注意：该条文已于XX年修订，现行版本为……"。 不需要你每次提醒，这是系统行为。 ## 四、实战二：修改文书，强制git commit留档 第十期讲了git的基本操作，但靠律师自己每次手动提交，实际很难坚持。Hooks可以把这件事变成强制行为。 1. 确认案件文件夹已完成 git init （参考 [法律人学Claude｜第十期：被AI改乱的文档如何自救？——Git工具的使用](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247484064&idx=1&sn=fbccf45417d0f66c968dc679265f0b00&scene=21#wechat_redirect) ） 2. 输入 /update-config 3. 告诉Claude："每次你修改或新建 .md 、 .docx 、 .txt 格式的法律文书文件之后，必须立即执行git add和git commit，commit信息包含当前时间和你做了什么改动的简短描述" 4. 保存配置，重启Claude Code 5. 测试：让Claude修改一份代理词，看修改完后终端是否出现git commit提示 ![image](https://mmbiz.qpic.cn/mmbiz_png/eRZqoqddscIG4Z1DvmLFUqRT0rAzIqAS19yV1AOmgYz2LeshOCicP35icvL48RXLpwt44Ov1jnDpANAAhqnkw1ggqbUtzROFSES98TGNEeet4/640?wx_fmt=png&from=appmsg) 还可以让Claude自动生成语义化的commit描述，比如"修改第二部分事实陈述——补充违约时间节点"，比干巴巴的时间戳好看得多。也可以配置：git commit失败时直接中断修改并提示律师先执行 git init ，省得改了半天没留档。 关键就是：Claude改坏了？ git checkout ，秒回上一版。不依赖律师自己记得备份，因为它根本没机会跳过这步。 ## 五、四层叠起来 回到harness这个框架。 CLAUDE.md是岗位手册，定义Claude在这个工作区里的角色和基本规则。 （参考： [法律人学Claude｜第四期：你的项目助理—CLAUDE.md使用指南](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247483973&idx=1&sn=a26555517c52d5f6cc8afa97ba0dd89e&scene=21#wechat_redirect) ） Memory是它对你这个人的长期了解，换案件文件夹也带着走。 （参考： [法律人学Claude｜第六期：不做8秒记忆的金鱼——优化记忆Memory](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247484000&idx=1&sn=291d442fc2282c767f8b8cc2f773fcf7&scene=21#wechat_redirect) ） Skill是专用工具包，复杂任务一键触发。（参考： [法律人学Claude｜第五期：让Claude用上次抛App——Skills初解](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247483994&idx=1&sn=91cefe0a8249c76493c7704b868edd49&scene=21#wechat_redirect) 、 [法律人学Claude｜第九期：给自己定制一个审合同Skill——Skill详解](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247483994&idx=1&sn=91cefe0a8249c76493c7704b868edd49&scene=21#wechat_redirect) ） Hooks是最硬的那一层，关键操作节点，强制执行，绕不过去。 ![image](https://mmbiz.qpic.cn/sz_mmbiz_png/eRZqoqddscI0xviahIQZ3MdDZmsZmWozHXQyJQ11xY2BlJ627BTWUNW8MSiaOepSciaMbRf8b9sIDFEPyxXReicG9zibH8D9g1RaUSZNNjHG0jF8/640?wx_fmt=png&from=appmsg) 四层搭好，Claude就不只是个聊天工具了，是一个在你设计的规则框架里运转的工作系统。 ## 常见问题 Q：Hooks配置后不生效？ A： 先检查 settings.json 的格式是否正确（可以让Claude帮你验证），然后重启Claude Code。JSON格式里一个多余的逗号就会导致配置失效，这个坑挺常见的。 Q： 北大法宝MCP没有响应？ A： 回到第七期，检查MCP工具是否正确安装和配置。Hooks调用的是你已经配置好的工具，工具本身没装好，Hook触发了也没用。 Q： git commit失败提示"not a git repository"？ A： 先在案件文件夹里执行 git init ，再重新触发。参考第十期。 Q： 如何临时关掉某个Hook？ A： 在 settings.json 里找到对应Hook配置，加一个 "enabled": false 字段，或直接删掉这段配置。不用删整个文件。 Q： CLAUDE.md里写了规则，还需要Hooks吗？ A： 两者不替代。CLAUDE.md是引导，Claude理解后照做，但有时会"自己判断"。Hooks是强制触发，Claude无法跳过。重要的、不能有遗漏的步骤，用Hooks；日常的风格偏好和工作规则，CLAUDE.md就够了。 ## 往期回顾 [法律人的AI agent教程 合集](https://mp.weixin.qq.com/mp/appmsgalbum?__biz=MzI0NzUwMDUzMw==&action=getalbum&album_id=4453870239231082497#wechat_redirect) [法律人学Claude｜第一期：桌面版已经很好用了，为什么我还是力推 VSCode 插件版？](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247483900&idx=1&sn=8ed3394ed1fde9b78e5f5b285dfd34a5&scene=21#wechat_redirect) [法律人学Claude｜第二期：半小时装好 VSCode + Claude Code](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247483936&idx=1&sn=5a4ce57b245c80cee51253db8e605518&scene=21#wechat_redirect) [法律人学Claude｜第三期：让Claude更高效读懂你的文件](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247483964&idx=1&sn=cffd5fe7bd3d23e91a312f587ed5c906&scene=21#wechat_redirect) [法律人学Claude｜第四期：你的项目助理—CLAUDE.md使用指南](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247483973&idx=1&sn=a26555517c52d5f6cc8afa97ba0dd89e&scene=21#wechat_redirect) [法律人学Claude｜第五期：让Claude用上次抛App——Skills初解](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247483994&idx=1&sn=91cefe0a8249c76493c7704b868edd49&scene=21#wechat_redirect) [法律人学Claude｜第六期：不做8秒记忆的金鱼——优化记忆Memory](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247484000&idx=1&sn=291d442fc2282c767f8b8cc2f773fcf7&scene=21#wechat_redirect) [法律人学Claude｜第七期：给Claude装上"外挂"——CLI与MCP工具使用指南](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247484016&idx=1&sn=b9c133c92439c778f48d79bb03a1fbb1&scene=21#wechat_redirect) [法律人学Claude｜第八期：法律人的文档革命——你必须学会Markdown](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247484027&idx=1&sn=5caa8abd763821be91eebf4257ebf6e2&scene=21#wechat_redirect) [法律人学Claude｜第九期：给自己定制一个审合同Skill——Skill详解](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247484051&idx=1&sn=4d90b86f04b6efa4feb9c1eca7c82d21&scene=21#wechat_redirect) [法律人学Claude｜第十期：被AI改乱的文档如何自救？——Git工具的使用](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247484064&idx=1&sn=fbccf45417d0f66c968dc679265f0b00&scene=21#wechat_redirect) 对了，我建了一个交流群，有想 进群 的伙伴可以 加我 。 ![Image](https://mmbiz.qpic.cn/mmbiz_png/eRZqoqddscIZicZjJwCt9r8OJ0p1VnmI3SDv5mezeuicX4v0680OnfKlkVLnlMetVrsI9fYlKA529YyH5ghtrsuQLFLBAZxQQwqxSsdPwZVick/640?wx_fmt=png&from=appmsg&wxfrom=5&wx_lazy=1&watermark=1&tp=webp#imgIndex=25) ![Image](https://mmbiz.qpic.cn/sz_mmbiz_png/n4XBCxTNZceWxf7mv9E4TSY7OjucEyT6Y9O1icHUzb1Fgb1jicIqcFkVLogHDJiaglLU8iaTfgd1kRVfC0rgu4Wmqg/640?wx_fmt=png&wxfrom=5&wx_lazy=1&tp=webp#imgIndex=26) 如果你想学AI，我创建了一个知识星球，现在招募创始会员20名。 原价999，现在早鸟价，一年699，一天不足2元钱即可加入，但优惠券先到先得。 如果你付费过 [法律人学Claude｜第十六期：终结Dirty Work——纯自动化干活](https://mp.weixin.qq.com/s?__biz=MzI0NzUwMDUzMw==&mid=2247484186&idx=1&sn=2bbc852e1412c5437225a134dcb4f772&scene=21#wechat_redirect) 这篇文章，可以私聊我再额外领取一张一百元优惠券。 加入星球你将获得更多更深入的法律AI使用方法，也可以获得更具体细致的解决方案。 ![image](https://mmbiz.qpic.cn/mmbiz_png/eRZqoqddscKRKzRT2QgkQwk6gp00MFpiasYUMpc6eaYaeicWMKUHqtOdWic9qYkomPvxjUmRjibicECQqQzMRCBrq9HMlIKGefujCCRpOmqCVnAI/640?wx_fmt=png&from=appmsg) ## 作者简介 本文作者：吕盈辉，上海曼昆（深圳）律师事务所律师。毕业于中国政法大学，法律行业深耕近十年，曾在深圳某法院工作。专注新生代经济领域法律服务，对Web3、人工智能等领域有丰富实践经验与深刻见解。 全平台账号：老吕谈新钱，欢迎关注。