怎么说呢，

去年我们在用 Claude Code 跑内部基建的时候。经常遇到这样一个窒息场景：AI 哐哐一顿输出，看着挺像那么回事，结果 CI/CD 一跑直接炸了。为了这事，团队没少在审查 AI 写的烂代码上掉头发。

那时候我们才意识到，光写 Commands 和 Skills 不够——它们只是告诉 AI "你可以做什么"。如果想强制告诉它"这件事不准做"。或者"代码测试没通过不准停下来继续改"，你最需要的其实是 Hooks。说起来，

本质上。Hook 就是 AI 时代的中间件，负责拦截和提高每一次大模型与本地环境的交互。

至于钩从何来，AI 的动作在哪能被拦截？

当我们和 Claude Code 对话时就是一条"发起请求 -> 内部执行 -> 收尾"的流水线。在这个过程中，官方提供了大大小小几十个事件可以挂载 Hook。

具体可以看看官方白皮书。实战中，我们大体只围绕三个主要层级做埋点：

. 抓执行源头

这类事件通常用来做前置的环境准备或者准入检查。

• SessionStart: 新会话刚起来时加载环境变量、初始化状态等操作
• UserPromptSubmit: 使用者输入提交前拦截敏感词、格式校验等安全检查

  
  {
  "hooks": {
  "UserPromptSubmit":
  }
  }
  

• 痛点: 开发团队每次提交代码都要手动检查风险操作,效率低下且容易遗漏危险指令

. 抓执行过程

AI 在干活时会高频调用工具。这是最容易产生破坏乱动的地方:

• PreToolUse: 真正执行前闸门,决定放行还是人工审批

  
  {
  "hooks": {
  "PreToolUse":
  }
  }
  

• 痛点: AI随意调用rm -rf、删除数据库等高风险操作导致多次生产事故
• 方法:
  • 对所有文件程序操作加PreToolUse校验
  • 要求管理员权限操作必须二次确认
  • /etc目录完全禁止修改权限

    
    # check-risky-operations.sh示例:
    if ];n
    echo '{"decision":"block","reason":"禁止修改程序关键目录"}'
    fi
    

• PostToolUse/PostToolUseFailure: 操作后观察点。适合行为审计和日志记录:

  再看{hooks，{PostToolUseFailure: }}
  "没有Hook之前,每天至少花1小时分析AI失败日志;现在全部自动化记录"

. 抓收尾环节

• /SubagentStop>: 质量门禁黄金时机!其实，

怎么拦？四种武器大比拼

从简单粗暴来看。Command类型

•  The Good: 本地Shell/Node命令直接触发,性能最高; 其实，支持timeout控制超时处理;话说回来，. : ESLint检查hook:

  至于{hooks。{Stop:}]}

:默认超时仅1秒!跑测试记得拉长timeout参数值.;:通过stderr输出调试信息: `echo 'Hook triggered at $'>> .debug/hook.log` ;mermaid graph LR;A-->B，B-->C;C-.no.-->D，C-.yes.-->E;

AI魔法打败魔法: Prompt类型

:当传统正则难以捕捉业务语义错误时,将判断外包给LLM更有效. ;• 查重复代码片段 • 检测架构违规 • 提取关键设计思路;
:过度依赖Prompt校验可能引发自我循环问题!• 建议设置最大迭代次数 • 添加人工终止机制 • 配合硬性Command校验使用;请严格按照以下规范评分此段${LANGUAGE}代码: 1. 命名规范满分10分 2. 函数粒度满分5分 ...`,timeout:60}}};

{hooks这方面。{Stop:}]}}}

再看{hooks，{SubagentStop:}]}}

Agent类型 - 引入子探员协同工作;:创建专注任务子Agent处理复杂判断需求.;

:高风险操作二次确认流程:;• PreToolUse触发 → 拉起安全审计Agent → 查全库相关文档 → 决定放行或阻止;:对Token消耗影响显著!测试阶段务必监控token_usage指标. *Pro Tip:* 对Agent钩子启用cacheTTL可降低重复请求Token消耗;bash # 安全审计Agent示例: claude agent start --config security-auditor.yaml --parent-session ${PARENT_SESSION_ID};

yaml安全审itor.yaml内容片段:

至于name，safety-checker description:'专注于安全政策评估' tools:- name:'grep-history' description:'在历史提交中搜索相似模式' ...

---