Claude Token Pace — Development skill for Claude Code

claude-token-pace

Claude Code の**使用率**（5時間枠・7日枠などのレート制限）を、ブラウザのグラフで見るツールです。**標準ペースとの差**を色と数値で示すので、「このペースで枠を使い切ってしまわないか」が一目で分かります。**ローカルだけで動き、集めた使用量データは手元から出ません。**

*日本語 | [English](README.en.md)* ・ バージョン **0.4.0**（SemVer）

[](https://github.com/k-tashiro-arent/claude-token-pace/actions/workflows/ci.yml) [](https://github.com/k-tashiro-arent/claude-token-pace/releases) [](LICENSE)


すぐ試す

curl -fsSL https://raw.githubusercontent.com/k-tashiro-arent/claude-token-pace/main/bootstrap.sh | bash

インストールしたら、Claude Code で `/tpw` と打つと既定のブラウザでビューアが開きます。対応環境と導入の詳細は[動作環境](#動作環境)・[インストール](#インストール)を参照してください。

この文書では次の 4 語を使い分けます。

• 枠 — 使用量の上限 1 本ぶん。「上限の量」と「どれだけの期間ぶんか」の組です。5h（5 時間ぶん）と 7d（7 日ぶん）があり、環境によって月次クレジット枠 1mo（暦月ぶん・上限は金額）や Codex の枠が加わります。
• 期間 — 枠がリセットされてから次にリセットされるまでの区間。5h 枠なら 5 時間、7d 枠なら 7 日、1mo 枠なら 1 か月です。区切りごとに使用率が 0 に戻ります（Codex の枠だけは取り方が違います。→Codex のレート枠）。
• 標準ペース — その枠を期間ちょうどで使い切るように配分したときの、各時点の使用率。いまの使用率がこれより高ければ先行（使いすぎ）、低ければ遅れ（余裕がある）と読みます。 増え方は 2 通りです。期間が 1 日以内の枠は経過時間に比例して増え、それより長い枠は就業時間（既定は平日 9:00–18:00 JST。→就業時間）の間だけ、その経過に比例して増えます。
• パネル — 枠 1 つぶんの表示。グラフと、その上のヘッダからなります。

グラフの見方

• used 線: 枠の使用率（%）。標準ペースとの差に応じて 青（遅れ）〜灰（標準どおり）〜赤（先行）に着色します（Codex のパネルだけ遅れ側が緑）。
• 標準ペース（点線）: 上で定義した標準ペース。
• now 線: 現在時刻（毎秒更新）。ホバーすると、その時点の使用率・標準ペース・pace の値が出ます。
• 予測の帯（任意）: リセットまでに使用率がどこまで伸びそうかを、確率の帯として重ねて描きます。別ツールが予測を書き出している環境でだけ出ます（→使用量の予測）。
• パネルのヘッダ: 枠の名前 used NN% pace ±NN% →reset 時刻。記録がまだ無い枠は「データ収集中…」と出ます。

`pace` の値と色

`pace` は、使用率が標準ペースからどれだけ離れているかを、**標準ペースから 100% までの残り**に対する割合で表したものです。

pace = (使用率 − 標準ペース) ÷ (100 − 標準ペース)