给 Claude Code 的高风险命令加一道提示
作者用 Node.js 编写钩子,在 Claude Code 执行 Bash 命令前检查生产环境、数据和资金相关风险,并分为三档。命中规则后,钩子会阻止首次执行,要求代理先说明风险,再带显式确认标记重试。
AI 深度解读
Claude Code 连续跑了一小时,前面十几次操作都顺利,你很容易顺手批准下一条。可如果它把「清理旧部署」理解成删除 production 里的 api deployment,真正有用的提醒得出现在命令执行之前。作者给出的做法是加一个免费的 Node hook,把命中的 Bash 命令拦下来,先让代理在聊天里交代影响、恢复方式和是否需要确认。
这套做法适合已经在用 Claude Code 跑部署、改数据库或调用付费 API 的开发者。它能把容易扫过去的命令变成一次具体的核对,但确认标记由代理自己写,生产权限和密钥仍得单独管。
一条 Bash 命令怎样触发风险提示?
脚本挂在 Claude Code 的两个事件上。UserPromptSubmit 在每次提交提示词时注入一条简短规则,告诉代理该怎样提示风险。PreToolUse 则在 Bash 调用前检查命令。命中规则且缺少足够级别的 RISK_ACK 时,这次调用会被拒绝,代理会收到拒绝原因和下一步该怎么做。
作者把风险分成三档。kubectl delete、terraform apply、vercel --prod、npm publish,以及执行破坏性 DDL 的 psql "$DATABASE_URL" -c "DROP TABLE users" 都是 HIGH。用 curl 向 api.openai.com 发 POST 会被标成 WARNING,因为这类请求可能消耗付费额度。git reset --hard HEAD~3 是 CAUTION,提示里可以写明用 git reflog 找回原来的提交位置,再重置回去。rm -rf node_modules 和 rm -rf /tmp/build 则直接放行。
环境标记也参与判定。命中会触及环境的规则后,命令里出现 prod 或 staging 标记,风险会升到 HIGH。本地文件名里碰巧有 prod,判定仍按本地操作处理。解析器会识别引号,归一化命令名里的路径、大小写和引号,向内检查 bash -c、eval 和 $(...),最多两层。遇到仅用于写文件的 heredoc,它会跳过正文,避免把写入文件的文本当成即将执行的命令。
拦下来以后,你需要确认什么?
以删除 production 的 api deployment 为例,HIGH 提示要求代理写四项。risk 说清会发生什么,blast 交代谁会受影响,undo 给出恢复步骤,gate 默认写等待用户同意。原文示例用 kubectl apply -f k8s/api.yaml 恢复部署,并提醒期间可能有几分钟停机。WARNING 换成 cost、cap 和 gate。比如逐行调用 OpenAI API 的回填任务,示例明确写了总费用还没估算、上限也没设。CAUTION 一行就够。作者用 diff 代码块让高风险提示在支持相应高亮的界面里更醒目。
安装需要 Node 和 Claude Code。把 risk-flag.js 放到 ~/.claude/hooks/risk-flag.js,下面的配置把两个事件接到同一个脚本上。
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "node ~/.claude/hooks/risk-flag.js",
"timeout": 5,
"statusMessage": "Checking risk flags..."
}
]
}
],
"UserPromptSubmit": [
{
"hooks": [
{
"type": "command",
"command": "node ~/.claude/hooks/risk-flag.js",
"timeout": 5,
"statusMessage": "Injecting risk-flag rule..."
}
]
}
]
}
}
把配置加到 ~/.claude/settings.json 时,留意 "matcher": "Bash" 这一行,它限定了执行前检查的范围。已有 PreToolUse 或 UserPromptSubmit 数组时,把新对象追加进去。开一个新会话,在临时仓库里让代理尝试 git reset --hard HEAD~1,预期会先看到 CAUTION。
代理写出提示后,如果用户明确同意,或者原请求已经明确要求执行这一步,就可以用下面的写法重新提交命令。
RISK_ACK=high kubectl delete deployment api -n production
留意命令开头的 RISK_ACK=high。可用值是 high、warn 和 caution,确认级别至少要达到命令的风险级别。在多行命令里,也可以使用末尾注释,例如 # RISK_ACK=high。给 HIGH 操作写 RISK_ACK=caution,仍会被拒绝。
规则能贴合团队环境,密钥还得另管
脚本把团队差异留给几张正则表。INFRA_RULES 的每一行包含级别、命令、参数和理由,可以补上团队常用的 CLI。PROD_MARKERS 可以填真实生产主机名、数据库端口和线上密钥前缀。MONEY_MARKERS 记录付费服务,以及 backfill、scrape 这类可能伴随额度消耗的词。想改聊天中的提示格式,就编辑 RULE_TEXT。改完后,可以把 PreToolUse 的 Bash 事件 JSON 通过管道传给脚本,例如让 tool_input.command 取值 git reset --hard。空输出表示放行,返回 JSON deny 表示命中。
密钥进入模型上下文是另一条路径。cat .env、echo $STRIPE_KEY、printenv、带 -v 的 curl,以及包含连接串的报错日志,都可能让调试变成泄露。作者提到 hook 会对匹配到的 .env 暴露给出 CAUTION,但普通日志和其他输出仍可能把值带进会话记录。只想确认变量存在,可以用 [ -n "$STRIPE_KEY" ] && echo set || echo missing。只想查看变量名,可以用 printenv | cut -d= -f1。
作者也介绍了团队做的 EnvSecure。按原文描述,它是 macOS 上的 Claude Code mod,密钥放在 Keychain,代理在 Bash 命令里写 $NAME,用户在侧栏批准,命令输出留在侧栏,模型只收到 envsecure: ok 或 envsecure: failed。原文描述了工作流程和适用场景,没提供验证隔离效果的测试结果。
我的判断
四行提示最有价值的地方,是把本来要由人从命令里推断的信息摊开。尤其是生产发布和批量付费调用,看到影响范围、恢复方式或费用上限,才有条件决定是否放行。相比对每条 Bash 命令都弹确认,按风险分档更容易把注意力留给关键操作。作者给了示例和可复查的测试方法,没有给出漏报率、误报率或与逐条确认的对照数据。能减少多少误操作,仍是经验判断。
这套机制依赖代理遵守提示,因为同一个代理也能直接写 RISK_ACK=high。脚本解析失败或抛异常时默认放行,文件编辑和 MCP 工具也在检查范围之外。ssh 的规则更保守,无法确认远程命令只读时会按 HIGH 处理。对于生产发布和数据库写入,CI 审批或最小权限账号能在执行路径上提供独立约束。日常操作里,这个 hook 更适合用来提醒你在命令执行前核对它可能带来的后果。
能拿来做什么
- 如果你用 Claude Code 执行
vercel --prod或npm publish,先在临时仓库验证提示行为,再把实际的生产主机名、数据库端口和线上密钥前缀加入PROD_MARKERS。 - 用 Node 跑付费 API 的批量任务时,让代理在
WARNING里交代计划处理的行数、每行调用次数和费用上限。估不出整批成本时,先用测试凭证跑小样本。 - 在前端或全栈仓库里提交只有变量名的
.env.example,并在permissions下配置"deny": ["Read(./.env)", "Read(./.env.*)"]限制文件工具。Bash 侧仍要避免cat .env和会打印请求头的调试模式。线上密钥已经进入聊天时,轮换该密钥。