⚡ Risk Guard for Claude Code

为 Claude Code 打造的 AI 风险评估 Hook。自动判断每个操作的风险等级，决定放行、通知还是拦截。

解决什么问题

同时开多个 Claude Code 窗口跑任务时，安全操作也要反复确认，打断工作流、拖慢进度。

怎么解决的

Risk Guard 拦截每一次工具调用，智能决策：

场景	处理方式	延迟
只读工具 (Read, Grep, Glob...)	静默放行	0s
普通文件编辑	静默放行	0s
Bash 命令（有缓存）	自动放行 / 通知	0s
Bash 命令（首次）	AI 评估风险	~7s
高风险操作	系统通知 + 终端确认	—

风险等级

• Level 0 (低风险) — 静默放行。只读命令、构建、测试。
• Level 1 (中风险) — macOS 通知 + 自动放行。安装依赖、git push、文件移动。
• Level 2 (高风险) — 通知 + 声音 + 终端确认。force push、rm -rf /、数据库删除、远程代码执行。

安装

curl -fsSL https://raw.githubusercontent.com/shaominngqing/Risk-Guard/main/install.sh | bash

或者克隆后本地安装：

git clone https://github.com/shaominngqing/Risk-Guard.git
bash Risk-Guard/install.sh

新开的 Claude Code 会话自动生效。

使用

risk-guard status         # 查看状态
risk-guard on / off       # 启用 / 禁用
risk-guard toggle         # 切换开关
risk-guard test <cmd>     # 测试命令风险等级
risk-guard cache [clear]  # 查看 / 清空缓存
risk-guard log [N|clear]  # 查看 / 清空日志
risk-guard uninstall      # 完全卸载

测试示例

risk-guard test ls -la
# ✅ allow  ([低风险] 只读目录查看)  [0.0s]  — 缓存命中

risk-guard test rm -rf /
# 🚨 ask  ([高风险] 极度危险的递归删除根目录)  [6.8s]

risk-guard test npm install express
# ✅ allow  ([中风险] 安装npm依赖包)  [7.2s]

工作原理

Claude Code 调用工具
        │
        ▼
┌──────────────────────────┐
│  第一层: 快速规则          │  只做工具级别的确定性判断
│  Read/Grep/Glob → 放行   │  不写任何 Bash 命令规则
│  普通文件编辑 → 放行      │
└──────────┬───────────────┘
           │ 未命中
           ▼
┌──────────────────────────┐
│  第二层: 缓存查询          │  命令归一化为模式
│  "rm -rf" → 复用上次      │  md5 哈希, 24小时有效
│  AI 的判断结果             │
└──────────┬───────────────┘
           │ 缓存未命中
           ▼
┌──────────────────────────┐
│  第三层: AI 评估           │  claude -p 理解命令语义
│  返回风险等级和原因        │  结果写入缓存供下次复用
└──────────┬───────────────┘
           │
           ▼
  Level 0 → 静默放行
  Level 1 → 系统通知 + 放行
  Level 2 → 通知 + 声音 + 终端确认

设计哲学：不写硬编码的 Bash 规则。AI 理解命令语义，比正则匹配更准确。缓存保证同类命令第二次零延迟。

环境要求

• 已安装 Claude Code
• PATH 中有 python3
• 有 claude CLI（AI 评估层需要）
• macOS（系统通知）或 Linux（需要 notify-send）

卸载

risk-guard uninstall

License

MIT