f-is-h/Usage4Claude

Usage4Claude – Claude（およびオプションのCodex）のクォータをリアルタイムで監視するmacOSメニュー・バーアプリ

何であるか – Swift/SwiftUIで書かれたネイティブmacOSユーティリティ。Anthropic Claudeサブスクリプション（無料、Pro、Team、Max）の使用量をリアルタイムで表示します。OpenAI Codexのクレジットも追跡可能です。すべてのデータはローカルに保存され、サーバーに送信されることはありません。

なぜ使いたいか – Claudeの使用制限は複数のカテゴリ（5時間、7日、追加使用、モデルごとの制限（OpusやSonnetなど））に分かれています。それらを監視することで、予期せぬ停止を回避できます。特に、Web、CLI、デスクトップ、モバイル、Coworkエージェントなど複数のClaudeエントリーポイントを使い分ける場合に有効です。アプリはメニュー・バーにコンパクトな視覚的インジケータを表示し、色分けされた警告と、90％使用時またはクォータリセット時のオプション通知を提供します。

---

コア機能（READMEに記載）

• リアルタイム監視 – すべてのClaudeクォータタイプおよびオプションのCodexクレジットを監視。
• スマート表示モード – 自動的に表示すべき制限を選びます。手動で任意の組み合わせを選択することも可能。
• 適応型リフレッシュ – 4段階の「スマート」システムで、Claudeを使用中はポーリングを高速化し、アイドル時は遅く（1分 → 3分 → 5分 → 10分）。固定間隔モードも利用可能。
• マルチアカウント対応 – 複数のClaudeアカウント（各アカウントに複数の組織）と、別途Codexアカウントを保存可能。メニューから即座に切り替え可能。
• カスタマイズ可能なUI – パーセンテージのみ、アイコンのみ、またはアイコン＋パーセンテージを選択可能。ライト、ダーク、システムの外観を選択可能。12時間／24時間表記を設定可能。
• 使用量通知 – クォータの90％に達したとき、およびクォータがリセットされたときにmacOSのアラートを表示。
• 内蔵ブラウザログイン – エンベッドされたブラウザを開き、ClaudeまたはChatGPTにログイン。必要なセッションキー／トークンを自動で抽出。Claudeの場合、手動でセッションキーを貼り付けることも可能。
• ローカルオンリー保存 – 認証情報はmacOS Keychainに保存。その他の設定はローカルファイルに保存。テレメトリなし。
• アクセシビリティ – Web、Claude Code CLI、デスクトップアプリ、モバイルアプリ、Coworkエージェントなど、すべてのClaude製品と共有されるクォータをサポートするため、どの製品でも動作可能。
• キーボードショートカット – ⌘R（更新）、⌘,（設定）、⌘⇧A（認証）、⌘U（更新チェック）、⌘Q（終了）。
• アプリ内更新 – Sparkleで実装。署名付きリリースをチェックし、EdDSA署名を検証してDMGを再ダウンロードせずにインストール。

---

セットアップ手順

1. インストール – GitHubのReleasesページから最新の.dmgをダウンロードし、アプリケーションフォルダにドラッグして開きます（初回起動時に署名のないアプリを許可する必要がある場合があります）。 または、リポジトリをクローンし、macOS 13+、Xcode 15+でビルド。
2. 認証 – 初回起動時にウェルカムウィザードが表示されます。ブラウザログインをクリックしてClaudeにログイン。アプリがミニブラウザを開き、サインイン後、セッションキーを自動で取得します。（手動で貼り付けることも可能。）
3. 表示設定 – お好みのメニュー・バースタイル、カラースキーム、リフレッシュモード、Codex監視の有無を選択します（必要に応じてChatGPTログインでCodexアカウントを追加）。
4. 使用 – メニュー・バーのアイコンに円形プログレスインジケータが表示され、クォータ使用量に応じて色が変化します。アイコンをクリックすると、各制限、残り時間、手動更新ボタンを含む詳細ウィンドウが表示されます。
5. オプション – 起動時に自動起動、使用量警告通知の有効化、または設定 → 認証から追加アカウントの追加。

---

どのユーザーに役立つか？

• 開発者 – Claude CodeやClaudeデスクトップクライアントを使用し、割り当てられたトークン内に収める必要がある人。
• パワーユーザー – Web UI、モバイルアプリ、Coworkエージェントを切り替えながら使用し、統合されたクォータを1か所で確認したい人。
• チーム – Claude Team/Maxプランで、複数メンバーのモデルごとの使用量（Opus、Sonnetなど）を監視したい人。
• 誰もが – 予期せぬクォータ枯渇を避けたい、軽量でプライバシー重視の方法を探している人。

---

技術概要

項目	詳細
言語	Swift 5+
UI	SwiftUI + AppKitハイブリッド
アーキテクチャ	MVVM
ネットワーク	URLSession
リアクティビティ	Combine
ローカライゼーション	内蔵i18n（英語、日本語、簡体字中国語、繁体字中国語、韓国語、フランス語、ドイツ語など）
対応macOS	13.0（Ventura）以降、Intel & Apple-Silicon
ライセンス	MIT
配布方法	事前ビルドDMG + アプリ内Sparkle更新

---

ロードマップ（README時点）

• コア監視とUIは既に完了。
• 継続的な作業はCodex統合の洗練、言語ローカライズの拡張、コミュニティからの要望機能の追加。

---

まとめ

Usage4Claude は、ワークフローを離れないでClaude（およびオプションのCodex）の使用状況を監視できる、集中型のオープンソースmacOSメニュー・バーツールです。ネイティブApple技術で構築され、Keychainに認証情報を安全に保存。カスタマイズ性は豊富ながらも軽量（約20MB RAM、アイドル時0.1％未満CPU）です。