CodexHUD、CodexBar 与 Claude 用量工具对比
CodexHUD 把可能打断工作的关键信息放在菜单栏:Codex 与 Claude 剩余额度、重置时间、当天 Token 用量,以及可选的额度提醒。
AI 编程工具最理想的状态,是随时可用但不打断思路。使用额度却经常带来相反的体验:一个重构任务做到一半,才发现 5 小时额度或每周额度已经用完。你可能记得自己今天没问几次,却忘了长对话、上下文和多个并行任务都会持续消耗额度。
这也是 CodexBar、ccusage 和 Claude Code Usage Monitor 等项目在 GitHub 上受到关注的原因。它们都在解决“怎么看 AI 编程用量”,但面对的问题并不完全相同。
CodexHUD 的出发点更具体:开始下一个任务之前,我最需要知道什么? 通常不是一张复杂报表,而是还剩多少额度、什么时候恢复、按当前速度会不会很快耗尽。
为什么还要做一款 Codex 和 Claude 用量工具?
没有专门工具时,检查额度本身就会变成一种重复工作。你需要离开编辑器,运行终端命令、打开服务网页、查看状态栏,或者一直等到请求被拒绝才知道额度没了。每次只耽误几十秒,但会不断打断注意力。
CodexHUD 把结果放进 macOS 菜单栏。平时可以直接看到类似 5h 91% · 1w 74% 的文字;点击后再查看当前账号或服务、每个窗口的重置时间、当天 Token 用量、数据更新时间以及额外额度。
设计时主要考虑三件事:
- 重要数字应该一直看得见。 只是想确认能不能开始下一个任务,不应该还要先点击应用。
- 有真实额度就显示真实额度。 如果某个服务只返回余额,就显示余额;如果拿不到可靠数据,就明确显示错误或暂不可用,不编造一个看起来合理的百分比。
- 用到什么功能,再申请对应权限。 Codex 基础监控只访问用户主动选择的目录;其他服务默认不启用,由用户决定是否配置。
CodexHUD 具体能看什么?
免费的 Codex 数据源主要显示日常工作中最重要的两个窗口:较短的使用窗口和每周窗口。CodexHUD 会监听本地 Codex 会话数据的变化,需要实时更新时也可以读取用户已授权的 Codex 用量数据。当天 Token 总数和剩余额度会分开显示,因为它们回答的不是同一个问题。
可选的 Pro 数据源沿用同一套界面:
- Claude Code: 用户启用并授权后,显示 Claude 使用窗口和当天 Token 活动。
- GitHub Copilot: 通过 GitHub 授权读取配额信息。
- GLM Coding Plan: 按用户选择的地区调用对应接口,显示真实额度窗口。
- Kimi Code: 显示每周额度和 5 小时额度。
- Qwen Coding Plan: 账号接口允许时,显示 5 小时、每周和每月额度。
- DeepSeek: 显示官方余额接口返回的余额;因为 DeepSeek 没有提供时间窗口,所以 CodexHUD 不会伪造一个“5 小时剩余百分比”。
GLM、Kimi、Qwen 和 DeepSeek 还支持保存多个自定义名称的账号。API Key 保存在 macOS 钥匙串中,普通账号名称和显示设置则保存在本机。
CodexHUD、CodexBar、ccusage 和 Claude Code Usage Monitor 怎么选?
这几款工具不是简单的“谁功能多谁就更好”。关键是你想回答什么问题,以及愿意用哪种方式查看。
| 工具 | 主要界面 | 突出特点 | 更适合谁 |
|---|---|---|---|
| CodexHUD | 原生 macOS 菜单栏和弹出面板 | 专注剩余额度、App Store 沙盒权限、可选提醒,并用一致界面显示用户选择的服务 | 想全天看到剩余额度和下次重置时间的 Mac 用户 |
| CodexBar | macOS 菜单栏、小组件和命令行工具 | 支持大量服务,提供支出图表、服务状态、多种显示方式和自动化能力 | 希望用一套完整工具监控很多 AI 服务的高级用户 |
| ccusage | 命令行报表,可选状态行 | 从本地记录生成每日、每周、每月、会话、Token 和预估成本分析 | 需要历史报表、筛选、JSON 输出或自动脚本的终端用户 |
| Claude Code Usage Monitor | 实时终端界面 | 专注 Claude 的消耗速度、成本视图、提醒和耗尽预测 | 经常长时间使用 Claude Code,并愿意常驻终端面板的人 |
CodexHUD 和 CodexBar 的区别
CodexBar 是目前这类工具中功能非常完整的项目之一。它支持大量服务、图表、小组件、服务状态检查、合并菜单栏图标,还附带命令行工具,方便把数据提供给脚本或本地服务。如果你优先考虑服务数量和自动化能力,CodexBar 更合适。
CodexHUD 有意把中心缩小到“什么信息会影响当前工作”。第一屏首先显示可能中断本次任务的额度窗口。它通过 Mac App Store 沙盒运行,只恢复用户明确批准的文件夹访问,并把其他服务的配置放在用户主动操作之后。界面也提供紧凑主题和可选的动物伙伴,但装饰不会替代清楚的数字。
这并不是说某个产品一定优于另一个,而是“覆盖面很广的监控工具”和“专注 Mac 状态显示的小工具”之间的区别。
CodexHUD 和 ccusage 的区别
ccusage 很适合回答:我之前用了多少? 它可以在终端里按天、周、月、会话、项目或编程工具汇总本地数据,适合复盘成本、生成报表、编写自动脚本和了解长期使用习惯。
CodexHUD 主要回答:我现在还剩多少? 它常驻菜单栏,在后台更新,并把下一次恢复时间放在容易看到的位置。两款工具并不冲突:ccusage 用来分析历史,CodexHUD 用来在工作过程中及时判断额度。
CodexHUD 和 Claude Code Usage Monitor 的区别
Claude Code Usage Monitor 是一款以终端为主、专注 Claude 的工具。它会分析消耗速度、预测耗尽时间,并为长时间运行的 Claude 会话提供实时视图。如果 Claude 是主要工具,而且终端面板本来就是工作环境的一部分,这种深入分析很有价值。
CodexHUD 用较少的分析深度换取更小、更持久的界面:先服务 Codex,也可以切换到 Claude、Copilot 或其他已配置服务。可选的智能提醒支持自定义剩余额度阈值、根据近期样本估算是否会在一小时内耗尽、额度恢复通知和免打扰时段。提醒只使用真实且仍有效的窗口数据;过期数据、缺失数据和演示数据不会触发通知。
Token 用量和剩余额度不是一回事
这个区别很重要。用户搜索“Claude 使用额度”或“Codex 用量监控”时,实际想找的可能是下面几种完全不同的数据:
- 已经消耗了多少 Token;
- 按模型价格估算花了多少钱;
- 官方订阅窗口还剩多少;
- 按近期速度预测什么时候耗尽;
- 只想知道额度几点恢复。
这些数字有关联,但不能互相替代。本地日志可以准确统计 Token,却不一定知道官方订阅额度还剩多少;官方余额接口可以返回真实金额,却不代表存在 5 小时窗口;预测结果很有参考价值,但必须明确标记为预测。
CodexHUD 会保留数据的真实含义:时间窗口仍然是时间窗口,余额仍然是余额,当天 Token 仍然是历史使用量,拿不到的数据就保持不可用状态。
macOS 上的隐私与权限
用量工具通常要读取本地命令行数据、登录凭据或在线额度接口。隐瞒这一点会让介绍显得简单,却不会让产品更可信。
CodexHUD 遵循 Mac App Store 的沙盒规则。使用 Codex 时,由你主动选择所需目录;应用保存安全书签,下次启动时只恢复这项明确授权。核心监控不需要不受限制地读取 Mac 上的所有文件。
可选服务的凭据保存在 macOS 钥匙串中。只有用户启用某个服务后,应用才会为该服务发送网络请求,并说明需要什么授权。这也意味着 CodexHUD 会诚实地失败:登录过期、接口不可用或返回值不包含可靠额度时,界面会显示具体问题,而不是偷偷换成一个看似正常的数字。
最后应该选哪一款?
如果你主要在 Mac 上工作,希望全天看到 Codex 或 Claude 剩余额度,并且偏好原生界面和较少配置,可以选择 CodexHUD。
如果你希望一款工具覆盖尽可能多的服务,还需要图表、小组件、服务状态和命令行自动化,可以选择 CodexBar。
如果你更在意历史 Token、成本分析、终端报表、JSON 输出或自动脚本,可以选择 ccusage。
如果 Claude 是主要工具,而且你想在终端里深入观察消耗速度与耗尽预测,可以选择 Claude Code Usage Monitor。
真正重要的是,检查额度不应该变成新的工作。好的用量工具只需要提供足够的信息,帮助你判断下一个任务是否适合现在开始,然后继续安静地待在旁边。
在 Mac 上使用 CodexHUD
CodexHUD 已提供 Mac App Store 下载。安装后授权 Codex 目录,照常使用 Codex,菜单栏数值会随着用量数据变化自动更新。工作中还使用 Claude、Copilot、GLM、Kimi、Qwen 或 DeepSeek 时,再按需启用对应数据源即可。
本文对比内容于 2026 年 7 月 16 日根据各项目的官方 GitHub 仓库核对,后续功能可能发生变化。CodexBar、ccusage、Claude Code Usage Monitor、Codex、Claude、GitHub Copilot 及其他产品名称归各自权利人所有。CodexHUD 是独立应用,与这些项目没有隶属或授权关系。
常见问题
CodexHUD 是什么?
CodexHUD 是一款原生 macOS 菜单栏应用,用来显示 Codex 的使用窗口、剩余额度、重置时间和相关用量信息。可选 Pro 数据源还支持 Claude、GitHub Copilot、GLM、Kimi、Qwen 和 DeepSeek。
CodexHUD 和 CodexBar 有什么区别?
CodexBar 更强调大量服务支持、图表、小组件和命令行工具。CodexHUD 更专注于 Mac 菜单栏常驻显示、简单切换数据源、App Store 沙盒权限和可选的额度提醒。
CodexHUD 能查看 Claude Code 使用额度吗?
可以。Claude 是可选的 Pro 数据源。启用并授权所需的本地访问后,CodexHUD 会显示 Claude 使用窗口,并在新数据出现时更新。
Token 用量等于剩余额度吗?
不等于。Token 总数表示已经记录的使用量,额度窗口表示某项服务还剩多少、何时恢复。CodexHUD 会把两种数据分开显示。
CodexHUD 需要完全磁盘访问权限吗?
核心 Codex 监控不需要不受限制的完全磁盘访问。沙盒版本会让你选择相关目录,保存安全书签,并在下次启动时恢复这项明确授权。可选数据源可能需要各自的登录或授权。