Claude Media
Claude Code /rate-limit-optionsコマンドで上限到達後の続け方を選ぶ

Claude Code /rate-limit-optionsコマンドで上限到達後の続け方を選ぶ

/rate-limit-optionsは使用量上限に達したあと、自動継続を待つか止めるか、クレジット追加や契約アップグレードに進むかを選ぶメニューを開きます。

/rate-limit-optionsは、claude.aiの使用量上限にリクエストが止められたあと、次にどう動くかを選ぶメニューを開くコマンドです。選択肢は大きく3系統に分かれます。上限がリセットされるまで待って自動的に作業を再開する、自動再開をやめる、使用量クレジットを追加するかプランをアップグレードして今すぐ再開を試みる、のいずれかです。自分のターミナルで上限に当たり、自動の待機が始まらない状況になると、Claude Codeがこのメニューを自分で開くこともあります。

コマンド名には「rate limit」とありますが、対象はAPIのレート制限ではなく契約プランの使用量上限です。429エラーのようなリクエスト単位のレート制限とは別物で、そちらの切り分けはClaude rate limitエラーの対処で扱っています。上限メッセージの種類そのものを見分けたいときはClaude Codeの利用上限が起点です。本記事は、上限に当たったあとにこのコマンドで何を選べるかに絞ります。

/rate-limit-optionsが並べる3つの選択肢

実行にはclaude.aiのサブスクリプションでのサインインが必要です。APIキー認証では使えません。

> /rate-limit-options

メニューが開くと、次の系統の行が並びます。

  • 「待ってから自動再開する」(英語表示はWait here, then continue automaticallyで始まる行): リセット時刻まで開いたセッションで待ち、自動で作業を再開します
  • 「自動再開をやめる」(Don't continue automatically): 待機中の自動再開をキャンセルします
  • 「使用量クレジットを追加する」または「プランをアップグレードする」: 今すぐ再開したいときの導線です

「待ってから自動再開する」系の行は、Claude Code v2.1.234以降だけに表示されます。それより前のバージョンでは、上限に当たったときに待つという選択肢自体がありませんでした。

このコマンドが一覧に出るかどうかは、公式ページ同士で書きぶりが食い違っています。コマンド一覧のページには「コマンドメニューには出ないので、フルネームで入力する」とあります。一方、v2.1.284の変更履歴には、/helpとコマンドメニューに追加したという項目があります。どちらの表示になるかは環境で確かめるしかありません。見当たらないときは、フルネームで入力すれば実行できます。

自動で待機が始まる場面と、自分で始める場面

上限に当たったときの動きは、状況で3段階に分かれます。自動で待機が始まる、メニューから自分で選ぶ、そもそも提供されない、の3つです。

状況挙動
自分のターミナルの対話セッションで、通常の上限に当たった挙動自動で待機が始まる。設定は既定でオン
Remote Controlやagent teamのteammateセッション挙動自動では始まらない。その端末にいる人が/rate-limit-optionsを自分で実行する
週次上限など、リセットが24時間より先挙動自動では待機を開始しない。メニューから手動で選ぶ
Opus/Sonnet限定枠に当たったが、別ファミリーのモデルで動いている挙動次のターンはその枠に当たらない可能性があるため、自動では開始しない(opusplanなど、制限のかかったファミリーでplanモードを走らせる設定は例外)
バックグラウンドセッション、-p実行挙動メニューの行自体が出ない
APIキー認証・クラウド経由・従量課金挙動待機を一切提供しない(リクエスト単位の課金にはリセットという概念がないため)
保存済みのclaude.aiログインがないLLMゲートウェイ経由挙動待機を提供しない(保存済みログインが有効な資格情報のときだけ提供)

自動で始まらない状況のうち、自分のターミナルで上限に当たったときと、自動継続の設定をオフにしているときは、リセット窓ごとに1回メニューが開きます。そこで「待ってから自動再開する」行を選べば、以降は自動のときと同じ待機に入ります。

表示されたメッセージで、モデル切り替えの効き方が変わる

待つ以外の手として/modelが頭に浮かびますが、効くかどうかは上限の種類で決まります。

表示/modelで続けられるか補足
You've hit your session limit · resets 3:45pm/modelで続けられるか続けられない補足全モデル共通の枠なので、切り替えても戻らない
You've hit your weekly limit · resets Mon 12:00am/modelで続けられるか続けられない補足同じく全モデル共通。セッション枠と週次枠は同時に消費される
You've hit your Opus limit / Sonnet limit/modelで続けられるか別ファミリーへ切り替えれば続けられる補足切り替え先は別のプロンプトキャッシュを持つ

セッション上限と週次上限では、モデルを替えても枠は戻りません。待つか、クレジットを追加するか、アップグレードするかを選ぶ場面です。Opus/Sonnet限定枠に当たったときだけ、/modelで枠の外のモデルへ替えて作業を続けられます。ただし切り替え先は別のキャッシュを持つため、次のリクエストは会話全体を読み直し、キャッシュヒットしません。

似た文面にspend limit reachedがありますが、これはClaude appsゲートウェイの運営者が決めた上限です。claude.aiの使用量上限とは別の項目で、ゲートウェイ運営者に上限を上げてもらうか、メッセージに書かれたリセット時刻まで待つことになります。

「待ってから自動再開する」を選んだあとの画面

待機に入ると、セッション下部に残り時間を示す行が出ます。

Usage limit reached · continuing automatically at 3:45pm · esc to cancel

待機中はセッションを開いたままにしておきます。行の表示はリセットを境に変わり、パソコンがスリープしていたかどうかで再開のしかたが分かれます。

手順

待機から再開までの表示

  1. 1

    リセット時刻

    表示がcontinuing shortlyに変わり、続けてUsage limit reset · continuing automaticallyになります。

  2. 2

    再開

    Claude Codeが決まった再開プロンプトを送って、作業を続けます。直前に送った自分のメッセージを送り直すわけではありません。

  3. 3

    スリープしていた場合

    スリープが約30分を超え、その間にリセットを迎えていたときはYour usage limit has reset · press enter to continueと表示され、Enterを押すまで進みません。短いスリープなら、そのまま自動で続きます。

待機中に/usage-creditsでクレジットを追加し終える、/upgradeのあとにサインインし直す、/modelでモデルを切り替える、のいずれかを行うと、Claude Codeはその場で使用量が復活しているか確認し、復活していればリセットを待たずに再開します。ブラウザ側だけで済ませたアップグレードや購入は、この即時チェックの対象外です。opusplanなど、制限のかかったモデルファミリーでplanモードを走らせる設定では、この即時復帰は起きずリセットを待ちます。

再開後のタスクは通常のターン同様に進み、権限確認も普段どおり求められます。席を離れている間に権限の確認プロンプトで止まることもあります。再開後すぐにまた上限へ当たった場合、Claude Codeは連続で最大2回まで待機を組み直します。3回目でも当たると、そこで止まりAutomatic continue stopped after repeated usage-limit hits · /rate-limit-options to try againと表示します。

上限そのものに当たる前に、Claude Codeは枠を使い切りそうなことも知らせます。You've used 85% of your session limit · resets 3:45pmのような警告がその一例です。残り枠を継続的に見ておきたいときは、/usageコマンドを都度実行するほか、カスタムステータスラインにrate_limitsフィールドを組み込む方法もあります。Desktop appでは、モデル選択の隣にある使用量リングをクリックすると同じ情報を確認できます。

待機がリセットを待たずに終わる他の場面

/rate-limit-optionsからのキャンセル以外にも、待機が再開を待たずに終わる場面があります。動きが変わる境目を知っておくと、「待っていたはずなのに再開しなかった」という戸惑いを避けられます。

  • 自分でプロンプトを送ると、待機を破棄してそちらを実行します
  • Claude Codeを終了すると、セッションを再開しても待機は復元されません
  • /loginでのアカウント切り替え、会話のクリアや巻き戻し、/resumeでの別セッション呼び出し、/teleport、/tuiでの再起動、Claude Desktopやバックグラウンドセッション・クラウドへの引き継ぎ、いずれも会話の主体が変わるため待機は終わります
  • UserPromptSubmit hookが再開プロンプトをブロックする、またはモデルに届く前に失敗すると、Claude Codeは再開が実行されなかったことを伝えます。続けるには自分でプロンプトを送ります

待機を止める操作と、機能そのものを切る設定は別物

キャンセルできたかどうかは、Automatic continue cancelledという行で確認できます。キャンセル後は、自分でプロンプトを送るか、/rate-limit-optionsから「待ってから自動再開する」をもう一度選ぶまで、何も再開しません。キャンセルしたリセット窓の間は、Claude Codeが自分で待機を始め直すこともありません。次のリセット窓は、キャンセルの影響を受けず改めて自動開始の対象になります。

くらべる

止め方は2種類ある

その場限り

いま動いている待機を止める

Esc(空プロンプト)、Ctrl+C、または「自動再開をやめる」を使います。以後の自動開始は変わりません。

設定

以後の自動開始を止める

/configの「Continue automatically at usage limit」をオフにします。止まるのはClaude Codeが自分で始めた待機だけで、/rate-limit-optionsから自分で選んで始めた待機は、設定をオフにしても数え続けます。

自動再開の既定値はtrueです。オフにする設定キーはautoContinueAtUsageLimitで、/configの画面から切るか、ユーザー設定ファイルに直接書きます。

{
  "autoContinueAtUsageLimit": false
}

/config autoContinueAtUsageLimit=falseというkey=value形式のコマンドでも同じことができ、-p実行でも使えます。ただしこの形式でtrueに戻すことはできません。無人実行を許可する側の設定だからです。戻すときは/configの画面操作を使います。

もう一点、この設定はユーザー設定・管理設定・--settingsフラグからしか読まれません。ユーザー設定などのどれもキーを持たず、プロジェクトやローカルの設定ファイルだけがこのキーを書いていると、無視されるのではなく機能そのものがオフとして扱われます。管理設定や--settingsでキーが指定されている間は、/configの行も表示されません。

Desktop appのCodeタブにも「Auto-continue when limits reset」という別のチェックボックスがあり、こちらはセッション上限のカードにしか出ません。週次上限のカードにはありません。CLIの設定とは独立しているため、両方使っている場合はそれぞれ個別にオフにする必要があります。

クレジット追加とプランアップグレードへの導線

メニューの「使用量クレジットを追加する」行は/usage-creditsと同じ入り口です。押したときに何が起きるかは、契約上の立場で変わります。

  • Pro/Maxの個人契約: claude.aiのSettings > Usageがブラウザで開き、クレジットのオンオフ・残高・今月の支出・月間の支出上限を確認できます
  • Team/Enterpriseで課金権限を持つメンバー: 組織のAdmin settings > Usageが開きます
  • 課金権限を持たないメンバー: 確認のうえで管理者へリクエストを送ります。この確認は対話セッションだけで出ます。-p実行とRemote Controlからでは、リクエストを送らず、対話セッションで実行するよう案内されます

セルフサーブのEnterpriseやEnterpriseトライアル、AWS Marketplace経由で契約したEnterpriseでは、/usage-creditsの実行にClaude Code v2.1.248以降が必要です。それより前のバージョンではUnknown command: /usage-creditsとして拒否されます。個人向けのクレジットの購入・管理手順はClaude利用クレジットの購入・管理方法にまとめています。

いま自分がどの枠にどれだけ使っていて、いつリセットされるかを先に確認したい場合は/usageが使えます。Claude Codeの/usageコマンドで見る使用量の内訳で画面構成を扱っています。上限に当たる前にリセット時刻の見当を付けておけば、/rate-limit-optionsで待つか止めるかを選ぶときの判断材料になります。

バージョンで対応状況が変わる

/rate-limit-options自体は以前から存在するコマンドですが、周辺の挙動はバージョンによって変わってきました。

あゆみ

関連する変更の流れ

  1. v2.1.211(7月15日)課金権限のないメンバーの/usage-creditsに確認ステップ

    それまでは確認なしで管理者へリクエストを送っていました。

  2. v2.1.222(8月4日)却下後の再リクエストが可能に

    それまでは、管理者がリクエストを却下すると、新しいリクエストの送信までブロックされていました。

  3. v2.1.234(8月17日)「待ってから自動再開する」の待機機能を追加

    これより前は、上限に当たると待つ選択肢自体がありませんでした。当時の変更点はClaude Code v2.1.234にあります。

  4. v2.1.248(8月27日)Enterprise系の一部で/usage-creditsが有効化

    セルフサーブEnterprise・Enterpriseトライアル・AWS Marketplace経由のEnterpriseが対象です。それ以前はUnknown command扱いでした。

  5. v2.1.284(9月28日)/rate-limit-optionsが/helpとコマンドメニューに掲載

    上限メッセージが案内するコマンドを探せるようにする変更です。同じ版で、最高位のMaxプランのユーザーに/upgradeを勧める警告が、/usage-creditsを指す形に直りました。

手元のバージョンが古く待機の行が出ないときは、まずアップデートを検討してください。

まとめ

セッション上限と週次上限はモデルを替えても戻らないため、自動の待機に任せるか、クレジットを足すか、プランを上げるかの選択になります。Opus/Sonnet限定枠のときだけ、別ファミリーへ替えて続ける手があります。待機のキャンセルとautoContinueAtUsageLimitのオフは別の操作で、設定を切っても、自分で選んで始めた待機は止まりません。

この記事を共有:XはてブLinkedIn