Claude Code CLI Hooks：让你的代码工具链活起来的革命性更新

你是否曾觉得AI工具调用就像在黑暗中摸索？每次想让代码自动执行特定操作时，都得手动操作？现在，Claude Code CLI的Hooks功能将彻底改变这一切！想象一下，你的代码工具不再是孤立的个体，而是能像智能机器人一样协同工作，自动响应各种事件——这就是Hooks带来的魔法。

一、什么是Claude Code CLI Hooks？

简单来说，Hooks就像是代码工具的"触发器"和"助手"。当你使用Claude Code CLI时，系统会在不同阶段（比如调用工具前、工具执行后、用户输入时等）触发特定事件，而Hooks就是你用来响应这些事件的"钩子"。

举个生活例子：当你在餐厅点餐（Claude处理请求），服务员会在你点完菜（触发事件）后自动通知厨房（执行命令），这就像Hooks在代码中的运作。

核心配置方式

Claude Code CLI的Hooks配置非常灵活，支持三种层级：

1. 全局用户配置（~/.claude/settings.json）：适用于所有项目
2. 项目级配置（.claude/settings.json）：仅作用于特定项目
3. 本地项目配置（.claude/settings.local.json）：作用于本地项目（会被Git忽略）

小提示：就像不同房间的开关控制不同区域一样，这三种配置也能灵活控制你的代码工具链。

二、Hooks格式与事件解析

基础格式

Hooks的配置采用JSON格式，结构如下：

{
  "hooks": {
    "EventName": [
      {
        "matcher": "ToolPattern",
        "hooks": [
          {
            "type": "command",
            "command": "your-command-here",
            "timeout": 100
          }
        ]
      }
    ]
  }
}

• matcher：匹配工具名称的模式，区分大小写
• hooks：符合条件时执行的命令列表
• type：目前只支持command类型
• command：要执行的Shell命令
• timeout：命令超时时间（秒）

关键事件与匹配器对照表

事件名称	常见匹配器	功能描述
PreToolUse	Bash、Write、Read等	工具调用前执行
PostToolUse	Edit、MultiEdit、Write等	工具调用后执行
UserPromptSubmit	无（直接触发）	用户提交提示词时
Notification	无	系统发送通知时
Stop	无	Claude完成响应时
SessionStart	startup、resume、clear	会话开始时
SessionEnd	logout、prompt_input_exit	会话结束时

比喻：这些事件就像代码世界的红绿灯：PreToolUse是红灯（检查是否允许），PostToolUse是绿灯（完成后执行后续操作），而UserPromptSubmit则是行人过马路（接受新指令）。

三、实战教程：从入门到精通

1. 基础使用：记录Shell命令

场景：自动记录所有Bash命令

在settings.local.json中添加：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '\"<inline_LaTeX_Formula>.tool_input.command) - <\inline_LaTeX_Formula>.tool_input.description // \"No description\")\"' >> ~/.claude/bash-command-log.txt",
            "timeout": 100
          }
        ]
      }
    ]
  }
}

效果：每次使用Bash工具时，命令和描述都会被自动记录到日志文件中。就像有个秘书在偷偷帮你记笔记！

2. 进阶技巧：代码自动格式化

场景：编辑TypeScript文件后自动格式化

在settings.local.json中添加：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|MultiEdit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | { read file_path; if echo \"$file_path\" | grep -q '\\.ts$'; then npx prettier --write \"$file_path\"; fi; }",
            "timeout": 200
          }
        ]
      }
    ]
  }
}

效果：AI编辑完代码后，你的代码会像被格式化仪自动整理一样整齐，就像你的代码有了私人美容师。

3. 创意应用：触发系统通知

场景：提交提示词时收到系统提醒

在settings.local.json中添加：

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Awaiting your input\" with title \"Claude Code\" sound name \"default\"'",
            "timeout": 10
          }
        ]
      }
    ]
  }
}

效果：每次输入提示词后，Mac系统都会弹出可爱的通知，就像有人在提醒你：“嘿，AI正在工作哦！”

4. 安全防护：敏感内容拦截

场景：自动检查并阻止敏感信息泄露

创建sensitive_prompt.py：

import json
import sys
import re

# 从标准输入读取输入数据
input_data = json.load(sys.stdin)
prompt = input_data.get("prompt", "")

# 敏感词检测
sensitive_patterns = [
    (r"(?i)\b(password|secret|key|token)\s*[:=]", "提示词包含敏感信息，请重新措辞")
]

for pattern, message in sensitive_patterns:
    if re.search(pattern, prompt):
        output = {
            "decision": "block",
            "reason": message
        }
        print(json.dumps(output))
        sys.exit(0)

# 允许正常流程
sys.exit(0)

配置：在settings.local.json中添加：

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "python $CLAUDE_PROJECT_DIR/.claude/hooks/sensitive_prompt.py",
            "timeout": 10
          }
        ]
      }
    ]
  }
}

效果：AI再也不会不小心处理密码或密钥了，就像给代码加了个隐形的安全门。

四、高级应用：Hooks+Subagent+自动化工作流

Claude Code CLI的Hooks不仅能实现简单功能，还能与Subagent结合，打造强大的自动化工作流。例如：

• 文件自动分类：当检测到图片文件时自动分类到images目录
• 多语言支持：自动将不同语言的代码片段转换为统一格式
• 跨工具协作：从代码生成到部署的全流程自动化

思考：未来是否可以用Hooks实现"代码自动测试-修复-提交"的闭环？这简直就是开发界的"哆啦A梦口袋"！

五、为什么Hooks是Claude Code CLI的革命性更新？

想象一下，没有Hooks的代码工具链就像没有插件的浏览器——功能有限且不够灵活。而Hooks就像给每个工具都安装了"扩展接口"，让它们能互相通信、自动协作。这种架构不仅大幅提升了开发效率，还让复杂的任务变得简单可复用。

打个比方：以前你得手动指挥每个工具，现在你只需要设置规则，它们就会自动按流程工作，就像你拥有了一支24小时待命的代码机器人军团！

六、常见问题与解决方法

Q1：Hooks配置不生效怎么办？

• A：检查配置文件路径是否正确，或使用Ctrl+R查看详细调用日志。

Q2：如何处理复杂的Shell命令？

• A：可以将复杂逻辑拆分为多个小脚本，再通过Hooks依次调用。

Q3：能否在Windows/Linux上使用相同配置？

• A：需要注意不同系统的命令差异（如macOS用osascript，Linux用notify-send）。

结语

Claude Code CLI的Hooks功能就像给代码工具装上了"智能神经系统"，让它们能感知环境、响应事件、自动协作。从简单的日志记录到复杂的多工具工作流，Hooks正在重新定义AI代码工具的使用方式。

当你熟练掌握Hooks后，你会发现代码开发不再是孤立的操作，而是一系列流畅的自动化流程。就像把散落的乐高积木用胶水粘成一个完整的机器人，每个Hooks都是其中一块关键组件！

现在就动手试试吧——让你的代码工具链活起来的第一步，就是创建第一个Hooks规则！

补充资料与工具

《AI编程从开发到变现小白入门》手册
https://drgphlxsfa.feishu.cn/wiki/LK9pwfT7piXZuhkMHE0cokT3nXd

VicroCode，AI编程时代的代码部署交易平台。支持代码快速在线部署与发布，无需复杂配置，一键上线应用。同时搭建代码交易生态，让开发者的优质代码直接转化为收益，助力个人与企业高效实现技术价值，让每一段代码都能创造商业与实用价值。

网址：https://www.vicoco.cn