使用量の上限に達したとき 0.9.6 で追加

Claude のサブスクリプションには使用量の上限があります。数時間の時間枠と、週単位の時間枠です。ターンがそのどちらかに達しても、OAR はターンを失敗させません。ターンを一時停止し、上限がいつリセットされるかを伝え、リセット後に作業を自動で送り直します。それより早く送ることも、破棄することもできます。

ターンに起きること #

Claude が上限でターンを拒否すると、次のようになります。

1. エージェントの返信はメモで締めくくられます。拒否される前にターンが書いた内容は、その上に残ります。
2. リレーは独自のメッセージを会話に追加し、リセットまで保留します。このメッセージは Automatic message from OAR: the work was paused at the Claude usage limit. で始まり、拒否された内容を引用し（最大で直近 5 件のリクエストを送った順に、それぞれ 4000 文字までで切って）、中断したところから続けるよう Claude に依頼します。サブエージェントとバックグラウンドタスクも含みます。
3. 入力欄の上に、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。

ターンが続くとき #

一時停止はリレーの再起動後も維持されます。リセットの時刻にリレーが停止していた場合、保留中のメッセージはリレーが戻ってから送られます。

上限でもターンが一時停止しないとき #

リセットが 8 日より先の場合は、使用量の時間枠とは見なされません。ターンは一時停止されず、通常の失敗したターンとして失敗します。API キーの 1 分あたりのリクエスト数のような単純な API エラーや、アカウントの追加使用量でまかなわれる時間枠も同じです。後者ではターンは終了しません。

Resume now と Cancel #

バナーは一時停止した会話に属します。自動で再開する一時停止では、時刻になるとバナーは消えます。自分の操作を待つ一時停止は、ボタンを使うまで残ります。リセット後、そのバナーは ⏸ Paused at the Claude weekly limit — the limit has reset と表示されます。一時停止中のターンがもうなかった場合、通知には No turn was paused. と表示されます。

その間に送るメッセージ #

1 つの会話が保留するメッセージは 1 件です。一時停止中に送ったメッセージは、ほかのメッセージと同様にすぐに届けられます。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 のサブスクリプションの時間枠だけです。