停止 Claude Code 在十分钟内消耗您的五小时使用窗口。 agent-usage-guard 是一个 Claude Code 修改版：它在 Claude Code 内部运行，并在支出发生之前保持控制。它读取您计划的实时使用情况，并控制子代理的扩展、大量上下文的消耗和重试循环。此内容通过 Claude Code 的交互式用户界面录制，保护程序已加载。一个脚本化的本地 API 取代 Claude，这样会话和令牌计数被分阶段，且不消耗使用。屏幕上的每个问题都是保护程序自己的。根据 Northstar fixture 重建它。它在支出之前采取行动，而不是之后：在代理开始之前，发送提示，或者运行工具调用。代理限制在您机器上的每个 Claude Code 会话之间保持，并且扩展和大量上下文在任何使用级别都受到限制，而不仅仅是在接近限制时。当您在键盘前时，它在 Claude Code 自己的问题对话中询问您。当没有人可以回答时，它拒绝并告诉 Claude 原因，这样模型可以等待、批量处理工作或停止。 /agent-guard 报告显示它所做的事情。考虑到计划。它读取 Claude Code 报告的 5 小时和每周百分比，并为您保留窗口结束。一个答案覆盖一段时间。批准解除其条件，直到清除或超时，因此相同的问题不会反复出现。地方和隐私最小化。没有网络，没有进程。它存储计数和粗略的桶，从不存储提示文本、工具输入或模型输出。失败开放。如果其某个钩子失败，事件也能继续：坏的保护从不破坏您的会话。唯一的例外是未能及时判断的代理，这个代理被拒绝以便 Claude 再次启动。安装 在 Claude Code v2.1.287 或更高版本中运行以下命令： /plugin marketplace add rbartoli/agent-usage-guard /plugin install agent-usage-guard@agent-usage-guard /reload-plugins 然后运行 /agent-guard 查看它所看到的内容。默认情况下，修改已开启；概述列出了关闭它们的设置。 为什么这个存在 有一个下午，我给 Claude Code 提供了一个最大努力的研究提示。它生成了 394 个子代理调用，其中 341 个同时运行，并在十分钟内通过 API 推送了 8400 万个上下文令牌。会话结束：“Claude 使用限制已达到。”锁定，直到窗口重置。这不是一次性事件。我自己的日志显示，在 60 天内有 12 次锁定和 166 个十分钟窗口伴随代理冲击。故障模式乘法：大型上下文 × 快速工具循环 × 并行代理 × 盲重试。以下每个保护措施消除了一个因素。而且不仅仅是我：一个提示生成 339 个子代理 ，递归生成消耗了一半的每周最大计划，多个代理运行使用了约 15 倍于一个聊天会话的令牌。 它做了什么 区域 规则 默认 什么发生 计划窗口 新代理在窗口满80%时需要批准；批准在窗口重置前有效 新代理在窗口满95%时被拒绝 新代理在 5 小时窗口迅速上升时需要批准 20 点/10分钟 代理 每台机器上此会话中的同时运行代理 4 请求 每 10 分钟启动或恢复的代理 12 请求 每 10 分钟处理的子代理令牌 1000万 请求 子代理不得启动自己的代理 深度 1 拒绝 上下文 Claude 被告知一次保持回合限制 30万令牌 向提示添加备注 一个提示如果会重新读取并达到这个上下文 50万令牌 请求：压缩后发送，还是直接发送，或取消 每 10 分钟的工具调用，同时对话或代理携带的上下文 20 个调用在40万请求：继续，压缩后此回合，还是停止 一个重会话闲置足够长时间以使其提示缓存过期 15万令牌，1小时闲置 请求在重写缓存之前 循环 相同的工具调用一次又一次失败，而中间没有其他调用 3 个相同失败 拒绝相同的重试 10 分钟内拒绝的代理调用 5 暂停 代理在 10 分钟内生成。代理包括子代理、代理团队成员、工作流程代理和与 SendMessage 恢复的已完成子代理。每个工具调用根据构成它的循环的上下文进行判断，因此小子代理永远不会继承主要对话的大小。 当它询问时。问题出现在 Claude Code 自己的对话框中，这是 Claude 用来询问您的问题的对话框，并且该调用等待您的回答。在它打开时并行启动的代理被抑制，一旦您回答，Claude 会重新开始它们。如果您允许，它的条件在一段时间内保持允许：直到重置的计划窗口，直到收缩的重上下文（对于工具调用，最多一小时），代理计数保持在 10 分钟内。如果您拒绝或应付问题，则告知 Claude 在接下来的 10 分钟内不启动代理（AGENT_GUARD_WINDOW_SECONDS），并在此期间不再询问。输入的文字到达 Claude，因此您可以回答“改用俳句代理”。 当没有人可以回答时。在 claude -p 中，代理 SDK 和 dontAsk 模式，代理或工具门拒绝而不是询问。一个重提示被保持并附有原因，