Hooks 常见坑点

你可能注意到,在运行 npm run dev 后,.claude 目录里会出现两个 settings.json 文件。下面解释原因。

Claude Code 文档对 Hook 安全有一些推荐:

Hooks 安全建议

其中一条是:脚本尽量使用绝对路径,而不是相对路径。这样可以降低 路径拦截二进制植入 的风险。

但绝对路径也带来共享困难,因为你机器上的路径与其他人可能完全不同。

为了解决这个问题,项目提供了 settings.example.json。其中脚本路径使用 $PWD 占位符。运行 npm run setup 时,会执行 scripts 目录中的 init-claude.js

  • $PWD 替换为本机项目的绝对路径
  • 复制 settings.example.json
  • 重命名为 settings.local.json

这样既能共享配置,又能满足使用绝对路径的安全建议。