配置格式

把自动化规则写进 settings.json,让 Claude Code 在正确的时机执行正确的脚本

配置12 分钟

一、Hook 配置写在哪里

Hook 配置写在 settings.jsonhooks 字段中。三个位置可选:

位置路径生效范围可共享
用户级~/.claude/settings.json所有项目否(仅本机)
项目级.claude/settings.json当前项目是(可提交 Git)
本地级.claude/settings.local.json当前项目否(gitignore)

选择原则:通用型 Hook(桌面通知、提示音)放用户级;项目相关的 Hook(代码格式化、测试触发)放项目级。本地级适合个人调试用途,不影响团队成员。

除手动编辑外,在 Claude Code 中输入 /hooks 可通过交互式菜单添加 Hook,菜单会引导选择事件、设置匹配器和输入命令。

二、JSON 三层嵌套结构

Hook 配置遵循固定的三层嵌套:

完整示例——文件编辑后自动格式化:

逐层含义:

层级本例中的值作用
Level 1: 事件"PostToolUse"工具执行成功后触发
Level 2: 匹配器"Edit|Write"仅 Edit 或 Write 工具触发
Level 3: 处理器type + command运行 Shell 命令执行格式化

同一事件下可配置多组匹配器,每组匹配不同工具并执行不同处理。同一匹配器下也可挂载多个处理器,它们并行运行。

三、配置元素解剖

通用 Handler 字段

每个处理器对象都支持以下字段:

付费内容

继续阅读完整课程

购买后即可解锁全部 16 个功能模块、实战场景与深度配置。

¥199¥399
  • 30 分钟完成第一个真实任务
  • 实战场景 + 深度配置
  • 长期访问,持续更新