Claude Code 钩子机制实战3 步让 AI 生成的命令符合你的习惯【免费下载链接】claude-codeClaude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-codeClaude Code 是跑在终端里的 AI 编码助手能读懂代码库、执行常规任务、处理 git 流程。它有个常被忽略的能力——钩子机制在 AI 真正执行命令之前插入你自己的检查逻辑。这篇带你用它给 AI 装一道命令守门员跟到文末AI 每次用grep搜文件都会被拦下来并提醒改用更快的rg想禁掉哪些写法、提醒哪些命令全由你自己定不用改 Claude Code 本体 ✅先别急钩子到底能帮你挡什么场景一AI 总是用最慢的搜索你让 Claude Code 在仓库里找某个函数它很配合地吐出grep -r xxx .。小项目无所谓几十万行的代码库里这条命令能跑半分钟。你纠正它一次下次它大概率还是这么写——AI 不会把你偏好 rg记成长期习惯除非流程里真有一道强制检查。钩子就是这道检查命令执行前先过你定的规则。场景二高危命令的最后一道闸另一类更烦人的情况AI 为了快速搞定偶尔会生成rm -rf或git push --force这类你根本不想要的命令。口头叮嘱没用把拦截规则写进钩子才有用——命令还没落地就被挡住AI 会收到你的提示并换一种写法。最短路径把第一个钩子挂上去钩子是什么一句大白话钩子Hook就是事件触发的脚本Claude Code 在特定时刻比如调用 Bash 工具前自动运行你指定的程序根据它的输出决定放行还是拦截。仓库的 examples/hooks/ 目录里有个现成样本我们直接拿它起步。钩子配置写在哪个文件全局生效写在~/.claude/settings.json只想在某个项目里生效就写到该项目根目录的.claude/settings.json。加上这段配置注意把路径换成你本地脚本的真实位置{ hooks: { PreToolUse: [ { matcher: Bash, hooks: [ { type: command, command: python3 /path/to/bash_command_validator_example.py } ] } ] } }matcher是触发条件填Bash表示只在 Bash 工具被调用时跑这个脚本command才是钩子实际执行的命令。最小可运行示例先不接 Claude Code用一行命令模拟它发给钩子的输入确认脚本本身能跑echo {tool_name: Bash, tool_input: {command: grep hello *.txt}} \ | python3 examples/hooks/bash_command_validator_example.py看到Use rg (ripgrep) instead of grep...且退出码为 2就说明链路通了。退出码程序结束时返回的状态数字是关键约定0放行1把报错信息只显示给你2直接拦下这次调用并把提示信息交给 Claude 参考。规则清单把命令偏好写进正则打开 bash_command_validator_example.py规则集中在一个列表里每条就是正则 提示语一对_VALIDATION_RULES [ ( r^grep\b(?!.*\|), Use rg (ripgrep) instead of grep for better performance and features, ), ]验证逻辑只有一层循环遍历列表re.search命中就把对应的提示语收起来。规则越多拦得越细。加一条你自己的规则比如你不希望 AI 写cat 文件 | grep 关键词这种管道就想让它直接rg。在列表里追加一行元组即可( rcat\s\S\s*\|\s*grep\b, Use rg pattern file directly instead of cat | grep, ),存盘就完事下一次会话里 AI 再写这条命令就会被拦下。只提醒还是硬拦截你说了算现在的写法是硬拦截exit 2。如果只想温和提醒、不阻止执行把脚本末尾改成打印提示后sys.exit(0)就行。至于自动把命令替换成 rg 再放行这类更强的玩法需要让钩子按官方输出协议返回修改后的tool_input示例脚本没实现留给你照着 README.md 提到的钩子文档自己试。钩子没触发先查这 3 处 ️1. 配置文件的 JSON 有没有写坏最常见的翻车原因多个逗号、少个引号整个 settings 文件解析失败钩子会静默失效。用下面这条命令校验报错会直接告诉你行号python3 -m json.tool ~/.claude/settings.json2. 脚本路径和退出码对不对command里写的是绝对路径clone 仓库后忘了改路径钩子就根本起不来。用前面那个echo ... | python3 ...命令单独试一次脚本能输出提示且退出码为 2脚本才算合格。3. matcher 和事件名核对一遍matcher填的是工具名Bash、Read、Edit事件名是PreToolUse这类都区分大小写填错一个字母就不触发。拿不准有没有被调度时在脚本开头加一句print(hook fired, filesys.stderr)跑一次会话就能看到痕迹。收尾从能跑到顺手到这里你已经走完一轮完整的场景 → 配置 → 自定义规则 → 排坑循环钩子把 AI 的命令习惯从默认值改成了你的标准。核心记住四件事——钩子监听工具调用、配置写在 settings.json、规则用正则表达、退出码决定放行还是拦截。想继续深入可以往这两个方向走。方向一命令跑完之后的 PostToolUsePreToolUse管的是执行前PostToolUse管执行后统计 AI 跑了哪些命令、记录耗时、对输出做二次检查。同一个配置文件里再加一个PostToolUse键结构完全一样。方向二把偏好固化成项目级配置个人习惯写全局团队规范写项目级。examples/settings/ 里放了几份现成的 settings 模板宽松版、严格版、Bash 沙箱版可以照着搭一套只在本仓库生效的规则再打包分享给同事复用。【免费下载链接】claude-codeClaude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考