Claude Code の利用枠を使い切ったらどうする?Max 20x の5時間ウィンドウと週間上限の仕組み、足りなければ API Key に切り替え

Claude Code の利用枠を使い切ったら、まず Claude の5時間制限なのか週間上限なのかを切り分けます。Claude Max 20x の週間上限は Pro の20倍ではありません。本記事では /usage と /status の実測結果、利用枠の節約方法、Claude Code の usage limit を使い切った後に API Key へ切り替える設定を紹介します。

10 分钟阅读
Claude Code の利用枠を使い切ったらどうする?Max 20x の5時間ウィンドウと週間上限の仕組み、足りなければ API Key に切り替え

Claude Code の利用枠を使い切ったらどうするか。まず、どちらの制限にかかったのかを切り分けます。Pro と Max にはどちらも「5時間ウィンドウ」と「週間上限」という2種類の制限があり、Claude の Web 版、デスクトップ版、Claude Code は同じ利用枠を共有しています。Max 20x の「20倍」は、公式では各5時間ウィンドウが Pro の20倍という意味で、1週間の総量が20倍になるわけではありません。5時間ウィンドウを使い切った場合は、リセットを待つだけで済みます。週間上限を使い切って、それでも作業を止めたくない場合は、Claude Code を API Key に切り替えます。従量課金になり、サブスクリプションの5時間や週間の上限には縛られません。

結論

状況対処法
5時間ウィンドウを使い切ったウィンドウのリセットを待つか、/compact の実行、新しいセッションの開始、Sonnet 5.5 への切り替えで節約しながら使います
週間上限を使い切った毎週決まったリセット時刻を待つか、Claude Code を API Key に切り替えて作業を続けます
残りの枠を知りたいサブスクリプションのアカウントでは /usage と公式サイトの Settings > Usage を確認します。API Key を使っている場合、/usage に表示されるのは今回のセッションの使用量だけです
Anthropic ヘルプセンターの原文:「Paid plans have two types of usage limits: a session limit that resets every five hours, and weekly limits that reset once every week.」出典:How do usage and length limits work?
「20x」が指すのは5時間ウィンドウです。原文:「Max 20x includes 20 times the Pro plan's per-session usage allowance.」「Max plans also have a weekly usage limit that applies across all models.」出典:What is the Max plan?
Claude と Claude Code は利用枠を共有します。原文:「Both Pro and Max plans have a five-hour session limit and a weekly limit. Max plans also have a separate weekly limit for Fable. These limits are shared across Claude and Claude Code, meaning all activity in both tools counts against the same limits.」出典:Use Claude Code with your Pro or Max plan

Max 20x の週間上限は Pro の何倍なのか

公式に書かれているのは5時間ウィンドウが20倍という点だけで、週間上限の倍率は公表されていません。ユーザーの実測では、20を大きく下回る結果が出ています。

  • ユーザーの報告によると、Max 20x の週間上限は「測ってみたところ Pro のおよそ9.7倍」で、「5時間ウィンドウと週間上限は別々の関門」とのことです(@JkwuRmsl)。
  • ユーザーの報告によると、「The "20x" doesn't mean you get 20 times more Claude for the whole week. It only means each 5 hour session is 20 times bigger than Pro's.」とのことで、20x の週間上限は Max 5x のおよそ2倍にすぎないとも述べています(@buildwithhassan)。

そのため、Max 20x にアップグレードする前に、普段ぶつかっているのが5時間ウィンドウなのか、週間上限なのかをはっきりさせておく必要があります。5時間ウィンドウにだけぶつかるなら 20x は大いに役立ちます。週間上限によくぶつかる場合、増える余裕は名前から受ける印象ほど大きくありません。

残りの枠を確認する方法

方法確認できる内容
/usage今回のセッションの使用量。サブスクリプションのアカウントでは、プランの利用枠の使用状況も表示されます
/statusバージョン、モデル、アカウント、接続の情報
公式サイトの Settings > Usage次回のリセット時刻
Claude Code 公式ドキュメントの原文:/usage「Show session cost, plan usage limits, and activity stats. On a Pro, Max, Team, or Enterprise plan, includes a breakdown of what counts against your plan limits」、/status「Open the Settings interface on the Status tab, showing version, model, account, and connectivity」。/cost と /stats はどちらも /usage のエイリアスです。出典:Claude Code Docs:Commands。
ヘルプセンターの原文:「The weekly limit resets at a fixed time each week that is assigned to your account. Your reset day and time stay the same regardless of when you start using Claude or when your subscription begins … You can see your next reset time in Settings > Usage.」

実測:API Key 使用時に /status と /usage に表示される内容

Claude Code 2.1.308 を使い、クリーンで独立した HOME に置いたグローバルの settings.json で AI Code With の API Key を接続して、この2つのコマンドを実行しました。

起動時には、タイトルバーのモデル名の後ろに、API 課金であることがそのまま表示されます。

text
Claude Code v2.1.308
Opus 5.5 · API Usage Billing

対話モードで /status を入力すると、3秒以内に Status ページが開きます(キャプチャ)。

text
Version:                    2.1.308
Auth token:                 ANTHROPIC_AUTH_TOKEN
Anthropic base URL:         https://api.aicodewith.ai
Model:                      Default (claude-opus-5-5)
Setting sources:            User settings

一言だけ質問してから /usage を入力すると、3秒以内に Usage ページが開きます(キャプチャ。金額の行は省略しています)。

text
Session
Total duration (API):  5s
Total duration (wall): 29s
Total code changes:    0 lines added, 0 lines removed
Usage by model:
     claude-opus-5-5:  8 input, 138 output, 10.4k cache read, 2.6k cache write

結論:API Key 経由の場合、/usage に表示されるのは今回のセッションの統計だけで、サブスクリプションの 5 時間ウィンドウや週間クォータの進捗バーは出てきません。/status には ANTHROPIC_AUTH_TOKEN とカスタムアドレスが表示され、サブスクリプションアカウントの情報はありません。

非対話モードの claude -p でこの 2 つのコマンドを実行すると、結果が異なります:

text
/status isn't available in this environment.

claude -p "/usage" は 0.4 秒で返り、表示されるのはセッションの統計だけです(この時点ではまだリクエストを送っていないため、すべて 0 です):

text
Total duration (API):  0s
Total duration (wall): 0s
Total code changes:    0 lines added, 0 lines removed
Usage:                 0 input, 0 output, 0 cache read, 0 cache write

スクリプト内でクォータを確認したい場合は /usage を使ってください。/status は対話モードでしか確認できません。

最近、消費が速い理由

1. SemiAnalysis の報道によると、一部の Max アカウントで A/B テストが行われています。 SemiAnalysis は 10 月 22 日に X へ次のように投稿しました:「We detected an A/B test going on that DECREASES your monthly API-value by ~20% while INCREASING your 5h usage limits by ~20%. This only affects SOME」(SemiAnalysis の元投稿)。報道によると、2 つの Max 20x アカウントを比較したところ、一方は 5 時間ウィンドウが約 19% 大きく、週間クォータは約 20% 少なかったとのことです(Tech City Authority)。

Anthropic はこのテストを認めていません。報道によると、SemiAnalysis の投稿より前に、Anthropic の Boris Cherny 氏はユーザーに「No changes on our end」と返信し、Claude Code チームの Lydia Hallie 氏も「our limits haven't changed」と述べています(Tech City Authority)。どちらの返信も SemiAnalysis の投稿より前のものです。

影響が大きいのはどんな人か:5 時間ウィンドウは 1 日に何度もリセットされるため、ヘビーユーザーが先に突き当たるのは週間クォータです。週間クォータが 20% 減れば、それは文字どおりの減少です。一方、たまに 5 時間ウィンドウに達する程度の人は、むしろ余裕が増えたと感じるでしょう。

2. 長い間放置した長い会話の再開はコストが高い。 ユーザーの報告によると、Claude Code クライアントは長い会話を再開する前に、次のような警告を表示したそうです(@pumpccc、Opus 5.5):

text
This conversation has been inactive for 3h 4m and is 358.4k tokens long. Resuming it will use about 7% of your 5-hour usage limit.

つまり、35 万トークンの古い会話を続きから再開するだけで、まず 5 時間ウィンドウの約 7% を消費してしまいます。

3. クォータは Web 版と Claude Code で共有されています。 日中に Web 版でたくさん会話すると、夜に Claude Code で使える分が減ります。

クォータを節約する方法

  1. 長い会話はまず /compact。 公式の説明では、会話を要約して空き容量を確保するコマンドです。会話がすでに長くなっているときは、先に圧縮してから続けましょう。アイドル時の自動圧縮のオンオフについては「Claude Code Idle Compaction とは」をご覧ください。
  2. 長い間放置した長いセッションは、新しく開き直す。 数十万トークンの古い会話をそのまま再開せず、/clear で新しいセッションを開始し、要点を引き継ぎファイルにまとめてから作業を続けてください。やり方は「Claude Code の作業を途中で Codex に渡すには?handoff.md でコンテキストを引き継ぐ」を参照してください。
  3. 日常のタスクは Sonnet 5.5 に切り替える。 /model claude-sonnet-5-5 で切り替え、難しい問題のときだけ Opus 5.5 に戻します。選び方は「Claude Code はどのモデルを使うべきか」と「Claude Sonnet 5.5 vs Opus 5.5」を参照してください。
  4. 並列のサブ Agent を増やしすぎない。 サブ Agent はそれぞれ独立したコンテキストを持つため、同時にたくさん起動すると、クォータの消費も積み重なります。
  5. Fast Mode に注意。 有効化の方法と制限は「Claude Opus 5.5 Fast Mode の使い方」を参照してください。
ヘルプセンターの原文:「Your usage is affected by several factors, including the length and complexity of your conversations, the features you use, which Claude model you're chatting with, and the effort level you've selected.」

クォータが足りないとき:API Key に切り替える

サブスクリプションのクォータを使い切った場合、公式が案内している選択肢は、リセットを待つ、usage credits を購入する、または Console アカウントに切り替えて API 経由で使う、のいずれかです。Claude Code を AI Code With の API Key に接続する方法もあります。従量課金で、サブスクリプションの 5 時間ウィンドウや週間クォータの制限を受けません。

ヘルプセンターの原文:「Switch to a Claude Console account and purchase API usage credits for intensive coding sprints.」「Wait until your usage limits reset.」出典:Use Claude Code with your Pro or Max plan

ステップ 1:API Key を作成する

API Key を作成 →

料金を見る →

ステップ 2:グローバルの settings.json を書く

~/.claude/settings.json を開き、env に次の内容を入力します(ANTHROPIC_BASE_URL には /v1 を付けません):

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}

Claude Code を再起動し、タイトルバーに「API Usage Billing」と表示され、/status の Auth token の行が ANTHROPIC_AUTH_TOKEN になっていれば、Key 経由で動作しています。各フィールドの説明とよくある質問は「Claude Code でサードパーティ API を使うには?Base URL、API Key、モデル設定のチュートリアル」をご覧ください。

サブスクリプションに戻したい場合は、settings.json からこの 2 行を削除し、ターミナルで claude login を実行して、Pro または Max アカウントでログインします。

よくある質問

週間クォータはいつリセットされますか?

毎週決まった時刻にリセットされます。この時刻はアカウントごとに割り当てられており、使い始めた時期やサブスクリプションを契約した時期とは関係ありません。公式サイトの Settings > Usage で次回のリセット時刻を確認できます。

Claude の 5 時間制限は、いつから数え始めますか?

公式には、5 時間ウィンドウは「resets every five hours」と記載されています。ウィンドウを使い切ったら、リセットを待つだけです。その間は、クォータが共有されているため、Claude の Web 版も Claude Code も制限を受けます。

サブスクリプションと API Key は同時に使えますか?

同時に使われるのは、Claude Code ではどちらか一方だけです。settings.json に ANTHROPIC_AUTH_TOKEN とアドレスを設定していれば Key 経由になり、削除して claude login でサブスクリプションアカウントにログインすればサブスクリプション経由になります。日中はサブスクリプションを使い、使い切ったら Key に切り替える、という使い方もできます。

同じ Key を Codex でも使えますか?

使えます。~/.codex/config.toml にアドレスと Key を設定するだけです。詳しくは「Codex config.toml 設定ガイド」をご覧ください。Codex 自体のクォータルールについては「Codex の料金体系と、クォータが速く減る理由」を参照してください。

参考資料