1. 为什么你的 Claude Code 需要一个“刹车片”Claude Code 是 Anthropic 推出的终端级编码代理能直接读写文件、执行 Bash、跑测试、提交 Git。它适合谁适合已经在用 AI 写业务代码、但被“AI 自作主张”坑过的开发者。它能做什么一句话把自然语言需求变成真实的文件改动和命令执行。问题也恰恰出在这里——它太能干了。我见过最惊险的一次是同事让 Claude Code 帮忙清理测试数据它生成了一条不带 WHERE 的 DELETE然后非常自信地执行了。幸好那是本地库。从那以后我明白一件事Claude Code 的 Hooks 不是锦上添花而是生产环境的刹车片。Hooks 允许你在工具调用前后插入自己的校验脚本PreTool 在命令执行前拦截PostTool 在文件写入后处理。配置全部落在settings.json里项目级放.claude/settings.json全局级放~/.claude/settings.json。这篇不讲概念直接给你 6 个能抄进项目的生产级配置骨架每个都配验证动作。你照着改路径和命令就能跑。2. 前置准备TaoToken 接入与 settings.json 位置Claude Code 要跑起来得先有可用的模型接入。我这边习惯用 TaoToken 做统一入口官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。它的作用是给你一个兼容 Anthropic 协议的端点Claude Code 通过环境变量指过去即可不用改客户端代码。先拿 Key打开 https://taotoken.net/api-keys 创建一个 API Key复制保存。然后配置环境变量Linux/macOS 写进~/.zshrc或~/.bashrcexport ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密钥Windows PowerShell 用$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_API_KEYsk-你的TaoToken密钥验证接入是否通直接跑一次模型对话最直观打开 https://taotoken.net/model-chat 发一句“你好”能正常返回就说明 Key 和端点没问题。如果你打算长期用 Claude Code 做重构或 Agent 任务可以看下 Coding Plan https://taotoken.net/coding-plan 按量或包月自己权衡。接入通了再确认settings.json的位置。Claude Code 读取顺序是项目级优先于全局级项目级路径是项目根/.claude/settings.json全局级是~/.claude/settings.json。Hooks 配置写在顶层hooks字段下结构是hooks.PreTool和hooks.PostTool每个下面有command、events、script三个关键字段。events指定监听哪些工具常见的有Bash、Write、Edit。脚本从 stdin 读 JSON用jq解析字段退出码非 0 就会阻断本次工具调用。注意脚本里用到的jq要提前装好Ubuntu 是sudo apt install jqmacOS 是brew install jq。没有 jq 的话解析会失败Hook 直接报错。3. 六个生产级 Hooks 配置骨架下面 6 个场景每个都给你完整的settings.json片段和脚本内容。建议先全部放进项目级配置跑通后再按需精简。3.1 场景一拦截高危 SQL 与 rm -rf这是保命配置。PreTool 监听 Bash在命令执行前用正则匹配危险模式。注意正则要忽略大小写AI 经常输出drop table小写形式。{ hooks: { PreTool: { command: bash, events: [Bash], script: #!/bin/bash\nINPUT$(cat)\nCMD$(echo \$INPUT\ | jq -r .command)\nif echo \$CMD\ | grep -qiE (DROP[[:space:]]TABLE|rm[[:space:]]-rf|DELETE[[:space:]]FROM[[:space:]][a-zA-Z_][[:space:]]*;?[[:space:]]*$); then\n echo \拦截到高危指令已阻断$CMD\ 2\n exit 1\nfi\nexit 0 } } }验证动作让 Claude Code 执行echo DROP TABLE users;观察它是否被阻断并返回错误。如果没阻断检查jq是否安装、正则是否被 shell 转义破坏。3.2 场景二提交前密钥扫描AI 写配置时极易硬编码 Token。PreTool 监听 Bash当命令包含git commit时扫描暂存区文件里是否有sk-开头的密钥或password明文。{ hooks: { PreTool: { command: bash, events: [Bash], script: #!/bin/bash\nINPUT$(cat)\nCMD$(echo \$INPUT\ | jq -r .command)\nif echo \$CMD\ | grep -q git commit; then\n if git diff --cached | grep -qiE (sk-[a-zA-Z0-9]{20,}|password[[:space:]]*[[:space:]]*[\\\]) ; then\n echo \暂存区检测到疑似密钥或明文密码提交已阻断。\ 2\n exit 1\n fi\nfi\nexit 0 } } }验证动作在项目里新建一个文件写入api_key sk-1234567890abcdefghijgit add后让 Claude Code 执行git commit -m test应当被拦截。3.3 场景三写入后自动 Lint 格式化PostTool 监听 Write 和 Edit文件落盘后立刻跑对应格式化命令。Java 走mvn spotless:applyTS 走eslint --fix。注意格式化要快否则拖慢交互。{ hooks: { PostTool: { command: bash, events: [Write, Edit], script: #!/bin/bash\nINPUT$(cat)\nFILE$(echo \$INPUT\ | jq -r .arguments.file_path // empty)\n[ -z \$FILE\ ] exit 0\ncase \$FILE\ in\n *.java) mvn spotless:apply -q /dev/null 21 ;;\n *.ts|*.tsx) npx eslint --fix \$FILE\ --quiet /dev/null 21 ;;\nesac\nexit 0 } } }验证动作让 Claude Code 写一个格式混乱的.ts文件保存后检查文件是否被自动修正。3.4 场景四依赖变更审计日志企业项目要求合规AI 每次改pom.xml或package.json都要留痕。PostTool 监听 Write命中依赖文件就追加日志。{ hooks: { PostTool: { command: bash, events: [Write], script: #!/bin/bash\nINPUT$(cat)\nFILE$(echo \$INPUT\ | jq -r .arguments.file_path // empty)\nBASE$(basename \$FILE\)\nif [ \$BASE\ \pom.xml\ ] || [ \$BASE\ \package.json\ ]; then\n LOG/var/log/claude_code_audit.log\n echo \[$(date %F %T)] AI 修改了 $FILE\ \$LOG\\n git diff \$FILE\ \$LOG\ 2/dev/null\nfi\nexit 0 } } }验证动作让 Claude Code 往package.json加一个依赖然后tail -20 /var/log/claude_code_audit.log看是否有记录。日志目录没权限就换成项目内.claude/audit.log。3.5 场景五禁止直推主干PreTool 监听 Bash匹配git push且目标含main或master时阻断强制走 MR 流程。{ hooks: { PreTool: { command: bash, events: [Bash], script: #!/bin/bash\nINPUT$(cat)\nCMD$(echo \$INPUT\ | jq -r .command)\nif echo \$CMD\ | grep -qE git[[:space:]]push echo \$CMD\ | grep -qE (main|master); then\n echo \禁止直接推送到主干请走 MR 流程。\ 2\n exit 1\nfi\nexit 0 } } }验证动作让 Claude Code 执行git push origin main应当被阻断并提示走 MR。3.6 场景六幻觉与连续报错监控AI 长时间重构时容易反复引用不存在的方法。PostTool 监听 Bash统计最近输出里File not found或编译错误次数超过阈值就写告警文件。这里用计数文件实现。{ hooks: { PostTool: { command: bash, events: [Bash], script: #!/bin/bash\nINPUT$(cat)\nOUT$(echo \$INPUT\ | jq -r .output // empty)\nCNT_FILE/tmp/claude_err_cnt\n[ -f \$CNT_FILE\ ] || echo 0 \$CNT_FILE\\nCNT$(cat \$CNT_FILE\)\nif echo \$OUT\ | grep -qiE (File not found|error:|cannot find symbol); then\n CNT$((CNT1))\n echo \$CNT\ \$CNT_FILE\\n if [ \$CNT\ -ge 3 ]; then\n echo \[$(date)] 连续报错超过3次疑似幻觉请人工介入\ /tmp/claude_alert.log\n echo 0 \$CNT_FILE\\n fi\nelse\n echo 0 \$CNT_FILE\\nfi\nexit 0 } } }验证动作连续让 Claude Code 执行三次会报File not found的命令检查/tmp/claude_alert.log是否生成告警。4. 验证 Hooks 是否真正生效配置写完不代表生效。Claude Code 启动时读取settings.json如果 JSON 语法错误会静默忽略整个 hooks 字段。所以第一步是校验 JSONjq . .claude/settings.json能正常输出格式化 JSON 才算合法。第二步单独测脚本。把 script 内容存成hook.sh手动喂 JSONecho {command:DROP TABLE users;} | bash hook.sh; echo exit$?期望输出exit1和拦截提示。第三步回到 Claude Code 里触发真实调用观察终端是否出现阻断信息。如果脚本手动能跑但 Claude Code 里不生效八成是events名字写错Bash 工具的事件名就是BashWrite 就是Write大小写敏感。提示调试阶段可以在脚本里加echo $INPUT /tmp/hook_debug.log把每次输入落盘确认字段名到底是.command还是.arguments.command。不同版本字段结构可能有差异以实际日志为准。5. 本篇常见错排查报错一jq: command not found。Hook 脚本依赖 jq 解析 stdin没装就整条链路失败。装完记得重启终端让 PATH 生效。报错二Hook 不触发。先确认settings.json放在正确位置项目级是.claude/settings.json不是.claude/settings.local.json。再确认events数组里的工具名拼写正确。最后看 Claude Code 启动日志有没有 JSON 解析警告。报错三脚本阻断太狠正常命令也被拦。正则写太宽。比如rm -rf匹配到了rm -rf ./node_modules这种正常清理。建议把危险模式收窄或者加白名单路径判断。报错四PostTool 格式化拖慢响应。全量mvn spotless:apply在大项目上要几十秒。改成只格式化当前文件或者用更轻的prettier --write。报错五日志文件没权限。/var/log普通用户写不进去换成项目内路径或~/.claude/logs/。报错六多个 Hook 冲突。同一个事件配了多个 PreTool执行顺序不保证。建议合并成一个脚本内部按顺序判断避免互相覆盖。6. 把 Hooks 接进你的日常编码流最小权限原则先落地场景一和场景五这两个 PreTool 拦截脚本优先上先保底再谈效率。格式化类 PostTool 放第二位但一定用轻量命令别让 AI 等你跑全量构建。审计日志单独打文件别和人工提交混在一个 Git Log 里否则回溯时根本分不清哪次是 AI 干的。如果你还没配好模型接入先去 https://taotoken.net/api-keys 拿 Key接入文档在 https://taotoken.net/doc 里面有 Claude Code 的完整环境变量说明。长期跑重构或 Agent 任务的话Coding Plan 在 https://taotoken.net/coding-plan 控制台在 https://taotoken.net/console 。Claude Code 的 Anthropic 兼容接入细节可以看 https://taotoken.net/claude-code-anthropic 。Hooks 这东西配一次省心很久。我现在的习惯是每个新项目初始化时就把这 6 个骨架拷进.claude/settings.json改改路径就能用。真正跑起来之后你会发现 AI 编码从“提心吊胆”变成了“可控自动化”。