Skip to content

代码防泄漏钩子双层本地护栏与 Git 强校验

把 Claude Code 工具调用前拦截与 Git 提交/推送复查统一到同一套 R1–R7 策略引擎,在凭据、私有仓名与未签名提交进入仓库前完成 fail-closed 阻断。

它能做到什么程度(已实现能力)

  • 在 Claude Code 工具调用前通过 6 个离线 PreToolUse 包装器拦截高危写入、Secret 读取与护栏篡改(放行安静 exit 0,绝不输出 permissionDecision: "allow");配合 SessionStart 自动刷新动态名单。
  • 在 Git pre-commit、pre-merge-commit、commit-msg 与 pre-push(--net)统一强制 R1–R7、6h TTL 缓存、非通用 ed25519 SSH 签名直验(ssh-keygen -Y check-novalidate)与基于真实 ls-remote 的 known_content 重签豁免。
  • 通过 API 与组件参考 可按分类查阅每个 Hook 包装器、policy/check.py、refresh-private.py、bootstrap.sh、doctor.py 与 scan-repo.py 的参数契约与示例。

明确不做什么(边界与硬限制)

  • 不替代平台受保护分支与强推拦截:规则 R5 禁止推送至 claude/、codex/ 等 15 个 Agent 分支前缀,但 main 分支保护和强推阻断有意交给 CNB / GitHub Rulesets。
  • 不覆盖仅列举文件名的 Glob 调用:forbid-read-path.sh 仅拦截可返回文件正文的 Read / Grep;高权限本机用户若绕过 Shell 提醒,最终强制防线为 Git 层钩子与远端权限隔离。
  • 禁止直接将源码克隆目录作为运行目录:源内脚本硬编码 /root/.claude/... 模板路径,必须经 policy/bootstrap.sh 改写至 $GUARD(且产品包钩子与本仓库维护脚本 tools/repo_maintenance_guard.py 严格分离)。

架构全景图 ​

代码防泄漏钩子审计流转(交互式架构图,支持平移、缩放与节点探查)

安装状态自检速览 ​

源码仓库本身预置了待改写的部署模板路径;正式使用需通过 policy/bootstrap.sh 铺设到 $GUARD(默认为 $HOME/.claude/guardrails)。在任何目录运行以下命令可只读检查本机接线与缓存健康度:

bash
python3 policy/doctor.py
# 未铺设过的源码目录预期输出 Overall: DEGRADED;铺设且刷新缓存后预期 Overall: PASS

文档分层导航 ​

按照读者需求快速跳转