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%）。