Protect Secrets Hook(敏感文件防护)
按敏感路径与信息暴露规则检查文件访问和 Shell 请求。
securityPreToolUse
关于 Sensitive File Guard
Protect Secrets 在执行前检查 Read、Edit、Write、Bash 和 Grep 请求,匹配凭据路径及相关命令模式,同时允许常见环境变量示例文件。它可减少意外访问,但无法保证发现所有敏感数据。
- 分别检查文件工具路径与 Bash 命令模式。
- 可作为 claude-code-hooks 市场中的独立插件安装。
如何安装
先打开来源文档,核对项目的前置条件与安装位置。复制以下命令,逐行运行;命令中的示例路径需要替换为自己的目录。
终端
claude plugin marketplace add karanb192/claude-code-hooks
claude plugin install protect-secrets@claude-code-hooks按来源说明完成必要的认证或设置,重新加载会话后确认新能力可用。仓库内的项目可能共享同一个插件安装包。
开始使用
启用前查看保护规则与例外,使用虚拟路径和测试值验证,不使用真实凭据测试。 此包使用 Node.js 命令钩子,安装后重启 Claude Code。
使用前留意
阅读项目指令和请求的工具权限,先在小范围任务中验证。本站核对来源与说明,收录不代表代码安全审计。
工具执行前会检查什么
Protect Secrets 使用 PreToolUse 命令 Hook,在 Claude Code 执行匹配的工具请求前检查,并可返回拒绝或询问决定及命中的规则。
- 文件访问
- Read、Edit、Write 会检查环境文件、私钥、云服务凭据等敏感路径;.env.example 等示例模板被明确放行。
- 搜索与 Shell
- Grep 的目标与 Bash 命令文本会按文档列出的敏感信息暴露模式检查;命中时会说明触发了哪条规则。
- 处理方式
- 默认拒绝命中的请求。可以按规则等级选择询问模式;未命中的普通请求继续执行。
选择防护等级并验证
- 默认等级
- 默认 high 等级在 critical 规则上增加敏感文件名、环境变量转储及文档列出的外传模式检查;strict 覆盖更广,也可能打断正常工作。
- 安全试用
- 安装后重启 Claude Code,在临时项目中用虚构的凭据路径试用,确认 Hook 报告命中规则;不要拿真实密钥测试。
- 审计日志
- 维护者说明拒绝与询问记录会写入本机 ~/.claude/hooks-logs/;请求意外被拦截时可据此查看命中原因。
防护边界
- 模式匹配
- Hook 不解析符号链接,也无法预先检查宽泛搜索可能返回的每个文件。脚本在内部读取文件时,仅检查 Bash 命令文本可能看不到真实访问。
- 工具范围
- 文档列出的匹配范围是 Read、Edit、Write、Bash 和 Grep,不包含 PowerShell。需要更完整的约束时,应结合 Claude Code 权限与沙箱配置。
以上步骤根据维护者文档整理;本站未将来源核对当作运行环境实测。