基础篇
进阶篇
高频篇
精选篇
手写篇
面经篇
AI 篇
原理篇
每日一题
小程序题库
  • 知识卡片碎片时间过考点
  • 场景篇按分类整理的大前端场景考点
  • 历年面经按年份追踪真实考点
  • 算法题库NEW在线编码即时判题
  • 专项自测100 题快速查漏
  • 前端基础
    • HTTP从报文一路讲到 HTTPS
    • 浏览器渲染、事件循环、进程
    • 计算机基础Linux、网络、操作系统
  • 进阶专项
    • 设计模式23 种模式怎么用
    • 前端系统进阶学习大型项目工程化
    • 前端综合文章长期沉淀的实践文
  • 工程与工具
    • Node学习指南从环境搭建到服务端
    • NPM工作流script、依赖与发布
    • Docker容器化部署上手
    • Canvas图形与动画实战
  • 路线与导图
    • 思维导图知识点全景图
    • 学习路线按图索骥不跑偏
  • 动态
    • 公众号动态公众号历史文章
    • 博客动态站长的技术博客
    • 开发者导航常用工具与文档站
    • AI 热点每日 AI 资讯与动向
AI 工作台
旧版
AIHT
内容
精选全部 AI 动态热点榜AI 日报收藏
分类
模型行业编程产品技术观点开源
更多
Agent 接入
返回首页开发者导航
AIHT
精选 / 资讯详情
8.0
热点
AI SCORE
编程提效2026-11-22 12:30

给 Claude Code 的高风险命令加一道提示

dev.to · AI#Claude Code#命令钩子#生产环境
Editor brief · 编辑速览

作者用 Node.js 编写钩子,在 Claude Code 执行 Bash 命令前检查生产环境、数据和资金相关风险,并分为三档。命中规则后,钩子会阻止首次执行,要求代理先说明风险,再带显式确认标记重试。

文章思维导图
Knowledge map
拖拽缩放
AI deep read

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 和会打印请求头的调试模式。线上密钥已经进入聊天时,轮换该密钥。
Original source

本文由 AI 通读原文后重新编写,观点部分为站内判断,细节以原文为准,来源 dev.to · AI,原文版权归原作者所有。

阅读原文
上一篇
抽查两万份技能文件后,作者给出编写准则
下一篇
接入 738 个 MCP 工具后,Claude Code 怎么选

资讯速览

dev.to · AI · 2026-11-22 12:30

AI 评分 8.0 / 10

相关标签

#Claude Code#命令钩子#生产环境

继续阅读

  • Inkling 2 Mini 开放权重,支持本地编程
  • 抽查两万份技能文件后,作者给出编写准则
  • 接入 738 个 MCP 工具后,Claude Code 怎么选
  • 工具调用型 Agent 上线后的三类故障
  • 测试提示词疑遭转存,OpenRouter 移除三家供应商