如果你经常在 Mac 上用 Codex，可能碰到过一个很实际的问题：任务跑了不少，但想看当前账号还剩多少额度、什么时候重置、今天大概用了多少 Token，总要切换页面或翻不同位置。
我做了一个原生 macOS 菜单栏小工具，名字叫 Codex Meter for macOS。它把账号额度、本机 Token 活动和近 90 天趋势集中到一个面板里。目前项目已经以 MIT 许可证开源，也提供了 Universal Binary 安装包。
先说明边界：Codex Meter 不是 OpenAI 官方产品，也不会增加或绕过任何额度。本地 Token 是根据 Codex 会话日志计算的活动估算，不是账单；额度百分比和重置时间则来自本机 Codex App Server 的只读账号查询。这两个数字不能混为一谈。
先说结论：它适合谁
Codex Meter 更适合每天在 Mac 上使用 Codex 的人，尤其是同时使用 Codex Desktop、Codex CLI 或其它共用同一账号的 Codex 客户端时。
菜单栏里常驻一个剩余比例，比临时想起来再找状态页更直接。点开面板后，可以看到当前返回的额度窗口、重置时间、今日 Token 分项和 90 天热力图。对于长时间跑任务、经常并行开多个 Codex 任务的人，这些信息足够用来判断今天的使用节奏。
它不适合三类情况：你根本不用 Codex；你需要核对官方账单；你不能接受当前未经过 Apple 公证的社区应用。后一种情况可以直接查看源码并自行构建。
Codex Meter 能看到什么
当前 v1.1.0 主要提供以下信息：
- 菜单栏显示最长用量窗口的剩余百分比。
- 面板显示 Codex 实际返回的一个或多个额度窗口，不硬编码固定周期。
- 展示额度已用比例、剩余比例和下一次重置时间。
- 统计今日输入、缓存输入和输出 Token 活动。
- 用热力图展示近 90 天本机 Codex 使用趋势。
- 支持 1、5、15 分钟自动刷新。
- 支持自定义 sessions 目录和缓存重建。
- 同时支持 Apple Silicon 与 Intel Mac。
界面里还会标明数据来自“账号实时”“账号缓存”还是“本地快照”。这个标签不是装饰，它决定了当前额度是否已经包含其它客户端刚刚产生的用量。
为什么额度和 Token 要分开看
这是做这个工具时最容易误解的地方。
今日 Token 和 90 天热力图来自本机 ~/.codex/sessions 目录里的 JSONL 会话日志。它能反映这台 Mac 上的 Codex 活动，但不能当作官方消费账单，也不一定包含你在其它设备上的历史记录。
额度百分比和重置时间则通过本机已安装的 Codex App Server 查询 account/rateLimits/read。它复用 Codex 现有登录状态，返回账号级额度，因此能反映同一账号在其它 Codex 客户端产生的用量。
简单理解：
- 账号额度回答“现在还能用多少”。
- 本地 Token 回答“这台 Mac 最近怎么在用”。
把两者放在同一面板里有参考价值，但不能拿本地 Token 数量反推固定额度，也不能把热力图当成结算数据。
Codex Meter 怎么安装
1. 下载公开版本
打开 Codex Meter v1.1.0 Release，下载 CodexMeter-macOS-universal.zip。
2. 移动到应用程序
解压后，把 CodexMeter.app 拖到 macOS 的“应用程序”目录。
3. 首次打开
当前版本使用本地 ad-hoc 签名，没有 Apple Developer ID 公证。如果 macOS 拦截，先不要关闭安全设置，也不要运行来源不明的解除限制命令。
在 Finder 中找到 CodexMeter.app，右键选择“打开”，再在系统弹窗中确认即可。对安全要求更高的用户，建议先查看 GitHub 源码并自行构建。
4. 等待第一次扫描
应用默认读取：
~/.codex/sessions历史日志较大时，第一次扫描需要一些时间。完成后会建立本地增量缓存，后续刷新会快很多。开发测试使用了 179 个会话文件、约 781MB 日志，增量刷新约为 0.2 秒。这个数字只代表测试环境，不是每台 Mac 的固定结果。
5. 调整菜单栏位置
如果菜单栏图标位置不合适，可以按住 Command 拖动状态项。设置里还能切换是否显示百分比文字、选择刷新间隔，以及修改 sessions 目录。
它会不会读取账号密码
不会直接读取。
Codex Meter 不读取 auth.json，不复制凭据，也不保存账号 Token。账号额度查询由 Codex App Server 复用本机已有的 Codex 登录状态。这个查询是只读的，不会创建模型对话。
本地部分只扫描 Codex sessions 日志并生成缓存。项目没有接入分析统计，也不把本地 Token 数据上传到开发者服务器。
不过，任何能读取本地文件的工具都应该谨慎对待。安装前可以先看 GitHub 仓库源码，重点关注 CodexLogScanner.swift、CodexAccountUsageClient.swift 和缓存逻辑。如果不希望第三方构建包读取 sessions 目录，直接自行编译是更稳妥的选择。
网络失败时会发生什么
如果网络或 Codex App Server 暂时不可用，账号额度同步可能失败。Codex Meter 会回退到本地最近一次 rate_limits 快照，并在界面上标明“本地快照”。
这样做的目的，是让本地 Token 面板和热力图继续可用，而不是因为一次网络错误让整个工具失效。但本地快照可能没有包含其它客户端刚产生的用量，所以不要把它当作实时数字。
这是一个怎样的 Web Coding 项目
严格来说，Codex Meter 不是网页，而是原生 macOS 应用。它更像一次 AI Coding 实战：需求拆解、Swift 界面、日志解析、账号额度同步、真实日志测试、Universal Binary 打包、GitHub 开源和 Release 发布，全部围绕一个可运行的交付物推进。
如果你正在学习怎么把 Codex 用到真实项目，可以先看Codex 新手教程，再看Codex 插件高效使用指南。前者帮助你建立项目和验收习惯，后者更适合补齐浏览器、桌面应用、视频和演示文稿等执行能力。
当前版本还有哪些限制
推荐一个自己做的工具，也应该把限制写清楚。
第一，当前版本没有 Apple Developer ID 签名和公证，首次打开会多一步系统确认。
第二，在线额度同步依赖已登录且版本较新的 Codex Desktop 或 Codex CLI。如果账号查询不可用，只能看到本地活动和最近快照。
第三，Codex sessions 日志字段不是公开稳定 API。以后 Codex 更新日志结构，解析器可能需要跟着调整。
第四，本地 Token 是估算，不是账单。它适合看趋势，不适合做费用结算。
这些限制都已经写进 README。后续如果接口或日志结构变化，也会优先在 GitHub 仓库更新说明。
常见问题
Codex Meter 是免费的吗？
是。项目使用 MIT 许可证开源，源码和当前 Release 都可以在 GitHub 查看。使用 Codex 本身仍受你的 OpenAI 账号套餐和平台规则约束。
它能显示其它设备上的 Token 吗？
本地 Token 统计只来自当前配置的 sessions 目录，不能自动汇总其它设备的本地日志。账号额度是账号级查询，可以包含同一账号在其它 Codex 客户端产生的额度消耗。
为什么热力图和额度百分比对不上？
因为它们不是同一套数据。热力图是当前 Mac 的本地 Token 活动，额度百分比是账号级窗口状态，两者不应该直接换算。
Intel Mac 能运行吗？
当前安装包是 arm64 与 x86_64 的 Universal Binary，支持 Apple Silicon 和 Intel Mac。系统要求为 macOS 13 或更新版本。
安装包被系统拦截安全吗？
被拦截的主要原因是当前版本未做 Apple 公证，不等于系统已经判断它包含恶意代码。你仍然应该只从项目 GitHub Release 下载，并根据自己的安全要求查看源码、核对 Release 或自行构建。
总结
Codex Meter 解决的是一个小而具体的问题：让经常用 Codex 的 Mac 用户不用到处找，就能看到账号额度、本地 Token 活动和一段时间内的使用趋势。
它不会替代官方账单，也不会改变账号额度。把数据来源、降级状态和隐私边界看明白以后，它就是一个比较轻量的菜单栏监控工具。
下载地址：v1.1.0 Release
如果你在使用中遇到日志解析、额度同步或界面问题，可以在 GitHub 提交 Issue。提交前请删掉截图和日志里的账号、路径及其它隐私信息。