Hook 钩子创建器

创建在特定生命周期事件中执行 shell 命令的 Claude Code 钩子。

钩子创建工作流程

1. 确定使用场景 - 明确钩子需要完成的功能
2. 选择合适的事件 - 从可用的钩子事件中选择（参见 references/hook-events.md）
3. 设计钩子命令 - 编写从 stdin 处理 JSON 输入的 shell 命令
4. 配置匹配器 - 设置工具/事件过滤器（使用

   *

   匹配所有，或指定工具名称如

   Bash

   、

   Edit|Write

   ）
5. 选择存储位置 - 用户设置（

   ~/.claude/settings.json

   ）或项目（

   .claude/settings.json

   ）
6. 测试钩子 - 使用简单测试用例验证行为

钩子配置结构

{
  "hooks": {
    "<事件名称>": [
      {
        "matcher": "<工具模式>",
        "hooks": [
          {
            "type": "command",
            "command": "<shell命令>"
          }
        ]
      }
    ]
  }
}

常用模式

读取输入数据

钩子通过 stdin 接收 JSON。使用

jq

提取字段：

# 提取工具输入字段
jq -r '.tool_input.file_path'

# 带默认值的提取
jq -r '.tool_input.description // "无描述"'

# 条件处理
jq -r 'if .tool_input.file_path then .tool_input.file_path else empty end'

PreToolUse 的退出代码

• 0

  - 允许工具继续执行

• 2

  - 阻止工具并向 Claude 提供反馈

匹配器模式

• *

  - 匹配所有工具

• Bash

  - 仅匹配 Bash 工具

• Edit|Write

  - 匹配 Edit 或 Write 工具

• Read

  - 匹配 Read 工具

快速示例

记录所有 bash 命令：

jq -r '"\(.tool_input.command)"' >> ~/.claude/bash-log.txt

编辑后自动格式化 TypeScript：

jq -r '.tool_input.file_path' | { read f; [[ "$f" == *.ts ]] && npx prettier --write "$f"; }

阻止编辑 .env 文件：

python3 -c "import json,sys; p=json.load(sys.stdin).get('tool_input',{}).get('file_path',''); sys.exit(2 if '.env' in p else 0)"

资源文档

• 钩子事件参考：查看

  references/hook-events.md

  了解详细的事件文档，包含输入/输出架构
• 示例配置：查看

  references/examples.md

  获取完整的、经过测试的钩子配置