Git Safety Guard 用于在 Claude Code 中配置对破坏性 git 与文件系统命令的防护。它在命令执行前拦截 Bash 调用,阻止可能永久销毁未提交工作或重要文件的操作。其核心为 terraphim-agent guard CLI 命令,通过正则模式匹配加允许清单区分安全与危险变体。
主要能力:拦截 git checkout -- <files>、git restore <files>、git reset --hard、git reset --merge、git clean -f、git push --force/-f、git branch -D、非临时路径的 rm -rf、git stash drop/clear、git commit --no-verify/-n、git push --no-verify。明确允许 git checkout -b、git checkout --orphan、git restore --staged、git clean -n/--dry-run、git push --force-with-lease,以及 /tmp、/var/tmp、$TMPDIR 下的 rm -rf。采用失败开放语义:代理缺失或匹配失败时命令放行;错误仅在 verbose 模式记录到 stderr。
使用方式:从 GitHub Releases 安装 terraphim-agent(注意 crates.io 版本过旧,缺少 guard 命令),例如:gh release download --repo terraphim/terraphim-ai --pattern "terraphim-agent-aarch64-apple-darwin" --dir /tmp,再 chmod +x 并移动到 ~/.cargo/bin/。测试命令:echo "git checkout -- file.txt" | terraphim-agent guard --json。安装 hook 可复制 git_safety_guard.sh 到 .claude/hooks/ 并在 .claude/settings.local.json 配置 PreToolUse 匹配 Bash;全局安装运行 ./scripts/install-terraphim-hooks.sh --global。
适用场景:为 Claude Code 等 AI 代理提供机械式安全防护,避免误执行销毁未提交工作的命令。局限:依赖正则匹配,可能被绕过;需 jq 与可执行权限;失败开放意味着防护失效时不会阻止命令。缺失信息暂未提供。