agent-usage-guard 是一款 Claude Code 插件，它在开销产生之前就采取行动。它读取你套餐的实时用量，在代理启动、提示发出或工具调用运行之前，暂停子代理扇出、高上下文提示和重试循环。代理用量限制适用于你电脑上的每一个 Claude Code 会话，而且无论用量处于什么水平，扇出和高上下文都会受到限制，而不仅仅是在接近上限时。
当你在键盘前时，守卫会通过 Claude Code 自带的提问对话框向你询问。当无人能够作答时，它会拒绝请求，并告诉 Claude 原因，让模型可以等待、将工作分批处理或停止。Claude Code 报告的 5 小时和每周百分比会驱动其套餐感知限制；一旦获得批准，其条件便会解除，直到时间窗口重置或超时，因此同一问题不会在每次调用时重复出现。
该项目的诞生源于一次以最大强度运行的研究提示：它生成了 394 次子代理调用，其中 341 个同时运行，并在十分钟内通过 API 推送了 8,400 万上下文令牌，从而触发了锁定。作者自己的日志记录了 60 天内的 12 次锁定。每项保护机制都消除了这一失败模式中的一个因素。
该守卫在本地运行，且最大限度地减少隐私信息。它不进行任何网络调用，只存储计数和粗略的分档数据，从不保存提示文本、工具输入或模型输出。它采用失效放行机制，因此出现故障的钩子不会中断会话。唯一的例外是守卫无法及时判断的代理，此类代理会被拒绝，以便 Claude 重新启动它。请在 Claude Code v2.1.287 或更高版本中安装它，然后运行 /agent-guard，查看它监测到的内容。
来源: Hacker News · 由HeadlinesBriefing整理摘要