UsageHelper icon
RYOMA LAB · macOS APP

UsageHelper

Claude Code(と Codex)の使用量を、複数アカウント同時にメニューバーで見る macOS 常駐アプリ。5時間・週・Fable の残量をひと目で。

v0.1.0 macOS 15+ Apple Silicon 約 1.3 MB
⬇ ダウンロード UsageHelper.zip 解凍して アプリケーション に入れるだけ。初回起動だけ一手間あります(下記)。

これは何?

Claude Code を複数アカウントで使っていると「今どのアカウントがどれくらい残ってるか」が見えません。UsageHelper はそれをメニューバーに常駐表示します。

複数アカウント同時監視

3つでも4つでも、各アカウントの使用率を同時に表示。どれをログイン中でも全部見える。

5時間・週・Fable

5時間ローリング / 週間(全モデル) / 週間 Fable 枠を、色分きプログレスバーで。

メニューバー5スタイル

バッテリー / バー / パーセント / リング / ドット から選択。残り時間表示も。

使用履歴グラフ

5時間 / 24時間 / 7日 / 30日で推移を確認。アカウント別に重ね表示。

アカウント切替

ワンクリックで Claude Code のログインを別アカウントへ入れ替え。

100%で自動切替

使用中の口座が満杯になったら、優先順位で空いてる口座へ自動で切替+通知。

Codex 対応

OpenAI Codex CLI の 5時間 / 週の使用量も(ローカルログから、トークン不要)。

ログイン時起動

Mac にログインしたら自動常駐。Dock アイコンからいつでも設定を開ける。

01インストール

自己署名アプリ(App Store 外配布)のため、初回だけ Gatekeeper の解除が要ります。1回やれば以降は普通に起動できます。

1

ダウンロードして解凍

上の「ダウンロード」から UsageHelper.zip を取得し、ダブルクリックで解凍。UsageHelper.appアプリケーションフォルダへ移動します。

2

初回だけ「右クリック → 開く」

アプリを右クリック(Control+クリック)→「開く」→ 確認ダイアログでもう一度「開く」。以降は通常のダブルクリックで起動できます。

「壊れているため開けません」と出る場合は、ターミナルで隔離属性を外してください:

xattr -dr com.apple.quarantine /Applications/UsageHelper.app
3

メニューバーに常駐

起動するとメニューバーにアイコンが出ます(Dock アイコンをクリックすると設定画面)。この時点ではまだ Keychain には一切触りません。

02使い方

「接続 → アカウント登録 → 表示カスタム」の順で。登録は各アカウント1回だけです。

A

Keychain に接続する

ポップオーバー上部か、設定 →「一般」の「接続」を押します。Keychain の許可ダイアログが出たら「常に許可」を選択。以降は静かに使用量を読み込みます(未接続の間は Keychain に一切触れないので、勝手にダイアログは出ません)。

B

アカウントを登録する(各口座1回)

監視したいアカウントで claude /login してログイン中の状態にします。

UsageHelper の 設定 →「プロファイル」で、対象プロファイルの「現在のログインを取り込む」を押すと、その口座が保存されます。上部に「現在 claude にログイン中」のアカウントが表示されるので、それを見ながら取り込めます。

別のアカウントに claude /login し直して、別プロファイルに取り込む——を繰り返せば、複数アカウントが同時監視されます。Claude を追加 / Codex を追加 でプロファイルを増やせます。

C

メニューバー表示をカスタム

設定 →「メニューバー」で、Session(5時間)Week(週)それぞれの表示スタイル(バッテリー / バー / パーセント / リング / ドット)を選べます。プレビューでその場で確認できます。残り時間(例 →2H)の表示トグルも。

D

並べ替え

設定 →「プロファイル」の で並べ替え。この順番がメニューバーの表示順、そして自動切替の優先順位になります。

E

アカウント切替

ポップオーバーの各アカウントの「切替」で、Claude Code のログインをその口座へ入れ替えます。

重要:切替は新しく起動する claude から有効です。動作中のセッションは起動時のトークンを持ち続けるため、切替後はそのターミナルの claude を一度終了して起動し直してください(Mac の再起動は不要)。
F

100%で自動切替

設定 →「自動切替」をオンにすると、使用中の口座のセッション使用率がしきい値(既定100%)を超えたとき、並び順で上から空いている口座へ自動で切替+通知します。あとは案内どおり claude を起動し直すだけ。

G

履歴・自動起動

ポップオーバーの「履歴…」で使用率の推移グラフ(5時間 / 24時間 / 7日 / 30日、ウィンドウ切替)。設定 →「一般」で「ログイン時に起動」をオンにすると常駐が自動化されます。

03プライバシーと注意