続報：Claude Codeの週間上限、使い切る前に止める道具が相次ぐ

「週間上限を燃やし尽くす前に、止めたい」。Hacker Newsに投稿された小さなツール「Peras」は、Claude CodeとCodexの使用を、上限を消費し切る前に一時停止するというものでした[1]。Claude Codeには5時間のセッション制限と週間上限という二重の使用制限があります。熱心に使うほど「いつ上限が来るか」が不安になります。集中してコードを書いている最中に上限に達すれば、リセットまで待つしかありません。前回の記事ではClaude Codeの実行環境の分離を追いました。今回はその外側、「上限との付き合い方」を巡る新しい動きです。使用量の可視化から自動ペース管理まで、道具が相次いで登場しています。しかも、ただのカウンタではなく「ペース配分」という発想まで現れました。

まず紹介したいのは、Windows 11向けの常駐アプリ「OpenTokenUsage」です[2]。通知領域に常駐し、複数のAIコーディングサービスの契約状態をひと目で表示します。Claude CodeやCodex、Cursorなどに対応します。セッションと週間の上限、クレジット残量、リセット時刻まで一度にわかります。各上限が「今のペースで足りるか」も示します。ダッシュボードを開いたり暗算したりする必要がありません。表示はパーセント、バー、リングから選べます。タスクバーに各社のロゴと使用率を並べる実験的なストリップ機能もあります。パネルはトレイやショートカットから開け、他のウィンドウより上にピン留めもできます。

閾値を超えたときやリセット時には通知が届きます。プロバイダの障害情報を示すバッジも備えます。通知音は内蔵のものから好みに変えられます。エラー時の対処は「ワンクリック修正」にまとめられています。ログインコマンドの実行やAPIキーページを開くなどの動きです。日本語を含む11言語に対応します。導入は、Windows公式のインストール手段「WinGet」一発で済みます。アプリ内での自己更新にも対応します。外観はすりガラス風の効果(Mica)やアクセントカラーに対応します。通信はSOCKS5やHTTPプロキシ経由にも対応します。各プロバイダはプラグイン式です。ローカルAPIを通じれば、PC上の他アプリからも使用量を読み取れます。

一方、もっと理詰めなアプローチが「usage-auto-pause」です[3]。週の使用量を理想ペースと比較し、速すぎる場合は自動的に待機させます。待機が入るのはツールの処理の区切りです。週間上限を「いつまでにどれだけ使ってよいか」へ分解する、シンプルな考え方です。168時間の週なら、半分が経過した時点で50%消費が「ペース通り」です。55%使っていたら8.4時間の「リード」、つまり使いすぎと判定されます。ここから4.4時間待てば、リードは+4時間まで戻る計算です。停止と再開の往復を避けるため、+8/+4という差(ヒステリシス)を設けています。これらはデフォルトのルールで、Claudeではセッションごとの閾値設定にも対応します。

待機はローカルで動くフックが担います。フックは、処理の合間に割り込んで動く仕組みです。使用枠の確認はポーリングで行います。ポーリングとは、定期的に状態を問い合わせる方法です。モデルへのリクエストを伴わないため、待機中に推論枠を余計に消す心配はないとしています。動作確認用のスクリプトに加え、ブラウザでメーターを表示するデモも同梱されています。いずれも合成データで動き、認証情報を読まない設計です。

ただし、この自動待機には落とし穴もあります。解説によると、ClaudeとCodexでは失敗時の挙動が異なるのです[3]。Codexは週間データが古くなっても、新しいデータで確認できるまで待機状態(ホールド)を維持します。ところがClaudeは、最後の既知の読み取りがトリガー以上を示す間だけホールドを維持します。更新が1回失敗すると、+4〜+8時間帯のホールドが解除されることがあります。通信の再試行制御(HTTPバックオフ)や使用枠のリセットが起きた場合も同様です。「止めたつもりが、実は止まっていない」場面が生じうるわけです。また、この計算は週間上限をフラットな予算として扱うもので、今後の作業予定を予測するものではありません。他のセッションが同じ枠を消費すれば、再開時刻はその分後ろへずれます。発端となったPerasはHacker Newsで1ポイント・コメント0件と、まだ注目はごく限定的なようです[1]。

そもそも上限の仕組み自体が複雑で、解説記事が複数出ています。週間上限の仕組みとリセットのタイミングを解く記事[4]や、5時間ウィンドウと週間上限をまとめた記事[5]があります。Pro・Max・Opusといったプラン別の上限を解説する記事[6]、上限と料金を平易な言葉で整理する記事[6]、レート制限と使用枠をまとめた記事[6]も並んでいます。「週間上限はいつ戻るのか」「プランごとにどこまで使えるのか」。こうした初歩的な疑問に答える記事がこれだけ並ぶこと自体、レート制限への関心が広い層に及んでいる証拠のようです。

使用制限の管理ツールが揃い始めたのは、Claude Codeが日常の推論環境として定着した裏返しと思われます。上限を「避ける」のではなく「ペース配分する」。この発想への変化は、AIコーディングの使い方が成熟してきたことを示しているのでしょう。上限の存在自体は変わらない以上、こうした道具は当面必要とされ続けるはずです。今後はこうした道具が公式機能に取り込まれるのかも気になるところです。ツールに頼る場合も、挙動の違いを理解した上で使うのが安全なようです。