達到用量上限時 0.9.6 新增
Claude 訂閱有用量上限:一個數小時的時間窗,以及一個每週的時間窗。當回合碰到其中一個上限時,OAR 不會讓回合失敗。它會暫停回合、告訴你上限何時重設,並在重設後自行再次送出工作。你也可以提早送出,或把它捨棄。
回合會怎樣 #
當 Claude 因達到上限而拒絕回合時:
- agent 的回覆會以一則註記結束。回合在被拒絕之前寫下的內容,會保留在註記上方。
- 中繼會在對話中加入一則它自己的訊息,暫緩到重設為止。這則訊息以
Automatic message from OAR: the work was paused at the Claude usage limit.開頭,引用被拒絕的內容(最多最近 5 個請求,依你傳送的順序排列,每個在 4000 個字元處截斷),並請 Claude 從中斷的地方繼續,包括 subagent 和背景任務。 - 輸入區上方會出現一個橫幅,附有 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:。
何時繼續 #
| 重設時間 | 會發生什麼 |
|---|---|
| 6 小時以內 | 暫緩的訊息會在重設後 1 分鐘送出。你不需要做任何事。 |
| 超過 6 小時,例如每週上限 | 回合會等你。註記會說明上限何時重設,並請你在重設後繼續回合。橫幅會顯示 ⏸ Paused at the Claude weekly limit — resets Thu 2 Oct, 09:。 |
| 沒有指明,或已經過了 | Claude 可能在重設後立刻再拒絕一次。中繼會在 5 分鐘後再試,最多連續 6 次,然後等你。此時註記會顯示 ⏸ Paused: the Claude 5-,橫幅也沒有時間。 |
暫停在中繼重新啟動後仍會保留。如果重設時中繼沒有在執行,暫緩的訊息會在它恢復後送出。
上限不會讓回合暫停的情況 #
重設時間在 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.
帳戶使用它的額外用量時,這兩行都不會顯示,而且兩者都會在重設時間消失。
給 agent 和其他 session #
- 監看。 監看已暫停 session 的 session,會收到類型為
usage_的limit error事件,以註記作為訊息。暫停的回合還沒有結束,所以不會收到回合結束事件。 - 不算在工作中。 暫緩的訊息在等待時,該 session 不算在執行回合,也不算是中繼狀態中排入佇列的工作。
- 先檢查。
relay_的tool usage動作會列出中繼上已暫停的 session,附上它們的時間窗、重設時間、繼續的時間(resume),以及是否會自行繼續(At 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 訂閱的時間窗。