f-is-h/Usage4Claude

Monitor all your Claude/Codex usage limits in real-time from your macOS menu bar - supports 5-hour, 7-day, extra usage, 7-day Opus and 7-day Sonnet quotas.

Usage4Claude – 用於即時監控 Claude（及可選 Codex）配額的 macOS 菜單列應用

是什麼 – 使用 Swift/SwiftUI 編寫的原生 macOS 工具，可即時顯示您 Anthropic Claude 訂閱（免費、Pro、Team、Max）的使用狀況。也可追蹤 OpenAI Codex 信用額度。所有資料均本地儲存，應用程式從不向伺服器傳送任何資訊。

為什麼需要它 – Claude 的使用限制分為多個類別（5 小時、7 天、額外使用、各模型限制如 Opus 或 Sonnet）。持續監控這些限制有助於避免意外中斷，尤其是在您透過多個 Claude 入口（網頁、CLI、桌面端、行動端、Cowork 代理）工作時。該應用在菜單列提供緊湊的視覺指示器，使用顏色編碼警告，並在使用率達 90% 或配額重置時提供可選通知。

核心功能（如 README 所述）

即時監控 所有 Claude 配額類型及可選的 Codex 信用額度。
智慧顯示模式 自動選擇要顯示的限制；您也可手動選擇任意組合。
自適應刷新 四級「智慧」系統，當您活躍使用 Claude 時加快輪詢頻率，閒置時降低（1 分鐘 → 3 分鐘 → 5 分鐘 → 10 分鐘）。也提供固定間隔模式。
多帳戶支援 可儲存多個 Claude 帳戶（每個帳戶可包含多個組織）及獨立的 Codex 帳戶；透過菜單可即時切換。
可自訂 UI 可選擇僅百分比、僅圖示，或圖示+百分比；可選淺色、深色或系統外觀；可設定 12/24 小時制時間格式。
使用量通知 當達到某項限制的 90% 或配額重置時，觸發 macOS 提醒。
內建瀏覽器登入 應用程式開啟嵌入式瀏覽器，登入 Claude 或 ChatGPT，並自動提取所需會話金鑰/權杖。對於 Claude，您也可手動貼上會話金鑰。
僅本地儲存 憑證儲存在 macOS Keychain 中；其他所有設定均儲存在本地檔案中。無遙測資料。
無障礙支援 適用於任何 Claude 產品（網頁、Claude Code CLI、桌面應用、行動應用、Cowork 代理），因為它們共享同一配額。
鍵盤快速鍵 ⌘R（重新整理）、⌘,（設定）、⌘⇧A（認證）、⌘U（檢查更新）、⌘Q（退出）。
應用內更新 基於 Sparkle 實現；應用會檢查簽名發布版本，下載、驗證 EdDSA 簽名，並在無需重新下載 DMG 的情況下安裝。

快速上手

安裝 – 從 GitHub Releases 頁面下載最新 .dmg，拖入 Applications 檔案夾，開啟應用程式（首次執行可能需要允許未簽署應用程式）。或克隆倉儲，使用 Xcode 15+ 在 macOS 13+ 上建置。
認證 – 首次啟動時會彈出歡迎向導。點擊 瀏覽器登入 以登入 Claude；應用程式將開啟迷你瀏覽器，您登入後，會話金鑰將自動捕獲。（您也可手動貼上會話金鑰。）
配置顯示 – 選擇您偏好的菜單列樣式、配色方案、重新整理模式，以及是否啟用 Codex 監控（如需，可透過 ChatGPT 登入新增 Codex 帳戶）。
使用 – 菜單列圖示現在顯示一個圓形進度指示器，隨著配額消耗，顏色會變化。點擊圖示可開啟詳細視窗，列出各項限制、剩餘時間及手動重新整理按鈕。
可選 – 啟用開機自動啟動、設定使用量警告通知，或透過 設定 → 認證 新增更多帳戶。

哪些人會受益？

開發者：使用 Claude Code 或 Claude 桌面客戶端，需要控制分配的令牌使用量的人。
進階使用者：在 Claude 網頁端、行動端、Cowork 代理之間頻繁切換，希望在一個地方查看合併配額的人。
團隊：使用 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 是一款專注、開源的 macOS 菜單列工具，讓您無需離開工作流程即可監控 Claude（及可選 Codex）使用情況。它使用原生 Apple 技術建構，憑證安全儲存在 Keychain，提供豐富自訂選項，同時保持輕量（約 20 MB RAM，閒置時 CPU 使用率 < 0.1%）。