达到用量上限时 0.9.6 新增

Claude 订阅有用量上限：一个几小时的窗口和一个每周的窗口。当一轮碰到其中一个上限时，OAR 不会让这一轮失败。它会暂停这一轮，告诉你上限何时重置，并在重置后自动重新发送这项工作。你也可以提前发送，或者放弃它。

这一轮会怎样 #

当 Claude 因达到上限而拒绝一轮时：

智能体的回复以一条说明结束。这一轮在被拒绝之前写出的内容保留在它上方。
中继会向对话中添加一条自己的消息，保留到重置时再发送。它以 Automatic message from OAR: the work was paused at the Claude usage limit. 开头，引用被拒绝的内容（最多最近 5 个请求，按你发送的顺序，每个截断到 4000 个字符），并要求 Claude 从中断的地方继续，包括子智能体和后台任务。
输入区上方会出现一个横幅，带有 Resume now（立即恢复）和 Cancel（取消）。

说明会指出是哪个上限，以及这一轮何时继续。这些窗口分别叫作 5-hour limit（5 小时上限）、weekly limit（每周上限）、weekly Opus limit（Opus 每周上限）、weekly Sonnet limit（Sonnet 每周上限）和 extra usage limit（额外用量上限）：

⏸ Paused: the Claude 5-hour limit is reached. The turn carries on by itself at 22:01 UTC.

输入区上方的横幅也是同样的内容：

⏸ Paused at the Claude 5-hour limit — carries on at 22:01

横幅中的时间使用你浏览器的时区。说明由中继写入，因此其中的时间使用中继主机的时区，并以该时区的缩写结尾。不在当天的时间会带上日期，例如 Thu 2 Oct, 09:00。

何时继续 #

重置时间	会发生什么
不超过 6 小时之后	保留的消息在重置 1 分钟后发送。你无需做任何事。
超过 6 小时之后，例如每周上限	这一轮等待你处理。说明会指出上限何时重置，并请你在重置后恢复这一轮。横幅显示 `⏸ Paused at the Claude weekly limit — resets Thu 2 Oct, 09:00`。
未给出，或已经过去	Claude 可能在重置后立即再拒绝一次。中继会在 5 分钟后重试，最多连续 6 次，然后等待你处理。此时说明显示 `⏸ Paused: the Claude 5-hour limit is still reached. Resume the turn once it has reset.`，横幅中没有时间。

暂停在中继重启后仍然有效。如果中继在重置时间处于停止状态，保留的消息会在它恢复后发送。

上限不会暂停一轮的情况 #

重置时间在 8 天以后的，不被视为用量窗口。这一轮不会暂停，而是作为普通的失败轮次失败。普通的 API 错误也是如此，例如 API 密钥的每分钟请求数限制；账户的额外用量所覆盖的窗口也一样：它根本不会让任何一轮结束。

Resume now 和 Cancel #

按钮	作用
Resume now	立即发送保留的消息，不管重置时间是什么。如果上限仍未解除，这一轮会再次暂停。提示显示 `Paused turn resumed.`
Cancel	放弃保留的消息。重置时不会发送任何内容。对话中的说明会保留；中继自己的那条消息会被删除。提示显示 `Paused turn cancelled.`
Switch this chat to API key（将此对话切换到 API 密钥）	0.9.18 新增仅当 Claude API 已开启、已保存密钥且该对话可以切换过去时显示。把对话切换到 Claude API 密钥，暂停的这一轮会立即在那里继续。提示显示 `This chat now runs on the Claude API key; the paused turn carries on there.` 当本月的 Claude API 上限已达到时，横幅改为显示 `No switch to the API key: this month's Claude API cap is reached.`。参见切换对话。

横幅属于被暂停的那个对话。对于会自动恢复的暂停，时间一到横幅就会消失。等待你处理的暂停会一直保留，直到你使用某个按钮；重置之后，它的横幅显示 ⏸ Paused at the Claude weekly limit — the limit has reset。如果已经没有处于暂停状态的轮次，提示会显示 No turn was paused.

期间发送的消息 #

一个对话只保留一条这样的消息。你在暂停期间发送的消息会像其他消息一样立即送达。如果 Claude 也拒绝了它，保留的消息会移回对话末尾，同时引用该请求，等待也会按新的重置时间重新开始。

达到上限之前的警告 #

从某个窗口用到 90% 起，Claude 对话会在输入区上方显示一个横幅。它基于 Claude 在每一轮开始时发送的报告，因此只会在使用订阅时出现：

Claude usage at 96 % of the 5-hour limit — resets 22:01

它针对的是账户，因此会显示在每个 Claude 对话中，而不只是用掉套餐的那个对话。有暂停轮次的对话改为显示暂停横幅。Hide（隐藏）会把它隐藏到下一次报告（另一个窗口、另一个重置时间，或达到上限）为止。当达到上限而还没有轮次被暂停时，横幅显示：

Claude 5-hour limit reached — resets 22:01. A turn sent before that is paused until then.

账户在使用额外用量期间，这两行都不会显示，并且两者都会在重置时间消失。

对于智能体和其他会话 #

监视。 监视某个已暂停会话的会话会收到一个类型为 usage_limit 的 error 事件，其消息就是那条说明。已暂停的一轮并没有结束，因此不会收到轮次结束事件。
不算在工作。 保留的消息等待期间，该会话不算作正在运行一轮，在中继的状态中也不算作排队的工作。
先查看。 relay_tool 的 usage 操作会列出某个中继上已暂停的会话，包括它们的窗口、重置时间、恢复时间（resumeAt）以及是否自动恢复（auto），旁边是账户最新的报告。

通知与主机休眠 #

暂停的一轮会像已完成的一轮一样报告：它会发送一轮完成时的推送通知，以那条说明作为文本。保留的消息发送之后的那一轮会有它自己的通知。排队的主机休眠会等待会自动恢复的暂停，但不会等待需要你处理的暂停。

按提供商 #

提供商	达到用量上限时
Claude	按本页所述暂停。会显示警告横幅。0.9.18 新增横幅可以把对话切换到 Claude API 密钥。不会自动切换。
Claude API 0.9.18 新增	不暂停：密钥没有订阅上限。被 Anthropic 拒绝的一轮会失败，并附带说明和按钮；参见 Claude API 错误码。
Claude Cloud 0.9.7 新增	以同样的方式暂停，横幅和按钮也相同。达到上限之前的警告是工具活动中的一行（`Claude usage limit warning (...)` 或 `Claude usage limit reached, resets ...`），而不是横幅。
GitHub Copilot	不暂停。达到套餐配额的一轮会失败，并附带一条说明，指出套餐在本计费窗口内已没有 AI 额度，并指向 Check Usage（查看用量）查看重置时间。
OpenAI、Cursor、Grok	不暂停。因上限而停止的一轮会像其他失败的轮次一样失败，你需要重新发送消息。
DeepSeek 0.9.17 新增	不暂停，也没有警告横幅，尽管 DeepSeek 对话运行的是 Claude Code：Claude 套餐的上限不适用于它。被 DeepSeek 拒绝的一轮（因余额用尽或达到其并发上限）会失败并附带说明，你需要重新发送消息。参见 DeepSeek 错误码。

暂停只针对 Claude 订阅的窗口。