Claude PreToolUse (6) & SessionStart (1) 钩子包装层
通过 settings.json 挂载 6 个工具调用前拦截器与 1 个会话启动刷新器:拦截高危写入、Git 提交/推送与凭据读取,同时在放行时保持静默退出 0,绝不跳过宿主交互权限确认。
查看钩子 JSON 载荷契约 ↗✅ 能做到
- forbid-content.sh (Write|Edit|NotebookEdit, 120s) 与 forbid-commit/push.sh (Bash(git *), 120s) 调用 check.py 离线拦截私有仓名、业务正则与凭据格式
- forbid-read-secret.sh (Bash, 30s) 与 forbid-read-path.sh (Read|Grep, 30s) 先经 realpath 归一化防 ../ 与软链绕过,阻断直接读取 settings.json/.env/令牌文件
- forbid-tamper.sh (Bash, 30s) 拦阻篡改 core.hooksPath、disableAllHooks 与护栏目录;输入解析失败按 __PARSE_ERROR__ 直接 exit 2 拒绝
- SessionStart 挂载 refresh-private.py (120s),解决云端 Setup Script 阶段环境变量尚未就位的问题
⛔ 明确限制 / 不做什么
- 所有 PreToolUse 包装器刻意不传 --net:宿主对工具钩子有超时控制,超时强杀会等价于“无决策放行”,因此缓存过期时直接按 error 阻断并提示人工刷新
- 刻意不覆盖 Glob 工具(只返回路径列表不回传正文内容)
- 本机高权限用户(如 root)若刻意绕过提醒级 Shell 检查或直接写 .git/,强兜底防线由 Git 层钩子与远端受保护分支承担
输入参数、环境变量与策略约束
tool_input.file_path / path / contentstdinJSON (Claude Hook Payload)必填Hook 标准输入 JSON;任一解析异常触发 __PARSE_ERROR__ 并输出 deny JSON + exit 2。
forbid-commit.sh / forbid-push.shconfigif: "Bash(git *)" · timeout 120s必填同时阻断 --no-verify、--no-gpg-sign、agent 分支推送与违规消息。
forbid-tamper.sh / forbid-read-secret.shconfigmatcher: "Bash" · timeout 30s可选forbid-tamper.sh 在 doctor.py 中标记为可选增强,推荐全部保留启用。