Claude Code 和 Codex 的 Token 用量：Token Meter 读取什么

Token Meter 显示什么

只要装了某个 Agent，或保存了账户密钥，Token Meter 就会有内容可显示。它位于标题栏右侧的按钮组里，应用开着就一直在，不用打开面板去找。

栏上只有一个数字：所有额度里最紧张的那一个，颜色表示接近上限的程度。如果你配置的提供商都不公布额度，按钮上显示 Claude Code 最近 5 小时的 Token 总数；没装 Claude Code 时显示 Codex 的。没有 Agent、只有账户余额时，显示最低的美元余额。

点开能看到汇总。你配置过的每个提供商占一个两行的条目：第一行是名称和最关键的重置时间，第二行在已知限额时显示 5 小时和每周的进度条，否则显示今天的花费和 Token 数。你在设置 → Token Meter 里置顶的提供商排在最前面（不改的话是 Claude Code，也可以不置顶）。

展开一行，看这个 Agent 的完整明细。里面有最近 5 小时和最近 7 天用掉的 Token 数，用 K、M 或 B 缩写，还有最近 24 小时的迷你柱状图，每小时一根柱子。费用卡片按 API 价格显示今天和最近 7 天的估算费用，并标出价格表上次更新的日期。

7 天明细包括新增输入、输出、写入缓存、读取缓存和对话轮数。数据在后台大约每分钟刷新一次。

Agent 只有装了才会出现，也就是它的会话记录文件夹存在。本机没有 Agent、也没保存账户密钥时，Token Meter 什么都不渲染，而不是显示一个空仪表。读数为零的仪表等于说你什么都没用过，这和“不知道”不是一回事。

Token Meter 从磁盘读取哪些 Agent

Token 数只有一个来源：每个 Agent 保存在你磁盘上的会话记录。Claude Code、Codex、Gemini CLI 和 omp 会在各自的记录里写下每一轮的 Token 数。Token Meter 不调用提供商的 API，也不要求你登录。不用粘贴 API Key，不用连接账户，Token 数的统计也不会把任何内容发到别处。

名单有四个名字，是因为它读取 Claude Code、Codex、Gemini CLI 和 omp 的会话记录文件夹。OpenCode 不读，所以对它什么都不显示，而不是给个猜测值。

1.0.22 加入了第二个独立的来源，不是会话记录。在设置 → Token Meter 里为六个账户提供商中的任意一个粘贴 API Key，每个提供商会有自己的一行，显示它从自家端点报告的内容：余额、套餐额度或花费。这是另一种测量，注意事项也不同。把这些数字当成可以互换之前，先读用量和余额的区别。

为什么读取缓存单独一行

长时间的 Agent 会话里，大部分 Token 是读取缓存：Agent 已经发送过的上下文，每一轮新对话都从提供商的缓存里再取一遍。和其他数据加在一起算，会让会话看起来比实际大得多。

单独列一行，读取缓存就不会干扰判断，你能看清会话其余部分实际用了多少。

它不显示什么

默认情况下，Token Meter 报告的是已花掉的 Token，不预测你还能跑多少。Claude Code 的会话记录里没有订阅进度，所以 Claude 的百分比需要另一个来源。Codex 的会话文件带有它的额度读数，但新鲜度只到你上一轮 Codex 对话。现在有两个可选开关，各自提供实时数字。

对 Claude，1.0.21 加入了套餐限额，仅限 macOS。在设置 → Token Meter 里打开。应用会通过系统的 security 工具，从 macOS Keychain 读取 Claude Code 保存的登录信息，所以 macOS 不会每次都询问。它从 api.anthropic.com 获取你真实的套餐用量，最多每 5 分钟一次。

对 Codex，1.0.22 加入了实时 Codex 限额。它从 ~/.codex/auth.json 读取 Codex 的 ChatGPT 登录信息，只发给 chatgpt.com，用来获取当前的 5 小时和每周窗口。

设计上它只读取这个文件。令牌过期时不会发出任何请求，只会提示你运行 codex。如果登录信息存在系统 Keychain 里，则完全不读取。两个开关在你打开之前都是关闭的。

Codex 是即使开关关着也有数字的那个。它自己的 CLI 会把套餐的额度读数写进会话文件，Token Meter 就从已经在扫描的同一批行里读出来。这个读数只和你上一轮 Codex 对话一样新，这正是实时开关存在的原因。

5 小时和 7 天的数字，是从当前时刻往回看的窗口。“最近 5 小时用了多少”就是这个数字的全部含义，它说明不了你的套餐允许多少。

适合谁用

Token Meter 是为同时运行 Claude Code 和 Codex 的人做的，不管是分屏并排，还是一起放进 Control Room（原 War Room）。不用切进任何一个 CLI 去问，就能看出是哪个在消耗 Token。如果你只是偶尔用一个 Agent，它能告诉你的不多。另见 Token Meter 页面和 Token Meter 文档。