你有没有发现，现在这个AI工具多得跟雨后春笋一样，但真正Neng用得顺手的，还真不多。不过今天咱要聊的这个Claude Code，它Zui近搞了个大动作，就是那个叫Hooks系统的玩意儿。

说实话，这玩意儿刚出来的时候我也没太在意，觉得不就是个插件系统嘛，Neng有啥？结果一试，好家伙，这东西简直是个宝藏。你懂的，它不是那种花里胡哨的装饰，而是Neng让你把一堆重复操作给自动化掉，比如权限控制、代码格式化、安全检查这些，全douNeng用它来搞定。

那这Hooks系统到底Neng不Neng应对复杂项目？咱就是说它还真行。你想想，你写个代码，它Neng自动帮你检查是不是安全，是不是符合规范，是不是该提交了。这不比你手动去点“提交”、“检查”、“格式化”快多了？

害，你可Neng要问了这玩意儿到底靠不靠谱？我跟你说它还真挺靠谱的。你kankan，它Neng让你在关键节点上Zuo各种拦截，比如你写了个危险命令，它Neng直接给你拦住不让你执行。或者你改了某个文件，它Neng自动帮你格式化，还Neng记录日志，甚至还Neng帮你自动提交代码。这不就是个自动化的管家婆嘛，哈哈。

你可Neng觉得这东西就是个摆设，但你真用起来它Neng帮你把一堆重复操作给自动化掉。比如你写个脚本，它Neng自动帮你检查是不是安全，是不是符合规范，是不是该提交了。这不比你手动去点“提交”、“检查”、“格式化”快多了？

对了咱再聊聊它怎么用。你得先在配置文件里写好你的Hook规则，比如你写了个脚本，它Neng自动帮你检查是不是安全，是不是符合规范，是不是该提交了。这不比你手动去点“提交”、“检查”、“格式化”快多了？

你可Neng会说哎呀，这不就是个脚本工具嘛。但你真用起来它Neng让你把一堆重复操作给自动化掉。比如你写个代码，它Neng自动帮你检查是不是安全，是不是符合规范，是不是该提交了。这不比你手动去点“提交”、“检查”、“格式化”快多了？

那你说这玩意儿到底靠不靠谱？我跟你说它还真挺靠谱的。你kankan，它Neng让你在关键节点上Zuo各种拦截，比如你写了个危险命令，它Neng直接给你拦住不让你执行。或者你改了某个文件，它Neng自动帮你格式化，还Neng记录日志，甚至还Neng帮你自动提交代码。这不就是个自动化的管家婆嘛，哈哈。

Hook执行顺序

对于有多个匹配器的特定事件：

{ hooks :{ Notification :}]}}. Hooks 是 Claude Code 里hen容易被忽略的一层,但真用起来,它Neng帮你把通知、格式化、权限确认、文件保护这些重复动作收进固定流程里。这篇就从官方文档和社区经验出发,讲清楚 Claude C Claude Code Hooks 该怎么用,用好了,事半功倍 我一开始没太注意...

Hook执行顺序

对于有多个匹配器的特定事件：

{ hooks :{ Notification :}]}}.

Hook响应协议

Hooks 通过 stdout JSON 与 Claude Code 通信。

{ "type": "prompt", "prompt": "检查这个 bash 命令是否安全：$ARGUMENTS。以 JSON 格式回复：{\"decision\": \"allow\" 或 \"block\", \"reason\": \"...\"}", "model": "claude-haiku---", "timeout": , "statusMessage": "检查安全性...", "if": "Bash"}

提示词 Hook 的输出被解析为 JSON，并作为同步 Hook 响应处理。适用于正则表达式无法处理的语义/上下文感知决策。

PreToolUse Hook 特殊Neng力：

匹配器内的单个 Hook Ke以添加 if 条件进行geng精细的控制：

配套建议:把脚本也放进仓库,例如{project}/.claude/hooks/*.sh,让团队开箱即用.Hooks 的价值就在于:把这些动作从 你记得Zuo 变成 系统自动Zuo ,并且Ke以Zuo到 该阻断就阻断、该后台跑就后台跑、该提醒就提醒 。

{ "hooks": { "PreToolUse": } ], "PostToolUse": } ] }}

配置文件位置与作用域：

geng讽刺的地方在于,代码里有一个叫 Undercover Mode 的子系统,专门用来防止 Anthropic 内部代号出现在 git commit 里,避免信息泄露.生产系统还要知道失败的时候怎么止损。.

运行完整的 Claude Agent 来验证或处理 Hook 上下文。比提示词 Hook geng重量级，但支持多步推理和工具调用。

{ "hookSpecificOutput": { "hookEventName": "PermissionRequest", "decision": { "behavior": "allow" } }} 用户交互

事件

用户发送消息prompt

NotificationClaude 发送桌面通知message, title, notification_type

ElicitationMCP 服务器请求用户输入mcp_server_name, message, mode, requested_schema

ElicitationResult用户响应 MCP 请求mcp_server_name, action, content

UserPromptSubmit Hook Neng力： 可向模型注入 additionalContext，或提供 initialUserMessage 覆盖。

所有工具输入也以 JSON 格式通过 stdin 传入。

{ "type": "command", "command": "python3 ~/.claude/hooks/audit.py", "shell": "bash", "timeout": , "statusMessage": "审计中...", "async": false, "asyncRewake": false, "once": false, "if": "Bash"}

关键字段说明：

每个事件的 Hook 列表包含匹配器——用于决定何时触发的过滤器：

也Ke以在交互模式中用/hooks命令可视化编辑。.~/.claude/settings.json——全局.Claude Code 通关手册:Cursor 用户转 Claude Code,第一天我就后悔了——后悔没早点用Claude Code 通关手册:....

{ "type": "agent", "prompt": "验证变geng文件的单元测试是否Yi运行并通过：$ARGUMENTS", "model": "claude-sonnet--", "timeout": , "statusMessage": "验证测试中..."}

默认模型为 Haiku，以控制成本。

将 Hook 输入 JSON 以 POST 请求发送到外部端点。

PermissionRequest Hook 特殊Neng力： 可在不询问用户的情况下自动批准或拒绝：

FileChanged 配置方法： 在 SessionStart 或 CwdChanged Hook 的输出中注册监听路径：

{ "matcher": "Bash", "hooks": }

Hook 响应协议

Hooks 通过 stdout JSON 与 Claude Code 通信。

{ "hookEventName": "PermissionRequest", "decision": { "behavior": "allow", "updatedInput": { "command": "Yi审计的命令" } }}

PermissionDenied — 重试其他方案：

{ "type": "http", "url": "https://my-audit-service.internal/claude-hooks", "headers": { "Authorization": "Bearer $MY_API_TOKEN" }, "allowedEnvVars": , "timeout": , "statusMessage": "通知审计服务..."}

安全说明： allowedEnvVars 控制哪些环境变量Ke以在 headers 中被插值。未列出的变量将被替换为空字符串。

供应商的营销策略鼓励开发者将AI插入每个流程与可Neng导致AI工具停止响应的配额系统之间也存在脱节。.Anthropic公司Yi经承认了这一问题,表示 用户触及Claude Code使用限额的速度远超我们的预期。我们正在积极调查中. 一位购买了Claude Pro订阅服务的用户在公司Discord论坛上反映: 每个星期一就达到上限,星期六才重置,这种...

{ "PreToolUse": }, { "matcher": "Write", ← 只在写入 src/ 目录时触发 "hooks": }, { "matcher": "", ← 所有工具dou触发 "hooks": } ]}

匹配器语法与权限规则语法一致：

{ "async": true, "asyncTimeout": }}

Hook 进程继续运行。若以退出码 退出，模型会被唤醒并收到错误信息。

{ "continue": true, "suppressOutput": false, "stopReason": "", "decision": "approve", "reason": "操作安全", "systemMessage": "警告：检测到破坏性操作", "hookSpecificOutput": { "hookEventName": "PreToolUse", "permissionDecision": "allow", "updatedInput": { "command": "safe-version-of-command" }, "additionalContext": "注入模型的额外上下文" }} 异步响应

用于不需要阻塞的长时间运行 Hook：

使用轻量 Claude 模型评估一段自然语言提示。提示词通过 $ARGUMENTS 接收 Hook 输入 JSON。

配置写在~/.claude/settings.json或.claude/settings.json里。.你以为 Claude Code 是工具,其实配好 Hooks 之后,它是一个有记忆、有反应、会自动收尾的系统。

---