作ったもの

Claude CodeとCodex CLIの「残り使用量」を、画面右下（タスクバー付近）に常時テキスト表示するWindows用ウィジェットです。

なぜ作ったか

Claude CodeやCodex CLIを使っていると、5時間枠・週間枠の利用率をつい忘れて、作業の途中で上限に当たって止まってしまうことがありました。ダッシュボードをいちいち開かずに、画面の隅に常に見えている状態にしたくて作りました。

できること

・画面右下に「Claude 5h:67% 7d:30% / Codex:95%」のようなテキストが常時表示される（ホバー不要）
・文字色は白固定。背景色は右クリックメニューの「背景色を変更」から自由に選択でき、設定は次回起動時も保持される（デフォルトは#1e1e1eの濃いグレー）
・ウィジェットを右クリックするとメニューが出る（ポーリング間隔切り替え、自動起動ON/OFF、背景色を変更、今すぐ更新、終了）

使っている技術

Python標準ライブラリのみで動作します（tkinterでUIを構築）。追加インストールはテスト用のpytestのみです。Claude側は「GET /api/oauth/usage」から取得し、Codex側は「codex app-server」の「account/rateLimits/read」を使用しています。

セットアップ

pip install -r requirements.txt を実行後、python main.py を実行するだけです。

既知の制約・リスク

Claude側が使っているエンドポイントは、Claude Code本体が内部で使っている非公開APIで、Anthropicが公式にドキュメント化・サポートしているものではありません。予告なく変更・廃止される可能性があります。取得に失敗した場合はウィジェットに「Claude: N/A」と表示され、アプリ自体はクラッシュしません。

また、Claudeの認証トークンが失効しても自動リフレッシュは行いません。ホームディレクトリの.claude/.credentials.jsonのアクセストークンをそのまま使うため、Claude Codeを長期間起動しないとトークンが失効し、「Claude: N/A」表示になることがあります。

Codex側はcodex app-serverが公開しているJSON-RPC APIを使っているため、比較的安定して動作する想定です。

認証情報（アクセストークン・リフレッシュトークン）はログ・エラーメッセージ・トレイ表示のいずれにも一切出力しない設計にしています。

まとめ

MITライセンスで公開しています。同じように「気づいたら上限に当たっていた」という経験がある方に使ってもらえると嬉しいです。フィードバックやPRも歓迎です。