AI Quota

The same numbers as /usage, on your Stream Deck keys.

AI Quota shows how much of your Claude Code and Codex limits are left - the real figures those tools report, never an estimate. A figure estimated from local token counts was off by 46 points in testing, so when the real one cannot be read the key says so instead of showing a number it cannot stand behind.

Everything comes from files already on your computer. No network requests, no sign-in, no API calls, and watching your usage costs you nothing.

What it does

Shows the Claude Code 5-hour and 7-day windows, and the Codex window, on your keys

Counts down to the reset, with colours that change as you use it up (green to yellow to red)

Takes your weekly reset from your own account, so it is right whenever your week happens to start

A combined key shows Claude and Codex together as two rings

Press a key to refresh it straight away, or set it to switch between the 5-hour and 7-day windows

English and Japanese, following your Stream Deck language

Showing the Claude percentage - one-time setup, please turn it on yourself

Codex works as soon as you install the plugin.

Claude needs one step from you the first time. Claude does not store its usage rate anywhere on your computer, so the plugin needs a small helper that writes it somewhere it can read.

(1) Select a Claude key and open the settings panel on the right (2) Check that "Use live values" is ticked (on by default) (3) Press the "Set up automatically" button (4) The real percentage appears the next time you start Claude Code

Until then the Claude key shows "Setup" instead of a number.

"Set up automatically" places a small Claude Code mod in ~/.claude/ai-quota/mod/ and registers it in ~/.claude/settings.json. Existing settings are kept, and a backup is taken before anything is written. The mod only writes the usage rate and the reset time to a file - no network access, no credentials and no AI usage charges. You can undo it at any time with "Remove registration".

Requirements

Stream Deck 6.9 or later, macOS 12 or later / Windows 10 or later

Claude Code or Codex used on that computer

/usage と同じ数字を、Stream Deck のキーに。

AI Quota は Claude Code と Codex の利用枠の残りを表示します。出すのは両ツールが実際に報告している数字だけで、推定は使いません。ローカルの記録からの推定は実測で 46 ポイントずれたことがあるため、実値が読めないときは数字を出さず、その旨を表示します。

読むのはパソコンに既にあるファイルだけです。ネットワーク通信も、ログインも、API 呼び出しもありません。見ること自体に料金はかかりません。

できること

Claude Code の 5 時間枠・7 日枠と、Codex の枠をキーに表示

リセットまでの残り時間と、使うほど変わる色（緑 → 黄 → 赤）

7 日枠のリセット日はアカウントごとの実値から割り出すので、契約日が人それぞれでも合う

Claude と Codex を二重リングで 1 キーにまとめる表示

押すとすぐ更新。5 時間 / 7 日の切り替えに変えることも可能

日本語と英語に対応（Stream Deck アプリの言語に追従）

Claude の使用率を表示するには（初回のみ・各自で ON にしてください）

Codex はインストールするだけで使用率が出ます。Claude は、初回だけご自身で有効化する操作が必要です。

(1) Claude のキーを選び、右側の設定画面を開く (2)「実値を有効にする」にチェックが入っていることを確認（既定で ON） (3)「自動設定」ボタンを押す (4) 次に Claude Code を起動すると、実際の使用率が表示されます

有効化するまで、Claude のキーには数字ではなく「要設定」と表示されます。

「自動設定」を押すと、Claude Code 用の小さな mod を ~/.claude/ai-quota/mod/ に置き、~/.claude/settings.json に登録を追加します。既存の設定は残し、書き換える前に控えを取ります。ネットワーク通信も、認証情報へのアクセスも、AI の利用料も発生しません。設定画面の「登録を外す」でいつでも元に戻せます。

First release.

See how much of your Claude Code and Codex usage limits are left, right on your Stream Deck keys. The plugin reads only the usage data already stored on your own computer, so it never calls an API and never costs you anything.

Codex works as soon as you install it.

Claude needs one step from you the first time, because Claude Code does not store its usage rate anywhere on your computer. Each user has to turn this on themselves:

(1) Select a Claude key and open the settings panel on the right.

(2) Check that "Use live values" is ticked. It is on by default.

(3) Press the "Set up" button.

(4) Start Claude Code again. Real percentages appear from then on.

Until you do this, the Claude key shows "Setup" instead of a number. The helper only writes the usage rate and the reset time to a file: no network access, no credentials, no AI usage charges. You can undo it at any time from the same panel.

The weekly reset day differs per person, so it is taken from the same live data. If it cannot be read, you can set it yourself in the panel.