Claude Meters

特徴

• 2つのリングを、常に表示。セッション（5時間）と週間の使用率を、メニューバーにパーセントで表示します。
• クリックでリセットまでの時間を確認。ポップオーバーに、各メーターがリセットされるまでの時間が出ます。
• 自動で最新の状態に。2分または5分ごとに自動で更新します（設定で選べます）。取得に失敗したときは指数バックオフで再試行し、スリープから復帰したときにも取得し直します。
• メニューバーだけで完結。Dockアイコンも、開いたままにするウインドウもありません。ログイン時の起動は任意です。
• ライト・ダークモードとVoiceOverに対応。外観の設定に合わせて表示します。
• 8言語に対応。英語、日本語、韓国語、ドイツ語、フランス語、イタリア語、ポルトガル語（ブラジル）、スペイン語。システムの言語に従い、設定から切り替えることもできます。

含まれないもの：使用量の履歴、グラフ、予測、通知、複数アカウント、モデル別の内訳。

動作環境とインストール

• macOS 13 (Ventura) 以降。
• Claude Codeがインストール済みで、ClaudeのPro/Maxプランでサインインしていること。

1. 最新のリリースを開き、AssetsからClaudeMeters-v*-macOS.dmgをダウンロードします。「Source code」はソースコードなので不要です。
2. .dmgを開き、Claude Meters.appをApplicationsフォルダにドラッグします。
3. 起動すると、メニューバーに2つのリングが表示されます。

v0.1.1以降のリリースはDeveloper ID証明書で署名され、Appleの公証も済んでいるため、Gatekeeperの警告なしで開けます。自動更新はしません。設定の「更新を確認」で、新しい版が出ているかを確認し、リリースのページを開けます。

Usage情報の取得方法

Claude Meters自身は認証情報を要求・保存しません。Claude CodeがすでにmacOSのKeychain（Claude Code-credentials）に保存しているOAuthトークンを読み取り、それを使ってAnthropicのUsage APIにセッションと週間の使用率を問い合わせます。

トークンは、Claude Code自身がこの項目の保存に使っている/usr/bin/securityコマンド経由で読み取ります。そのため、通常はKeychainの許可ダイアログは表示されず、Claude Codeがトークンを更新したあとも再表示されません。キーチェーンがロックされているときなどにダイアログが出たら、ログインパスワードで許可してください。

ほかの通信は、設定の「更新を確認」を押したときに、GitHubへ最新のリリースを問い合わせるものだけです。