/hooks
显示工具事件(Tool Events)对应的 Hook 配置。
/hooks 打开一个纯只读浏览界面,展示当前所有已配置的钩子(hook)——这些是在 Claude Code 运行流程中的特定时刻触发的自动化 shell 命令、HTTP 调用、提示词、Agent 或 MCP 工具调用,例如在某个工具调用之前或之后。菜单会列出每个钩子事件及其已配置的钩子数量,可以展开单个匹配器(matcher),并为每个钩子显示完整细节:事件、匹配器、类型,以及具体的命令、提示词文本或 URL。
每个条目还会标注其来源:User(来自 ~/.claude/settings.json)、Project(.claude/settings.json)、Local(.claude/settings.local.json)、Plugin(来自已安装的插件)、Session(仅为当前会话注册)或 Built-in(Claude Code 内置)。
该命令不接受任何参数,也不会改变任何内容——它仅用于查看概览,例如用来检查某个工具调用为什么被阻止或被修改。
✅ 什么时候用？
在添加新钩子之前先检查现有配置
执行 /hooks,查看 PreToolUse 是否已经有匹配器作用于 Bash 命令
查明某个钩子来自哪个配置文件
打开 /hooks,查看来源标注(User/Project/Local/Plugin),以确认某个钩子是否来自已安装的插件
⛔ 什么时候不该用？
编辑或重新配置钩子规则
根据文档,/hooks 只是一个纯只读浏览界面,不是编辑界面
更好的选择: 直接在 settings.json 中调整配置(或请人代为调整),或使用 update-config 技能
查找某个已配置的钩子在运行时失败的原因
/hooks 只显示配置内容(事件、匹配器、命令),不显示运行时错误——根据文档,这些错误会记录在调试日志中
更好的选择: 使用 /debug 查看包含钩子错误信息的会话调试日志
来源
- Claude Code 文档（官方） ↗ code.claude.com