用途:为 Claude Code 安装、配置和管理安全钩子,在工具调用前拦截危险命令、保护敏感文件。
主要能力:通过 PreToolUse 钩子在三个点拦截调用——Bash 钩子按正则与路径限制评估命令,Edit 钩子校验修改路径,Write 钩子检查创建路径。退出码 0 允许,0 加 JSON 触发确认对话框,2 阻止并把 stderr 反馈给 Claude。部分操作(如 git checkout -- .、git stash drop、带具体 ID 的 DELETE)会触发确认而非直接阻止。
保护级别:zeroAccessPaths 禁止读写改删,用于密钥、凭据、.env;readOnlyPaths 仅可读,用于系统配置、锁文件、构建产物;noDeletePaths 可读写改但不可删,用于重要项目文件、.git/、LICENSE。
拦截范围:破坏性文件操作(rm -rf、sudo rm、chmod 777 等)、Git 破坏性命令(git reset --hard、git push --force、git clean -fd 等)、云与容器命令(AWS terminate-instances、GCP projects delete、Docker system prune -a、Kubernetes delete namespace 等)、数据库破坏性语句(无 WHERE 的 DELETE、DROP TABLE、TRUNCATE、redis-cli FLUSHALL 等)。完整列表见 scripts/patterns.yaml。
使用方式:交互安装运行 /damage-control install,或让 Claude 安装。支持直接指令路由,如“add ~/.credentials to zero access”“block npm publish command”“protect /secrets folder”。安装级别分全局(~/.claude/settings.json)、项目(.claude/settings.json)、个人(.claude/settings.local.json)。运行时需 Python 配 UV,或 TypeScript 配 Bun。
限制:钩子仅在代理启动时加载,安装或修改后必须重启代理,并用 /hooks 验证;测试可用 rm -rf /tmp/test 应被阻止。具体收费、平台支持等资料暂未提供。