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

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

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

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

/rate-limit-optionsはコマンドメニューの候補一覧には出てきません。存在は知っていても、/rateまで打って補完で探そうとすると見つからない仕組みです。動かすにはフルネームで入力します。

> /rate-limit-options

実行にはclaude.aiのサブスクリプションでのサインインが必要です。APIキー認証では使えません。メニューが開くと、次の系統の行が並びます。

• 「待ってから自動再開する」: リセット時刻まで開いたセッションで待ち、自動で作業を再開します
• 「自動再開をやめる」: 待機中の自動再開をキャンセルします
• 「使用量クレジットを追加する」または「プランをアップグレードする」: 今すぐ再開したいときの導線です

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

メニューが自動で開く場面と、自分で呼ぶしかない場面

上限に当たるたびに毎回このメニューが自動で出るわけではありません。状況によって、自動で開く・自分で呼ぶ必要がある・そもそも提供されない、の3段階に分かれます。

自動で開かない場面のうち、上の表で「メニューから手動で選ぶ」と書いた状況では、自動継続の設定がオンでも上限に当たった時点で一度だけメニューが開きます。そこで「待ってから自動再開する」行を選べば、以降は自動で開いたときと同じ待機に入ります。

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

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

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

リセット時刻になると表示がcontinuing shortlyに変わり、続けてUsage limit reset · continuing automaticallyとなって、Claude Codeが決まった再開プロンプトを送って作業を続けます。直前に送った自分のメッセージを送り直すわけではありません。パソコンがスリープしていた場合は挙動が変わります。スリープが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は再開が実行されなかったことを伝えます。続けるには自分でプロンプトを送ります

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

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

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

{
  "autoContinueAtUsageLimit": false
}

/config autoContinueAtUsageLimit=falseというkey=value形式のコマンドでも同じことができますが、この形式でtrueに戻すことはできません。無人実行を許可する側の設定だからです。戻すときは/configの画面操作を使います。もう一点、この設定はユーザー設定・管理設定・--settingsフラグからしか読まれません。プロジェクトやローカルの設定ファイルにこのキーを書いても無視されるのではなく、機能そのものがオフとして扱われる点に注意してください。Desktop appのCodeタブにも「Auto-continue when limits reset」という別のチェックボックスがあり、こちらはセッション上限のカードにしか出ません。CLIの設定とは独立しているため、両方使っている場合はそれぞれ個別にオフにする必要があります。

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

メニューの「使用量クレジットを追加する」行は/usage-creditsと同じ入り口です。Pro/Maxの個人契約なら、claude.aiの利用量設定画面がブラウザで開き、クレジットのオンオフ・残高・今月の支出上限をその場で確認できます。Team/Enterpriseで課金権限を持つメンバーなら組織の利用量設定が開き、権限を持たないメンバーなら確認のうえで管理者へのリクエストを送る動きになります。セルフサーブの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自体は以前から存在するコマンドですが、中身は版によって変わってきました。

待機機能がいつ入ったかを追いたい場合は、Claude Code v2.1.234で当時の変更点をまとめています。手元のバージョンが古く待機の行が出ないときは、まずアップデートを検討してください。

まとめ

/rate-limit-optionsは、使用量上限に止められたあとの動き方を自分で選び直すためのコマンドです。自分のターミナルで対話的に使っていれば大半の場合は自動でメニューが開きますが、Remote Control・agent teamのteammateセッション・週次上限のような先のリセット・バックグラウンド実行では自動で開かず、必要なら自分で呼び出します。待機のキャンセルとautoContinueAtUsageLimitのオフは別の操作で、後者は今動いている待機には影響しません。この違いを知らずに設定だけオフにして「待機が止まらない」と困る、という遠回りを避けられます。