Hook 最容易踩的坑

Hook 有一个安全问题很多人忽略：路径问题。用相对路径写 Hook 命令，在某些情况下可能被劫持——攻击者在你的工作目录放一个同名文件，Hook 就会执行它。官方文档明确建议用绝对路径，这不是建议是强制。

为什么必须用绝对路径

• 相对路径（如 ./hooks/read_hook.js）的查找起点取决于当前工作目录
• 如果有人在你的项目里放了一个恶意的同名文件，Hook 就会执行它
• 绝对路径（如 /Users/yourname/project/hooks/read_hook.js）唯一确定，不受工作目录影响
• Anthropic 官方文档明确标注这是安全建议

团队共享和绝对路径的矛盾

• 问题：每个人的绝对路径不同，没法提交同一份配置到 Git
• 解决方案：提交一个 settings.example.json，用 $PWD 作为占位符
• 每个人克隆项目后运行 npm run setup，脚本自动把 $PWD 替换成本机的绝对路径
• 生成 settings.local.json（这个不提交，写进 .gitignore）

npm run dev 后出现两个 settings 文件

• 这是正常现象，不是 Bug
• settings.json：团队共享版本（提交到 Git）
• settings.local.json：本机个人版本（不提交）
• 两个文件同时存在，Claude Code 会合并读取，本地的优先级更高