「週間上限を燃やし尽くす前に、止めたい」。Hacker Newsに投稿された小さなツール「Peras」は、Claude CodeとCodexの使用を上限消費前に一時停止する、というものでした[1]。Claude Codeには5時間のセッション制限と週間上限という二重の使用制限があり、熱心に使うほど「いつ上限が来るか」が不安になります。集中してコードを書いている最中に上限に達すれば、リセットまで待つことになります。前回の記事ではClaude Codeの実行環境の分離を追いましたが、今回はその外側、「上限との付き合い方」を巡る新しい動きです。使用量の可視化から自動ペース管理まで、道具が相次いで登場しています。しかも、ただのカウンタではなく「ペース配分」という発想まで現れました。
まず紹介したいのは、Windows 11向けの常駐アプリ「OpenTokenUsage」です[2]。通知領域に常駐し、Claude CodeやCodex、Cursorなど複数のAIコーディング契約の状態をひと目で表示します。セッションと週間の上限、クレジット残量、リセット時刻まで一度にわかる仕組みです。各上限が「今のペースで足りるか」も示すため、ダッシュボードを開いたり暗算したりする必要がありません。表示はパーセント、バー、リングから選べ、タスクバーに各社のロゴと使用率を並べる実験的なストリップまで用意されています。パネルはトレイやグローバルショートカットから開け、他のウィンドウより上にピン留めもできます。閾値を超えたときやリセット時の通知、プロバイダの障害情報を示すバッジも備えます。通知音は内蔵のものから自分の好みに変えられます。エラー時の対処は、ログインコマンドの実行やAPIキーページを開くといった「ワンクリック修正」にまとめられています。日本語を含む11言語に対応し、WinGet一発でインストール、アプリ内で自己更新までこなします。外観はMica効果やアクセントカラーに対応し、SOCKS5やHTTPプロキシ経由の通信にも対応します。各プロバイダはプラグイン式で、127.0.0.1:6736のローカルAPIを通じればPC上の他アプリからも使用量を読み取れます。
一方、もっと理詰めなアプローチが「usage-auto-pause」です[3]。このリポジトリは、週の使用量を理想ペースと比較し、速すぎる場合はツールの処理境界で自動的に待機する仕組みを公開しています。週間上限を「いつまでにどれだけ使ってよいか」へ分解する、シンプルな考え方です。168時間の週なら、半分が経過した時点で50%消費が「ペース通り」。55%使っていたら8.4時間の「リード」、つまり使いすぎと判定されます。ここから4.4時間待てば、リードは+4時間まで戻る計算です。停止と再開の往復を避けるため、+8/+4の差（ヒステリシス）を設けている点も工夫です。これらはデフォルトのルールで、Claudeではセッションごとの閾値設定にも対応しています。待機はローカルで動くフックが担い、クォータ確認はモデルへのリクエストを伴わないポーリングで行うため、待機中に推論枠を余計に消す心配はないとしています。動作確認用のスクリプトに加え、ブラウザでメーターを表示するデモ（127.0.0.1:8765）も同梱され、いずれも合成データで動き、認証情報を読まない設計です。
ただし、この自動待機には落とし穴もあります。解説によると、ClaudeとCodexでは失敗時の挙動が異なるのです[3]。Codexは週間データが古くなっても、新しいデータで確認できるまでホールドを維持します。ところがClaudeは、最後の既知の読み取りがトリガー以上を示す間だけホールドを維持します。更新が1回失敗したり、HTTPバックオフやクォータウィンドウのリセットが起きたりすると、+4〜+8時間帯のホールドが解除されることがあるのです。「止めたつもりが、実は止まっていない」場面が生じうるわけです。また、この計算は週間上限をフラットな予算として扱うもので、今後の作業予定を予測するものではありません。他のセッションが同じ枠を消費すれば、再開時刻はその分後ろへずれます。発端となったPerasはHacker Newsで1ポイント・コメント0件と、まだ注目はごく限定的なようです[1]。
そもそも上限の仕組み自体が複雑で、解説記事が複数出ています。週間上限の仕組みとリセットのタイミングを解く記事[4]、5時間ウィンドウと週間上限をまとめた記事[5]、Pro・Max・Opusといったプラン別の上限を解説する記事[6]、上限と料金を平易な言葉で整理する記事[6]、レート制限と使用枠をまとめた記事[6]と、切り口はさまざまです。「週間上限はいつ戻るのか」「プランごとにどこまで使えるのか」といった初歩的な疑問に答える記事がこれだけ並ぶこと自体、レート制限への関心が広い層に及んでいる証拠のようです。
使用制限の管理ツールが揃い始めたのは、Claude Codeが日常の推論環境として定着した裏返しと思われます。上限を「避ける」のではなく「ペース配分する」という発想への変化は、AIコーディングの使い方が成熟してきたことを示しているのでしょう。上限の存在自体は変わらない以上、こうした道具は当面必要とされ続けるはずです。今後はこうした道具が公式機能に取り込まれるのかも気になるところです。ツールに頼る場合も、挙動の違いを理解した上で使うのが安全なようです。
RECENT COMMENTS