Claude Codeの使用量をmacOSメニューバーで常時確認できるアプリを作った

• URL: https://zenn.dev/yotake/articles/4173a27c455976
• 日付: 2026-06-24
• Tier: Tier 3
• 要旨: Claude Codeの5時間枠セッション消費率をmacOSメニューバーに常時表示するアプリClaudeMeterを開発した。Swift+SwiftUIで実装し、Usage APIを5分間隔でポーリング、トークンの有効期限切れ前のリフレッシュ、複数アカウント対応を実装。Codex CLIのローカルログパースでレート制限情報もローカルから取得可能にした。無料・オープンソース公開。

詳細

ClaudeMeterはmacOSメニューバー上にセッション消費率をパーセント表示し、クリックで詳細（週間リミット、Codexレート制限、API支出など）を表示するSwift製アプリ。SwiftUIのMenuBarExtraでポップオーバー実装、Usage API（https://api.anthropic.com/api/oauth/usage）を定期ポーリングし、トークン有効期限切れ5分前に先回りリフレッシュ、429エラー時は自動バックオフ。Codex CLI用にはローカルの～/.codex/sessions/*.jsonlをパースしてtoken_countイベントのrate_limitsフィールドを読み取り、ネットワーク通信ゼロで取得。複数アカウント（サブスク複数持ちやサブスク+Admin APIキーの組み合わせ）に対応し、各アカウントで独立してポーリング・トークン更新を実行。消費ペース予測により色表示でビジュアルフィードバック。GitHub・ダウンロード・GitHub Sponsorsで公開。