rag系列文章目录

---

---

前言

不管是什么类型的大模型agent，比如写代码的等等，它会遇到一个问题，不稳定性。Claude Code hooks是用户自定义的 shell 命令，可在 Claude Code 生命周期的不同阶段执行。钩子能对 Claude Code 的行为进行确定性控制，确保特定操作始终发生，而非依赖大型语言模型自行选择是否运行。

---

一、hooks介绍

Claude Code Hooks 是一套基于生命周期事件的自动执行机制，允许开发者在 Claude Code 执行任务的关键节点，插入由系统强制执行的脚本或命令。

这些脚本不是“提示（Prompt）”，而是：

• 由操作系统执行
• 与模型概率无关
• 必然发生、不可跳过

可以把它理解为：

为 AI 编程代理提供的“工程级钩子（Hook）”。Claude Code 在执行一次任务时，会经历一系列确定的生命周期节点，例如：

• 用户 Prompt 提交时
• 工具调用之前 / 之后（如 shell、git、文件操作）
• 上下文压缩前
• 任务结束（Stop）

Hooks 就是绑定在这些节点上的自动行为。

一旦事件发生，Hook 对应的脚本就会被执行 —— 不取决于 AI 是否“理解”或“愿意”。

二、hooks使用场景

Hooks 的应用场景非常广泛，主要集中在自动化管理和质量守卫：

• 代码合规性守卫： 在 Claude 修改完代码后，自动运行 Prettier 或 ESLint，确保代码风格始终一致。
• 安全屏障： 使用 PreToolUse 钩子拦截敏感操作，例如禁止修改 .env 文件，或在 AI 执行危险的 rm 命令前进行人工确认。
• 上下文自动注入： 在任务开始前自动读取最新的 Jira 任务描述或项目文档，注入到 AI 的上下文。
• 自动测试回归： 在修改完代码后自动运行 pytest 或 npm test，如果测试失败，直接反馈给 AI 让其自动修复。
• 通知提醒： 任务完成或需要用户权限时，发送桌面通知或 Slack 消息。

这里重点说明一下权限，在数据库运维工具大模型写sql时，一般就会涉及权限问题，如果不设置hooks，就会导致异常的sql执行，导致损失。

三、案例

下面是一个真实可落地的实践案例，以 Java / Maven 项目为例。
🎯 实践目标

• 禁止在 main 分支改代码
• 自动格式化和静态检查
• 强制单元测试通过
• 出错时自动收集上下文

hooks工作流示意图

Claude 规划任务
   ↓
[Before Hook] 分支 & 安全检查
   ↓
Claude 修改代码
   ↓
[After Hook] 格式化 + 单测
   ↓
[On Error] 错误上下文收集

示例 Hook（简化）
before：检查分支

if [[ "$(git branch --show-current)" == "main" ]]; then
  echo "Not allowed to modify main branch"
  exit 1
fi

after：运行测试

mvn test

on_error：收集上下文

mkdir -p .claude/errors
git status > .claude/errors/context.txt
git diff >> .claude/errors/context.txt

实际效果

• Claude 无法违规执行
• 写出的代码 必须能通过测试
• 出错时不再“凭感觉分析”，而是基于真实上下文
• AI 行为被纳入工程流程管理

---

总结

Claude Code Hooks 并不是为了“限制 AI”，而是为了：让 AI 能够安全、稳定、可预期地进入工程体系。它代表了一种新的分工方式：AI 负责生成与推理，Hooks 负责约束与执行，工程系统负责质量与安全。
当 AI 不再被当成“灵感工具”，而是被当成“工程参与者”时，Claude Code Hooks 就成了不可或缺的基础设施。