官方文档说 hook 通过 stdin 接收 JSON 输入，这没错。但如果你在 hook 脚本里用 python heredoc（python3 - <<'EOF'）来解析这份 JSON，会掉进一个静默失败的坑：heredoc 把 python 的 stdin 重定向成了脚本本身，json.load(sys.stdin) 读到的永远是空。更糟的是，按最佳实践写的 hook 会吞掉一切异常静默退出——你不会看到任何报错，只会发现 hook '好像没生效'。这篇记录真实踩坑过程、两行代码的修复方案，和一个通用教训：静默容错的代码，调试时是你自己的敌人。
深入了解 Claude Code 的 Hooks 系统，学习如何在工具调用前后自动执行自定义脚本，构建符合团队规范的自动化工作流。