用途
git-guardrails-claude-code 用于为 Claude Code 设置 git 安全护栏。它通过配置一个 PreToolUse 钩子,在 Claude 执行命令之前进行拦截,阻止危险的 git 命令运行。适用场景是用户希望防止(Claude)执行破坏性或高风险的 git 操作。
主要能力:被阻止的命令
该技能会阻止以下 git 命令:
- git push(所有变体,包括 --force)
- git reset --hard
- git clean -f / git clean -fd
- git branch -D
- git checkout . / git restore .
当命令被阻止时,Claude 会看到一条消息,告知它没有权限访问这些命令。
使用方式
安装流程分为以下步骤:
1. 询问生效范围
询问用户:仅为此项目安装(.claude/settings.json),还是为所有项目安装(~/.claude/settings.json)?
2. 复制钩子脚本
随附脚本位于:scripts/block-dangerous-git.sh
根据范围复制到目标位置:
- 项目:.claude/hooks/block-dangerous-git.sh
- 全局:~/.claude/hooks/block-dangerous-git.sh
用 chmod +x 使其可执行。
3. 将钩子添加到设置
添加到相应的设置文件。
项目(.claude/settings.json):
{ "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": ""$CLAUDE_PROJECT_DIR"/.claude/hooks/block-dangerous-git.sh" } ] } ] } }
全局(~/.claude/settings.json):
{ "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "~/.claude/hooks/block-dangerous-git.sh" } ] } ] } }
如果设置文件已存在,请将钩子合并到现有的 hooks.PreToolUse 数组中,不要覆盖其它设置。
4. 询问自定义
询问用户是否要从阻止列表中增加或删除任何模式,并相应编辑已复制的脚本。
5. 验证
运行一个快速测试:
echo '{"tool_input":{"command":"git push origin main"}}' | <path-to-script>
应以退出码 2 结束,并向 stderr 打印一条 BLOCKED 消息。
限制
资料中未提供该技能的价格、平台支持、更多拦截规则细节或其它限制说明,相关内容暂未提供。