Blog提交

输入名称、标签或关键词搜索 Mods。

    Claude Code Hooks

    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 权限与沙箱配置。

    以上步骤根据维护者文档整理;本站未将来源核对当作运行环境实测。

    Security Guidance — anthropics/claude-code

    Claude 修改文件时提醒有风险的代码模式。

    hooksAnthropic 仓库152,765 仓库星数仓库更新 2026年10月19日

    Hookify — anthropics/claude-code

    通过易读规则文件创建行为提醒,无需直接编辑 Hook JSON。

    hooksAnthropic 仓库152,765 仓库星数仓库更新 2026年10月19日

    Explanatory Output Style — anthropics/claude-code

    在会话开始时加入解释实现思路的上下文。

    hooksAnthropic 仓库152,765 仓库星数仓库更新 2026年10月19日