Show HN: AI Usage – 原生的 macOS 菜單欄應用,用於監控 Claude Code 和 Codex 的用量限制
AI Usage 是一款原生的 macOS 菜單欄應用,可實時監控 Claude Code 和 Codex 的 API 用量限制。它輕量高效(CPU 佔用接近 0%),無需額外賬户或 API 密鑰,直接讀取本地 OAuth 憑據,確保數據安全。支持多種顯示模式、自動刷新和自動更新。
AI Usage 是一款由開發者 burakgon 創建的原生 macOS 菜單欄應用,旨在幫助用户實時監控 Claude Code 和 Codex 的 API 用量限制。該應用以極低的系統資源佔用(測量為 0.0% CPU)運行,僅在菜單欄顯示,不會在 Dock 中留下圖標,完全符合 macOS 的設計理念。
與其他同類工具不同,AI Usage 不需要用户註冊額外賬户、提供 API 密鑰或運行本地服務器。它直接讀取 Claude Code 和 Codex 命令行工具在本地創建的 OAuth 憑據,然後通過官方的第一方端點查詢配額數據。所有憑據僅存儲在用户的 Mac 上,絕不會被打印、記錄或發送到其他地方。臨時故障時,應用會保留內存中上次成功的值並標記為過期,且不在啓動之間緩存任何數據。
AI Usage 支持多種顯示模式:用户可以切換顯示 Claude Code 或 Codex 的用量,也可以設置為自動模式,顯示當前使用百分比最高的服務。支持查看會話或周用量,並可以選擇顯示已用或剩餘百分比。進度條繪製限制在 0-100%,剩餘用量也限制在 0-100% 範圍內,以避免顯示無意義的負值。
該應用還提供可配置的刷新間隔(1、5、15、30 或 60 分鐘),並支持手動刷新。更新檢查在啓動時和每天自動進行,當新版本可用時,面板中會直接顯示更新按鈕。AI Usage 採用 Sparkle 框架進行簽名更新,未來更新受到 EdDSA 簽名的保護。
開發者還提供了從源代碼構建的詳細説明,需要 macOS 26 或更高版本以及 Xcode 27 或更高版本。項目採用 MIT 許可證開源,歡迎貢獻。更多細節可查看 GitHub 倉庫。