用量、额度、余额：三个常被混为一谈的数字

第一个数字：Token 用量，来自你自己的磁盘

第一个数字是 Token 用量。Claude Code 和 Codex 每个会话都会写一份转录文件，里面记着每一轮的 Token 数。把一个时间窗口内的数字加起来，就是 Agent 在过去 5 小时或 7 天里消耗了多少。不需要 API 密钥，不需要账户，不需要网络。Token 数在本地读取，不会发到任何地方。

两个一起跑的时候，到底是 Claude Code 还是 Codex 更费钱？任务进行到一半时，只有这个数字答得出来。三个数字里，只有它按 Agent 工具拆分，而不是按账户合并。不过它不按分屏拆：两个 Claude Code 分屏共用一个总数。

读的时候要留心，因为长会话里的大部分 Token 是缓存读取：Agent 已经发过的上下文，每一轮都从服务商的缓存里原样取回。合成一个总数，看起来吓人。

拆开看，新输入、输出和缓存写入加在一起只占一小部分。只给一个大总数、不把缓存读取单独列出的工具，给你看的是一个无缘无故吓人的数字。

第一个数字的金额版本，以及它为什么要留余地

MXterm Pro 的 Token Meter 按一张价格表给每个模型定价，并显示这张表上次核对价格的日期。没有日期的价格表，不知不觉就成了虚构。

没有公开价格的模型不会显示成 $0.00，而是标为“未定价”，因为“$0.00”读起来是免费，实际情况是“我们不知道”。这时总额会标成下限，而不是总数，并列出没有定价的模型。

更大的限定在于这个数字的含义。在 Max 或 Pro 订阅下，这个美元数字是这些 Token 按按量付费的 API 价格折算出的金额，不是你的账单。转录文件里没有任何信息说明某一轮是哪个套餐付的钱，所以只读转录文件的工具无法知道你实际被扣了多少。

第二个数字：套餐额度百分比

你的磁盘回答不了“我还剩多少”，而这恰恰是大家真正想问的问题。Claude Code 的转录文件里没有任何字段记录订阅已经用了多少：MXterm Pro 的开发者在自己的转录文件里搜索限流和额度字段，每个匹配都是消息里的文字，没有一个是数据字段。套餐额度百分比只能来自服务商。

在 macOS 上，MXterm Pro 用 Claude Code 保存的登录信息，从 Anthropic 自己的用量接口取 Claude 的百分比。这意味着要读取另一个应用的凭据。MXterm Pro 通过系统的 security 工具来读，所以 macOS 不会每次都询问。Windows 上不可用。

这个开关在你打开之前是关着的，打开前会明确说明它要做什么。被拒绝之后，应用不会再反复询问，也不会每次刷新都弹出对话框。

Codex 是例外。它的 CLI 会把套餐自己的限流响应头写进会话文件，所以这些百分比本来就在你的磁盘上，不需要凭据。问题在于新鲜度：上一轮 Codex 写入的读数，和那一轮一样旧。

1.0.22 新增了一个开关，读取 Codex 自己的登录文件，直接向 OpenAI 查询当前的 5 小时窗口和每周窗口。开始一件耗时很长的事之前，以套餐百分比为准来决定怎么做。

第三个数字：账户里还剩什么

第三个数字属于你实际付钱的那一方，形态取决于服务商。DeepSeek 或 Moonshot 这样的预付服务商给你的是预付余额：只会减少，直到你充值。Kimi、MiniMax 或 Z.ai 这样的编程套餐，给你的是一个会刷新的窗口里的剩余容量。

OpenRouter 的密钥如果设了花费上限，会显示已用上限的比例；没设上限，就只显示这个密钥花了多少。MXterm Pro 不读取 OpenRouter 的账户余额。每个读数都来自服务商自己的账户接口，用的是你粘贴进去的 API 密钥。这个来源和另外两个数字不同，只有它知道你已经付过的钱。

接入任何一个之前，请先完整读一遍各服务商开放了什么，以及这些密钥存在哪里。账户读取遵循各厂商公开的响应格式，但并非每一个都已对照真实账户验证过。

余额也很难做成仪表，因为它没有分母。DeepSeek 里的 $37.40 额度，除非你自己编一个“满”是多少，否则不是任何东西的百分比。MXterm Pro 把它显示为金额，从不换算成百分比。在标题栏的小标签里，余额从不和额度窗口排名；只有在没有额度、也没有 Claude Code 或 Codex 用量可显示时，小标签才显示最低的美元余额。

各自真正派上用场的时候

开始长时间运行之前，看套餐百分比。Token 用量告诉不了你二十分钟后会不会撞墙，而如果限制来自 5 小时的订阅窗口，预付余额再充足也没用。

同时运行 Claude Code 和 Codex 时，看 Token 用量。

出问题的时候，三个数字互相对不上，本身就是诊断。套餐到了 100% 而余额充足，说明你被限流了，不是没钱了。套餐百分比正常而预付余额见底，则正好相反。如果 Token 用量正常，另外两个也没问题，那问题根本不在额度上。

到了月底，三个数字都不是你的发票。从转录文件推算的费用按 API 价格计，套餐百分比不是钱，余额只是一个快照。厂商的账单页才是依据，也是唯一应该用来解决“到底收了我多少钱”这类争议的东西。

怎样把三者放在一起读而不自欺

把 Claude Code 用量和套餐额度放在一起读，要守三条规则，不管你在哪个工具里看这些数字都一样。

第一，凡不是实时计算的数字，都要看它的时间。服务商读数失败后，会继续显示上一次成功的值。这样做是对的，前提是界面把这件事标出来。

第二，不要在它们之间换算。Token 用量不能变成套餐的百分比，因为你不知道分母。百分比不能变成金额。余额不能变成剩余轮数。每一种换算都需要一个没人公布过的数字。

第三，把百分比看作属于某个有重置时间的特定窗口。“已用 90%”本身没有意义，要先知道这是二十分钟后重置的 5 小时窗口，还是周日重置的每周窗口。

在 MXterm Pro 里，每一行都标明进度条属于哪个窗口，以及什么时候重置。已经重置的窗口显示一个短横线，因为过期的数字会被当成当前的数字。另见 Token Meter 页面和 Token Meter 文档。