Claude Code が初めて使用量のメッセージで止まるのは、たいてい最悪のタイミングです。リファクタリングの途中で、エージェントがコンテキストに計画を抱えたまま、待たなければならなくなります。2 回目になると、制限が実際にどう機能しているのか、あとどれくらい余裕があるのか、事前に察知する方法はあるのか、と考え始めます。
このガイドでは、正確な数値を知っているふりをせずに、Claude Code の使用制限の形を説明します。Anthropic はプランごとに割り当てを決めており、これまでにも変更しています。具体的な数値を引用する記事はすべてスナップショットです。変わらないのはモデルの部分、つまりウィンドウ、リセット、そして困らないための習慣です。
使用量ウィンドウの仕組み
Claude サブスクリプションで Claude Code を使うと、使用量は月単位のまとまりではなくウィンドウで数えられます。実際には 2 つに出会います。
- 5 時間ウィンドウ。最初のリクエストで始まり、約 5 時間後にリセットされます。急な集中を抑えるもので、1 週間全体に余裕があっても、忙しい午前中だけで埋まることがあります。
- 週間ウィンドウ。より長い期間の総使用量に上限をかけます。5 時間ウィンドウに余裕があっても、週の分を使い切っていれば止まります。
- モデルごとの週間制限。一部のプランでは、最上位のモデルに別の週間割り当てがあります。モデルを切り替えると、消費するウィンドウが変わることがあります。
各ウィンドウにどれだけ収まるかは、プラン、使うモデル、コンテキストの長さによって変わります。大きなファイルをコンテキストに抱えた長いセッションは、短く焦点を絞ったセッションよりメッセージあたりのコストが高くなります。現在の数値は Anthropic のページが正です。この記事を含め、それ以外はすべて形の説明として扱ってください。
エージェントのワークフローが早く制限に達する理由
チャットとエージェントは別のワークロードです。エージェントは、あなたの 1 つのプロンプトの中で、ファイルを読み、コマンドを実行し、出力を読み、それを繰り返します。いくつかの要因がこれを増幅させます。
- 並列セッション。3 つの worktree で 3 つのエージェントを動かすと、1 つのアカウントを 3 倍の速さで消費します。
- 長いコンテキスト。朝から続いているセッションは、コンパクトされるまで毎ターン履歴を引きずります。
- サブエージェント。委任された作業も同じアカウントに数えられます。
- リトライのループ。失敗するテストで行き詰まったエージェントは、進まないままウィンドウを使い切ることがあります。
だからといって、エージェントの並列実行をやめるべきというわけではありません。ディスク容量や CI の時間と同じく、使用量が運用上の問題になり、ダッシュボードに値するということです。並列エージェントのガイドでは、並列化が追加の消費に見合うのはどんなときかを説明しています。
推測せずに使用量を追跡する
Claude Code 自体も、セッションの中から使用量と制限を教えてくれます。1 つのセッションならこれで十分です。しかし、複数のセッション、複数の worktree、複数のアカウントがあると、情報が各ターミナルに閉じ込められ、そのステータス表示も 1 セッションのスナップショットにすぎないため、うまくいきません。
Nethür は別の方法を取ります。各エージェントがディスクに保存しているローカルの使用量状態を読み取り(Claude Code なら ~/.claude、Codex なら ~/.codex、Gemini CLI や OpenCode などにもそれぞれ同等の場所があります)、ステータスバーに表示します。追加の API 呼び出しも追加の認証もありません。使用量ポップオーバーには、追跡中の各プロバイダーがプラン、ウィンドウごとのバー、次のリセット時刻とともに、最も厳しい制限が先頭に来るよう並び、どれかのウィンドウが 80% を超えると警告が表示されます。
エージェントが書いたものを読むので、表示がエージェント自身の記録より新しくなることはありません。更新されるのはエージェントが使用量を記録したときで、キーを押すたびではありません。表示されるウィンドウとプロバイダーの詳細は使用量追跡のドキュメントにあります。
リセットに合わせて計画する
ウィンドウが見えるようになれば、それに合わせて計画できます。形を変えられるのは 5 時間ウィンドウです。最初に使った時点から始まるからです。その日の最初のリクエストが 11 時なら、ウィンドウは午後の半ばにリセットされます。ちょうど最も重い作業に取りかかりたい時間かもしれません。
- ウィンドウのウォームアップ。時刻を指定すると、Nethür が最も安いモデルにごく小さなリクエストを送り、各 Claude と Codex アカウントの 5 時間ウィンドウを早めに開始します。そうすれば、本当に必要なときにリセットされます。
- 停止しきい値。5 時間ウィンドウと週間ウィンドウにそれぞれパーセンテージを設定します。チャットのアカウントがそれを超えると Nethür がそのチャットを一時停止し、最も重要な作業のために余裕を残します。
- リセット時の再開。制限に達したとき、あなたが気づくのを待たずに、チャットが最も近いリセットで自動的に再開できます。
複数のアカウントとプロバイダー
多くの開発者は複数のサブスクリプションを持っています。個人用と仕事用の Claude プラン、あるいは Claude プランと Codex プランです。ログアウトとログインで切り替えるのは遅く、実行中のセッションも中断されます。Nethür は各アカウントを分けて保持し、ワンクリックでアクティブなアカウントを切り替えます。新しいセッションは新しいアカウントを使い、すでに動いているセッションは再起動するまで開始時のアカウントを使い続けます。仕組みはアカウントのホットスワップで説明しており、Claude Code にも同様に適用されます。
サブスクリプションに優先順位を付けることもできます。あるプロバイダーのアカウントが制限に達すると、チャットは会話全体を持ったまま次のプロバイダーに移ります。すべて使い切った場合は、最も近いリセットで自動的に再開します。使うのは自分に権利があるアカウント、つまり自分の個人用と仕事用のプランにとどめ、各プロバイダーの規約を守ってください。
制限への対処方法の比較
| 方法 | 可視性 | 制限の前 | 制限に達したとき |
|---|---|---|---|
| メッセージが出るまで待つ | 止まるまで何も見えない | 何もなし | リセットを待ち、コンテキストを作り直す |
| 各セッションで確認する | 一度に 1 セッション | 手動で確認 | ログアウトとログインでアカウントを切り替える |
| ステータスラインや追跡スクリプト | 1 アカウント、1 マシン | 画面上の数値 | 依然として手動 |
| Nethür | 追跡中のすべてのプロバイダーとアカウントを 1 つのポップオーバーで | 警告、停止しきい値、ウィンドウのウォームアップ | アカウントのホットスワップ、プロバイダーのフェイルオーバー、リセット時の再開 |
避けるべき落とし穴
- 古い数値を信じる。プランの制限は変わります。前の四半期のフォーラム投稿ではなく、現在のプランを確認してください。
- 週間ウィンドウを無視する。週の分を使い切っていれば、新しい 5 時間ウィンドウは役に立ちません。両方を見てください。
- 行き詰まったエージェントを動かし続ける。同じ失敗でループするエージェントは、無駄に使用量を消費します。止めてエラーを読み、より良いプロンプトを渡します。
- コンパクトしない。長いセッションはターンあたりのコストが高くなります。タスクが変わったら新しいセッションを始めるか、コンパクトします。
- コストの見積もりを請求書だと思う。ローカル状態から出したコストの数値はすべて見積もりです。正はプロバイダーのコンソールです。
チームについて
チームでは、制限は共有キーではなく個人に属するべきです。Nethür では各メンバーが自分のサブスクリプションでログインするので、使用量、制限、フェイルオーバーはアカウントごとになり、誰かの忙しい 1 日がほかの人を止めることはありません。Nethür はモデルへのアクセスを再販しません。自分のアカウントが何をしているかを見せるだけです。チームメイトのセッションを引き継いでも、そのセッションはプロバイダーとアカウントを保ったままなので、どの使用量を消費しているかは明確です。残りはチーム向けガイドで説明しています。
シンプルな習慣
重いタスクを始める前に使用量を確認しましょう。終わってからではありません。自分の作業がどれくらいの速さでウィンドウを消費するか分かるまでは、エージェントは 5 つではなく 2 つにします。最も生産的な時間の前にウィンドウをウォームアップし、急ぎの作業の余地を残す停止しきい値を設定し、最初のアカウントを使い切った日のために 2 つ目のアカウントやプロバイダーを用意しておきます。制限は、見えるようになった時点で驚きではなくなります。



