其他 Hook 类型与调试方法

除了 PreToolUse 和 PostToolUse，Claude Code 还有 6 种 Hook 类型，覆盖会话生命周期的各个节点。大多数人用不到，但知道它们存在，遇到特定需求时就有思路。

其他 Hook 类型一览

• Notification：Claude 需要权限确认时，或处于空闲等待时触发
• Stop：Claude 完成回复时触发，适合做"任务完成通知"
• SubagentStop：子代理任务结束时触发
• PreCompact：执行 /compact 压缩前触发，可以在压缩前保存重要信息
• UserPromptSubmit：用户提交提示词时触发，可以做预处理或内容过滤
• SessionStart / SessionEnd：会话开始和结束时触发，适合做日志记录

实际使用场景举例

• Stop Hook + 系统通知：长任务完成后发一个桌面通知，不用一直盯着终端
• SessionStart Hook：每次开始会话自动加载特定上下文
• UserPromptSubmit Hook：过滤敏感词、自动添加项目前缀

调试 Hook 最有效的方法

• 不同 Hook 类型、不同工具，接收的 JSON 结构都不一样
• 调试方法：创建一个专门的日志 Hook，把 stdin 直接存到文件
• 命令：cat > /tmp/hook-log.json（或用 jq . > /tmp/hook-log.json 格式化）
• 先看清楚真实的数据结构，再写正式的处理逻辑，省去大量猜测