リファクタリングの途中で「usage limit reached」と出る。これほど作業の流れを断ち切るものはそうありません。Claude Codeの上限は、見えてさえいれば予測できるものです。このガイドでは、ウィンドウのしくみ、標準機能での確認方法、そしてMacで上限を常に見えるようにする方法を説明します。
Claude Codeの使用量上限のしくみ
Claudeのサブスクリプションプランでは、Claude Codeの使用量はトークン単位ではなくウィンドウ単位で計測されます。
- 現在のセッション（5時間ウィンドウ）。 使用量は、最初のメッセージから始まる約5時間のローリングウィンドウで集計されます。リセットされると、またウィンドウ全体を使えるようになります。
- 週間上限。 すべてのモデルを合わせた、7日間の別枠の上限です。
- モデル別の週間上限。 プランによっては、Opusなど特定のモデルに週間上限が設定されています。
Anthropicは正確な数値を公開しておらず、上限はプランによって異なります。Max 5xとMax 20xでは、セッションあたりの使用量がProの5倍と20倍です。使用量は同じアカウントのClaudeのチャットと共有されます。Webでは、claude.aiの設定 → 使用量でも確認できます。実務上のポイントは、時計が2つあることです。5時間の時計が午後の作業を、週間の時計がその週の作業を左右します。
サブスクリプションではなくAPIキーでClaude Codeを使っている場合は、トークン単位の従量課金なので、これらのウィンドウは適用されません。支出はAnthropic Consoleで確認できます。
Claude Code内で使用量を確認する
Claude Codeの中で、次のコマンドを実行します。
/usage
現在のセッションと週間上限をどれだけ使ったか、いつリセットされるかが表示されます。正確ですが、自分で確認しようと思い出す必要があり、そのターミナルを見ている間しか表示されません。
Macで上限を常に表示する
Vibe Consoleは、コマンドを打たなくてもClaude CodeとCodexの使用量を常に表示します。
- ノッチとツールバーのリング。 プロバイダーごとに1つのリングが、現在のウィンドウの使用率を示します。オプションで、週間上限を細い2本目の弧として表示できます（設定：オフ、内側、外側）。
- ホバーで詳細を表示。 カードには、現在のセッション、全モデル共通の週間上限、OpusやSonnetなどモデル別の上限が、それぞれのリセット時刻とともに表示されます。
- アラート。 上限が80%を超えたとき、さらに100%に達したときに、ウィンドウごとに1回ずつmacOSの通知が届きます。上限がリセットされると、ノッチのカードとサウンドで「また使えます」と知らせます。気にしないプロバイダーはミュートできます。
- メニューバー。 アイコンの代わりに、選んだプロバイダーの上限をメニューバーに表示することもできます。
作業中は使用量が1分ごとに更新され、リングをクリックすればすぐに更新できます。
数値の取得元
Claudeの使用量を表示するために、Vibe ConsoleはMac上のClaude Codeのサインイン情報を読み取り、Anthropicに使用量を問い合わせます。/usageが表示するのと同じデータです。許可するかどうかは、最初に一度だけmacOSが確認します。サインイン情報はMacの中にとどまり、送信先はAnthropicだけです。どのプロバイダーを読み取るかは設定 → アカウントで選べます。詳しくはプライバシーポリシーをご覧ください。
Codexの使用量上限
Codexのプランも、メインの5時間ウィンドウと週間ウィンドウで使用量を計測します。Vibe ConsoleはClaudeの隣に同じ形で表示するので、余裕のあるエージェントに作業を回せます。
上限を長持ちさせるコツ
- 使用率はリセット時刻とセットで見る。 ウィンドウの残りが1時間で60%使用なら問題ありません。開始10分で60%なら要注意です。
- 簡単な作業には軽いモデルを使う。 いちばん大きなモデルは、計画や難しい問題のために取っておきましょう。
- コンテキストを軽く保つ。 長い会話はクリアするか圧縮し、リポジトリ全体ではなく重要なファイルをエージェントに示します。トークンを節約するskillも役立ちます。エージェントのskillをインストールする方法をご覧ください。
- 並列作業はウィンドウに合わせて計画する。 複数のエージェントは、その数だけ速くウィンドウを消費します。エージェントを並列で動かす方法も参考にしてください。
- プロバイダー間で作業を分ける。 Claudeが上限に近く、Codexに余裕があるなら、レビューや小さなタスクをCodexに任せましょう。
よくある質問
Claude Codeの使用量上限のウィンドウはどれくらいの長さですか？
セッションのウィンドウは最初のメッセージから約5時間で、それとは別に週間上限があります。正確なリセット時刻は/usageかリングのホバーカードで確認してください。
上限に達するとどうなりますか？
Claude Codeが、セッションまたは週間の上限に達したことと、いつリセットされるかを知らせます。これらの上限はモデルを切り替えても解消しませんが、Opusのようなモデル別の上限なら切り替えが有効です。作業を続けるには、リセットを待つか、プランをアップグレードするか、/usage-creditsを実行して使用量クレジットで続行します。
Vibe Consoleで上限が変わることはありますか？
いいえ。読み取って表示するだけです。上限を決めるのは、あなたのプランとエージェントです。
14日間無料で試せます。Vibe Consoleをダウンロード。