开发者 rbartoli 发布了 Claude Code 模组 agent-usage-guard。它在新 agent 启动、超大上下文 prompt 发送和工具调用反复失败时先行检查,用来避免 5 小时或每周的用量额度被短时间耗尽。该项目在 Hacker News 的 Show HN 获得 26 分、11 条评论,采用 MIT 许可。
作者在帖子中称,自己多次在几分钟内用光整个用量窗口,于是做了这个模组,把控制权交还给用户。据 ccmods.app 页面,它的主要规则如下:
作者补充说,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 官方收录推荐。