「Token Checker」macOS 菜单栏用量监控：实时查看 Claude Code 和 Codex 额度

Token Checker 是一个很小但相当对症的 macOS 菜单栏应用：它把 Claude Code 和 Codex 的使用率常驻显示在菜单栏里。对经常在两个 agent 之间切换、又不想等到请求失败才发现额度紧张的人来说，这类工具的价值非常直接。

项目当前在 GitHub 上约 48 个 star，主语言是 Swift，要求 macOS 14 Sonoma 或更高版本、Swift 5.9 以上，并采用 MIT License。它不是 Anthropic 或 OpenAI 的官方产品，而是一个需要自己 clone、构建并安装的开源小工具。

把额度状态放回菜单栏

Token Checker 的设计很像系统监控工具：菜单栏里显示两个环形进度和百分比，一个对应 Claude Code，一个对应 Codex；点开后可以看到 5 小时窗口、周次窗口、重置倒计时、刷新间隔和登录时自动启动开关。默认刷新间隔是 5 分钟，也可以调整到 30 秒到 10 分钟之间。

它的使用前提也很清楚：你需要先在终端里完成 claude login 和 codex login。如果只配置了其中一个服务，另一个缺失也不会影响已登录的一边继续工作。安装方式则是 clone 仓库后执行 ./Scripts/build.sh --install，没有 Apple Development 签名 identity 时会自动使用 ad-hoc 签名。

读取的是本机已有登录态

这个项目有意思的地方在于数据来源写得比较透明。Claude 侧会通过 /usr/bin/security 从 Keychain 里的 Claude Code-credentials 读取 OAuth access token，再请求 Anthropic 的 usage endpoint；Codex 侧则启动 /opt/homebrew/bin/codex app-server，通过行分隔 JSON-RPC 调用 account/rateLimits/read。

也正因为它会读取本机凭据和本地 Codex 服务，安全边界需要自己判断。README 里也明确写了免责声明：软件按现状提供，不保证准确性、安全性或可用性。我的理解是，它更适合熟悉 CLI 登录流程、愿意自己编译安装、并且能接受第三方本地工具读取额度信息的重度用户。

适合高频 agent 用户的小仪表盘

如果你偶尔才用一次 Claude Code 或 Codex，Token Checker 可能不是必需品；但如果一天里会多次切模型、跑自动化、开多个 coding session，这个菜单栏小表盘就会很实用。它把“我现在还剩多少可用窗口”这个隐形状态变成了随手可见的环境信息，能减少一些被额度打断的突然感。

它目前更像独立开发者给自己和同类用户做的效率补丁：范围很窄，依赖也很明确，没有云端账户体系，也没有复杂设置。正因为简单，反而适合作为 macOS 上 Claude Code / Codex 重度用户的一个轻量监控层。