首页 > 教程资讯 > 教程详情

Claude Code 模组 agent-usage-guard 发布:在额度耗尽前拦下 agent 扇出和超大上下文

AI 与前沿 数码评测汪工 2026-10-24
文章分享

开发者 rbartoli 发布了 Claude Code 模组 agent-usage-guard。它在新 agent 启动、超大上下文 prompt 发送和工具调用反复失败时先行检查,用来避免 5 小时或每周的用量额度被短时间耗尽。该项目在 Hacker News 的 Show HN 获得 26 分、11 条评论,采用 MIT 许可。

它拦什么

作者在帖子中称,自己多次在几分钟内用光整个用量窗口,于是做了这个模组,把控制权交还给用户。据 ccmods.app 页面,它的主要规则如下:

  • 额度窗口用到 80% 时,新 agent 需要确认;用到 95% 时直接拒绝。
  • 整机所有会话最多同时运行 4 个 agent,每 10 分钟最多启动 12 个。
  • prompt 将重读 500k token 上下文时,询问是先压缩再发送、照常发送还是取消。
  • 同一工具调用连续失败 3 次后,拒绝相同的重试。

作者补充说,agent 数量是按机器上的所有会话统计的;另有一条烧速规则,即 10 分钟内消耗 5 小时窗口的 20 个百分点。

作者自测数据

作者称,他此前用基于 hooks 的版本运行了 75 天:单次最大突发的 agent 派生数从 365 降到 27,超过 50 万 token 上下文的请求占比从 14.5% 降到 0.6%。他同时表示,锁定次数仍然上升,因为大量并行的主会话同样会耗用窗口。以上数据均为作者自述,来源中没有第三方验证。

哪些阈值与套餐有关

针对有评论者问到默认值适配哪种套餐,作者回复说,百分比规则不依赖套餐,读取的是 Claude Code 上报的 5 小时和每周用量百分比,Pro 和 Max 20x 上的行为一致。与套餐有关的是绝对数值:同时运行 4 个 agent、每 10 分钟启动 12 个、每 10 分钟 1000 万子 agent token,以及 500k 上下文触发压缩询问。

作者按自己的 Max 5x 套餐调参,称这些值在 Pro 上可能偏松。用户可以通过 AGENT_GUARD_* 环境变量修改,作者表示会考虑按套餐提供预设。

安装与隐私

ccmods.app 页面显示,当前版本为 v1.0.3,更新于 2026 年 10 月 11 日。安装需要 Claude Code 2.1.287 或更高版本,命令为:

claude plugin install agent-usage-guard --marketplace rbartoli/agent-usage-guard

安装后可用 /agent-guard 查看状态,支持 allow、pause、resume、report 子命令。作者称该项目不发起网络调用。据 hunted.space 页面介绍,它在本地运行、不启动进程、不保存提示文本,出错时默认放行。该页面还显示,该产品在 Product Hunt 获得 2 个赞、1 条评论,日榜排名第 84,未被 Product Hunt 官方收录推荐。

相关下载

来源