AI Usage Gauge

CodexPets の近くに表示する、Codex / Claude の残り使用量ゲージです。 ※画像のPetsは付属していません

Codex / Claude それぞれについて、短期枠（5時間）と長期枠（週/7日相当）の残り目安を表示します。 起動すると CodexPets のそばに出現し、Pets の位置を追従します。 Pets が非表示でもゲージ自体は機能します。

位置はドラッグで調整できます。

できること

• Codex の短期枠（5時間）・長期枠の残り目安を表示
• Claude の短期枠（5時間）・7日枠の残り目安を表示
• CodexPets の近くに自動配置
• CodexPets の移動に追従
• CodexPets が非表示でも単体ゲージとして動作
• ドラッグで位置調整
• ターミナルなしで起動できる VBS ランチャー付き

動作環境

• Windows
• PowerShell 7 for Windows
  • pwsh コマンドで起動できる状態が必要です。
• Codex Desktop
  • Codexゲージを使う場合は、Codex Desktopにログイン済みである必要があります。
  • Pets追従を使う場合は、Codexのpet/avatar overlayが有効である必要があります。
• Claude Code
  • Claudeゲージを使う場合は、Claude CodeにOAuthログイン済みである必要があります。
  • APIキーだけでClaude Codeを使っている環境では、Claudeゲージは表示できない場合があります。
• インターネット接続
  • Codex / Anthropic の現在のエンドポイントへアクセスします。

起動手順

1. このリポジトリ一式、または release ZIP をダウンロードします。
2. ZIP の場合は、すべてのファイルを同じフォルダに展開します。
3. 初回は Start-AIUsageGauge.cmd を実行します。

.\Start-AIUsageGauge.cmd

初回に .cmd を使うと、PowerShell 7 が見つからない場合などのエラーが画面に表示されます。

動作確認後、ターミナルを出さずに起動したい場合は次を使います。

.\Start-AIUsageGauge-hidden.vbs

PowerShellから直接起動する場合:

pwsh -STA -ExecutionPolicy Bypass -File .\Start-AIUsageGauge.ps1

表示位置や更新間隔を指定する場合:

pwsh -STA -ExecutionPolicy Bypass -File .\Start-AIUsageGauge.ps1 -Placement right -RefreshSeconds 60

Start-AIUsageGauge-hidden.vbs だけを配布・移動しても動きません。 必ず Start-AIUsageGauge.ps1 と同じフォルダに置いてください。

操作

• ドラッグ: ゲージ位置を調整
• 右クリック: ゲージを閉じる

ドラッグで移動した場合、その起動中は CodexPets からの相対位置として追従します。

仕組みと注意

このツールは非公式の補助ツールです。 OpenAI、Anthropic、Codex Desktop、Claude Code の公式ツールではありません。

Codex側は、ローカルの Codex ログイン情報を使って現在の使用量エンドポイントを読みます。

Claude側は、Claude Code のOAuthログイン情報を使って最小の Messages API リクエストを送り、返ってくる rate-limit ヘッダーから残量を推定します。 そのため、Claude側の確認は小さなClaude使用量としてカウントされる可能性があります。

APIやローカル状態ファイルの仕様が変わると、予告なく動かなくなる可能性があります。

セキュリティ

• トークンを画面に表示する処理はありません。
• トークンをGitHubへアップロードする処理はありません。
• 自分の .codex フォルダや .claude フォルダを共有しないでください。
• auth.json、.credentials.json、ログ、SQLite、Cookie、Cache、スクリーンショットなどを公開リポジトリに入れないでください。

ライセンス

MIT License です。

詳細は LICENSE を確認してください。