1. 为什么 CLAUDE.md 写了规则，Claude Code 还是会执行 rm -rf
很多人第一次用 Claude Code 都会经历同一个瞬间：你在 CLAUDE.md 里郑重写下「禁止执行破坏性命令」「提交前必须跑测试」，结果某次对话里它照样给你来一句rm -rf ./dist && git push --force。不是它不听话，而是 CLAUDE.md 的本质是自然语言建议，模型理解、模型执行，中间隔着概率。它可能记住，也可能在长上下文里忘掉，更可能在「用户看起来很急」的时候自作主张。
Hooks 系统解决的就是这个概率问题。它是 Claude Code 在工具调用链路上预留的确定性拦截点：在 Bash、Write、Edit 这些工具真正执行之前或之后，插入一段你自己的脚本，用退出码决定放行还是阻断。CLAUDE.md 管「AI 怎么想」，Hooks 管「AI 能做什么」。前者是行为引导，后者是强制执行，两者配合才完整。
这篇聚焦 11 个生命周期事件里最常用的 PreToolUse、PostToolUse，以及退出码 0/2 的判定逻辑，把 CLAUDE.md 里的软约束翻译成可执行脚本。同时把 TaoToken 作为统一 API 通道接进这条调用链——官网入口 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 地址 https://taotoken.net/api 。适合已经在用 Claude Code、想让规则真正落地的开发者，也适合刚接触 Hooks、想搞清退出码到底怎么生效的新手。
2. 把 TaoToken 接进 Claude Code 的调用链
在写 Hook 之前，先把模型通道固定下来。Claude Code 默认走官方端点，但团队协作时经常需要统一 Key、统一计费、统一审计。TaoToken 提供的就是这样一个兼容 Anthropic 协议的入口，Claude Code 通过环境变量指向它即可，Hooks 脚本本身不需要感知通道差异。
2.1 环境变量与 settings.json 的接入位置
Claude Code 读取ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN两个变量。你可以在 shell 里 export，也可以写进~/.claude/settings.json的env字段，后者对 GUI 启动更稳。下面这段是可直接复制的配置，路径与字段名保持原样：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "sk-你的TaoToken密钥", "ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929" }, "hooks": { "PreToolUse": [ { "matcher": "Bash", "command": "node ~/.claude/hooks/block-dangerous.mjs", "description": "拦截危险 Bash 命令" } ] } }三件套要写全：Base URL 指向https://taotoken.net/api，Key 用你在控制台生成的令牌，Model ID 明确写死，避免 Claude Code 自动探测时回落到默认模型。Key 的生成入口在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，接入细节可对照 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。
2.2 为什么 Hook 脚本不碰网络层
一个常见误区是把鉴权逻辑塞进 Hook 脚本里。没必要。Hooks 的 stdin 拿到的是工具调用参数，它只负责判断「这个命令能不能跑」，网络请求由 Claude Code 主进程完成。这样分层的好处是：换通道只改 settings.json，换规则只改 Hook 脚本，互不干扰。如果你同时用 Codex 或 Cline，它们的auth.json、MCP 配置里同样填 Base URL + Key + Model ID 三件套，思路一致。
2.3 验证通道是否生效
配置完先别急着写复杂 Hook，用一次最简对话确认通道通了。启动 Claude Code 后输入一句「用一句话说明当前使用的模型」，观察返回。如果报 401，说明 Key 或 Base URL 有问题；如果报 model not found，说明 Model ID 写错了。这一步过了，再进入 Hook 实战。
3. PreToolUse 拦截危险命令的完整配置
PreToolUse 是使用频率最高的挂载点，在 Write、Edit、Bash 等工具执行前触发。它的核心能力是阻断：脚本退出码为 2 时，工具调用被拦截，stderr 内容展示给用户和模型。
3.1 从 stdin 读取工具输入
Claude Code 把工具参数以 JSON 形式通过 stdin 传给 Hook 脚本。Bash 工具的输入结构大致是{"tool_name":"Bash","tool_input":{"command":"..."}}。下面这个脚本拦截四类高危模式，可直接放到~/.claude/hooks/block-dangerous.mjs：
// ~/.claude/hooks/block-dangerous.mjs const chunks = []; process.stdin.on('data', c => chunks.push(c)); process.stdin.on('end', () => { let input = {}; try { input = JSON.parse(Buffer.concat(chunks).toString() || '{}'); } catch (e) { console.error('[Hook] 输入解析失败，默认放行'); process.exit(0); } const cmd = input.tool_input?.command || ''; const rules = [ { re: /rm\s+-rf\s+\/(?!\w)/, msg: 'rm -rf / 是毁灭性操作' }, { re: /git\s+push\s+--force.*origin\s+(main|master)/, msg: '禁止强推主分支' }, { re: />\s*\/etc\//, msg: '禁止覆盖 /etc 配置' }, { re: /curl[^|]*\|\s*(ba)?sh/, msg: '禁止管道执行远程脚本' } ]; for (const r of rules) { if (r.re.test(cmd)) { console.error(`[BLOCKED] ${r.msg}\n命令: ${cmd}`); process.exit(2); } } process.exit(0); });注意process.exit(2)之前必须把信息写进 stderr，stdout 在阻断场景下可能被丢弃。这是很多人第一次写 Hook 时踩的坑：脚本明明 exit 2 了，用户却看不到原因。
3.2 退出码 0 与 2 的语义边界
退出码只有三个档位需要记：0 放行，2 阻断，其他值视为非阻塞错误、记录 warning 后继续。这意味着你不能用 exit 1 来拦截，1 不会阻止操作。想要硬拦截，只有 2。这个设计有点反直觉，但一旦记住就不会错。
3.3 用 Prompt Hook 做软提醒
不是所有规则都值得写脚本。像「执行前确认不会修改 /etc」这种提醒性约束，用 Prompt Hook 更省事，它把一段提示注入模型上下文，不阻断但影响决策：
{ "hooks": { "PreToolUse": [ { "matcher": "Bash", "type": "prompt", "prompt": "执行此命令前，确认它不会修改 /etc 下任何文件。若会，先向用户确认。", "description": "Bash 安全提醒" } ] } }Command Hook 精确但成本高，Prompt Hook 便宜但依赖模型理解。安全红线用前者，风格提醒用后者。
4. PostToolUse 自动格式化与退出码验证
PostToolUse 在工具执行完成后触发，典型用途是自动格式化、类型检查、更新统计。它不能阻断已经发生的操作，但可以决定后续流程是否继续。
4.1 文件写入后自动 Prettier
{ "hooks": { "PostToolUse": [ { "matcher": "Write|Edit", "command": "npx prettier --write \"$CLAUDE_TOOL_INPUT_FILE\" 2>/dev/null || true", "description": "自动格式化刚写入的文件" } ] } }$CLAUDE_TOOL_INPUT_FILE是 Claude Code 注入的环境变量，指向本次操作的文件路径。末尾的|| true保证格式化失败不会把整个 Hook 判为错误。
4.2 提交前跑类型检查与测试
PreCommit 事件在 git commit 前触发，适合放质量门禁。下面这个 shell 脚本三段检查，任一失败就 exit 2：
#!/bin/bash set -e echo "[1/3] TypeScript 类型检查..." npx tsc --noEmit || { echo "类型检查失败" >&2; exit 2; } echo "[2/3] ESLint..." npx eslint . --max-warnings 0 || { echo "ESLint 未通过" >&2; exit 2; } echo "[3/3] 测试..." npm test || { echo "测试未通过" >&2; exit 2; } echo "全部通过"对应配置：
{ "hooks": { "PreCommit": [ { "command": "bash .claude/hooks/pre-commit-check.sh", "description": "提交前类型检查、Lint、测试" } ] } }4.3 一次完整的阻断与放行验证
想确认退出码真的生效，做一次对照实验。先故意让 Claude Code 执行rm -rf /tmp/test-hook，观察是否被拦。如果被拦，stderr 会显示[BLOCKED] rm -rf / 是毁灭性操作，工具调用中止。再把规则里的正则改宽一点，让它不匹配，重新执行，命令正常跑完。两次结果对比，就能确认 Hook 挂载点和退出码都在工作。调试时用claude --debug能看到每次 Hook 的输入输出，claude --doctor hooks可以检查配置语法。
5. 常见报错排查：401、local proxy failed 与 reading choices
Hook 写完后最常见的失败不是脚本逻辑，而是通道和配置。下面按真实报错逐条对照。
401 Unauthorized：Key 无效或没带上。检查ANTHROPIC_AUTH_TOKEN是否写进了 settings.json 的 env，而不是只 export 在某个终端。GUI 启动的 Claude Code 读不到你 shell 里的临时变量。重新在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 生成一个 Key，粘贴时注意别带空格。
local proxy failed / connection refused：Base URL 写错或网络不通。确认是https://taotoken.net/api，不要多加/v1或结尾斜杠。如果公司网络有出口限制，联系网络管理员放行，不要自行搭代理。
Error reading choices / unexpected response shape：通常是 Model ID 写错，或者通道返回了非预期格式。把ANTHROPIC_MODEL改成明确的模型标识，别留空让 Claude Code 自动探测。三件套 Base URL、Key、Model ID 缺一不可。
Hook 脚本没执行：先chmod +x给脚本执行权限，Windows 下用bash script.sh而不是./script.sh。再看 matcher 是否匹配工具名，Bash和bash大小写敏感。
stdin 读取超时：Node 脚本如果只监听 data 不监听 end，会一直等。加一个 5 秒超时兜底，超时后 exit 0 放行，避免卡死整个会话。
PostToolUse 在工具失败时也触发：脚本里判断input.tool_output?.error，有错误就跳过格式化，否则会对一个不存在的文件跑 prettier。
6. 把规则沉淀成可复用的 Hook 集合
Hooks 真正的价值不在单条规则，而在把团队约定固化成脚本库。我的做法是在项目根目录建.claude/hooks/，按用途分文件：block-dangerous.mjs管安全，format-on-write.sh管格式，pre-commit-check.sh管质量门禁。settings.json 只做挂载，逻辑全在脚本里，改规则不动配置。
CLAUDE.md 继续写风格偏好、命名约定、技术选型这些「建议性」内容，Hooks 只承接「必须执行」的红线。两者边界清晰，维护成本才低。通道侧统一走 TaoToken，Base URL 和 Key 集中在 settings.json 的 env 里，换环境只改一处。需要长期跑编码 Agent 的话，Coding Plan 的入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，模型对话验证在 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。
最后留一个实操建议：每加一条 Hook，先用claude --debug跑一次触发场景，确认退出码和 stderr 都符合预期，再提交到团队仓库。Hook 是确定性工具，配错了比不配更危险——它会让 AI 在关键时刻被无声卡住，而你以为是模型变笨了。
