Skip to content

Hooks 配置

配置 Claude Code 的钩子系统,在工具执行前后运行自定义命令。

Hooks 允许您在 Claude Code 生命周期的特定时间点注册 shell 命令,实现自动化操作。

配置位置

Hooks 在 settings.json 中配置:

json
{
  "hooks": {
    "PreToolUse": [...],
    "PostToolUse": [...]
  }
}

Hook 事件类型

事件触发时机
PreToolUse工具调用之前
PostToolUse工具调用完成后
UserPromptSubmit用户提交提示时
Notification发送通知时
Stop响应完成时
SessionStart会话启动时

示例配置

json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "prettier --write \"$FILE_PATH\""
          }
        ]
      }
    ]
  }
}

更多信息

详细的 Hooks 指南请参考 Hooks 入门指南