Claude Usage Barometer
Claude利用状況のためのコンパクトなバッテリー型メニューバーゲージ。5時間枠と7日間枠が減っていく様子をリアルタイムで — macOSのメニューバーからそのまま確認できます。
Claudeの上限を、常に視界に
Claude Usage Barometerは、macOSのメニューバーに常駐するSwiftBar（またはxbar）用の無料・オープンソースのプラグインです。バッテリー型のバーを2本表示します — 1本はClaudeの移動式5時間枠、もう1本は7日間枠 — ので、残量がひと目でわかります。純粋なBashでビルド不要、Claude CodeのトークンをローカルのmacOS Keychainから読み取り、データをどこにも送信しません。
利用上限は、到達するまで見えない
Claudeは移動式の利用枠を設けていますが、どれだけ近づいているかをデスクトップ上で知らせてくれるものは何もありません — 作業が途中で止まるまで。
ネイティブな表示がない
5時間枠・7日間枠を示す組み込みのゲージがないため、セッションの途中で予告なく上限に達することがあります。
コンテキストスイッチのコスト
利用状況の確認は、作業を離れてダッシュボードを掘り下げること — 「あとどれくらい？」と思うたびに支払う摩擦です。
突然の中断
予期せず上限に達すると集中が途切れ、進めていた作業が止まります。ひと目でわかるゲージが、その不意打ちを防ぎます。
Claude残量のためのバッテリー
メニューバーに2本のバー、詳細なドロップダウン、そしてクリックなしで状況を伝える色。
塗りつぶし部分が残量、空き部分が消費済みを表します。5時間枠と7日間枠を消費するにつれ、各バーが減っていきます。
消費69%までは緑、70%から黄、90%から赤 — メニューバーのバーは、より制約の厳しい枠に従います。
クリックすると、各枠の残り割合と正確なリセットまでのカウントダウン、そして最終更新時刻が表示されます。
このMac上のKeychainからClaude CodeのOAuthトークンを読み取ります。アカウントもサーバーも不要で、マシンの外に何も出ません。
小さなゲージ、行き届いた配慮
メニューバーツールに欲しいものすべてを、不要なものは何もなく。
5時間＆7日間ゲージ
2つの移動式枠をひと目で。ドロップダウンには残り割合とリセットまでのカウントダウンを表示。
色分けステータス
上限に近づくにつれ緑→黄→赤へ。何も開かなくても状況が一目瞭然です。
レート制限に優しい
直近の有効な値をキャッシュし、API呼び出しを最低3分間隔に抑制。短時間の429も穏やかに乗り切ります。
アップデート対応
1日に1度GitHubを確認し、新しいリリースがあればドロップダウンに「更新あり」リンクを表示します。
更新間隔の調整
ドロップダウンから1分・3分・5分の更新間隔を選択し、鮮度とAPI呼び出しのバランスを取れます。
ビルド不要、純粋なBash
読みやすく、監査しやすく、調整しやすい。設計段階からプライベートで、MITライセンスで公開。
ターミナルに1行
インストーラがHomebrew経由でjqとSwiftBarを追加し、プラグインを配置して起動します。初回起動時はKeychainのプロンプトで「常に許可」を選んでください。
curl -fsSL https://raw.githubusercontent.com/taka-avantgarde/claude-usage-barometer/main/install.sh | bashmacOS 12以降、Homebrew、そしてこのMacでClaude Codeにサインインしていることが必要です。
よくある質問
Claude Usage Barometerは無料ですか？
はい。MITライセンスのオープンソースで、無料で使えます。必要なのは、すでにMacにあるClaude Codeのセッションだけです。
実行に何が必要ですか？
macOS 12以降、SwiftBar（またはxbar）、jqとcurl、そして同じMacでサインイン済みのClaude Codeです。1行のインストーラがjqとSwiftBarをセットアップします。
Claudeのトークンは安全ですか？
はい。プラグインはmacOS KeychainからClaude CodeのOAuthトークンをローカルに読み取り、それを自分自身の利用状況の取得にのみ使用します。純粋なBashで、第三者へ何も送信せず、テレメトリもありません。
色は何を意味しますか？
バーは消費70%未満で緑、70〜89%で黄、90〜100%で赤になります。メニューバーの色は、2つの枠のうち上限に近い方に従います。
SwiftBarだけでなくxbarにも対応していますか？
はい。SwiftBarまたはxbarのプラグインとして動作します。推奨はSwiftBarで、1行のインストーラがセットアップするのもSwiftBarです。