Codex

Codex 用量面板看不到 token 数了?几个能查消耗的地方

编辑部阅读约 6 分钟

有用户发现 Codex 的使用情况页里 Analytics 存在 bug,底部用量也只剩百分比,看不到具体 token 消耗。本文梳理官方几个仍能看到用量的入口、桌面客户端的具体点击路径、热力图与剩余额度的区别,并给出拿不到官方数字时用本地会话日志自行统计的做法和排查清单。

最近一段时间,不少 Codex 使用者发现「用量」这件事变得不透明了:在设置里的「使用情况和计费」中,Analytics 标签页存在显示异常,页面底部的用量信息也不再给出具体数字,只留下一个百分比。于是「今天到底跑了多少 token」这个问题,突然没法一眼回答。

需要先明确一点:这通常不是账号出问题,也不是额度被清零,而是展示口径变了。产品把「剩余额度」以百分比和窗口的形式呈现,把「用了多少」拆到了别的入口,甚至在部分页面上暂时失灵。下面按「哪里还能看」「为什么变成这样」「看不到数字时怎么办」三个层次整理。

一、先确认:这是普遍现象,不是个例

如果你遇到的情况符合下面几条,基本可以判定是面板层面的变化,而不是个人配置错误:

  • 设置 → 使用情况和计费 → Analytics 打开后数据不全或有渲染问题;
  • 页面底部的用量区域只显示百分比,没有绝对 token 数;
  • 换个浏览器、换台机器结果差不多;
  • 但对话、代码生成等核心功能完全正常。

核心功能正常就说明套餐和鉴权没问题,剩下的是「数据在哪里展示」的问题。

二、按入口逐个找:能看用量的几个地方

不同入口提供的信息粒度差别很大,先看这张对照表:

入口 大致能看到什么 适合场景
Web 端「使用情况」页 额度窗口的消耗比例、部分统计 判断还剩多少额度
桌面客户端头像菜单 订阅信息、用量概览 快速自查
个人资料页 账号与用量的概要信息 确认账号、工作区是否正确
活动热力图 每日活跃强度(相对值) 看长期使用节奏
CLI 的状态命令 当前会话的上下文与用量情况 单次任务排查

桌面客户端:路径比网页更直接

在 macOS 客户端上,用量的入口被放在了头像菜单里,操作顺序是:

  1. 打开 Codex 桌面客户端并登录;
  2. 点击左下角的头像;
  3. 在弹出的窗口里,再点顶部带用户名头像的那一栏;
  4. 进入后即可看到订阅与用量相关信息。

第 3 步里的「再点一次」是最容易被忽略的地方——很多人在第 2 步弹出的菜单里没找到数字就放弃了。如果你用的是 Windows 或 Linux 客户端,菜单位置可能不同,但逻辑类似:先点头像,再进账号详情。

个人资料页与热力图

个人资料页主要解决「我是不是登错了账号或工作区」这个问题。团队版、多组织账号经常出现用量统计对不上的情况,原因就是当前工作区选错了。

热力图给出的是每天的使用强度分布,能看出「哪天写得多、哪天几乎没动」,但它本质上是相对值,不要拿它去反推精确 token 数。它的价值在于观察趋势:比如接入自动化脚本后,热力图会明显变密。

命令行里的状态查看

在交互式会话中,输入 /status 之类的状态命令,通常能看到当前上下文窗口的占用情况和额度窗口的剩余比例。具体字段随版本变化,以你本机实际输出和官方文档为准。这个入口统计的是当前会话,不是账号历史总量。

三、为什么官方越来越不愿意直接给绝对数字

原因大致有三类,理解之后就不容易把「看不到」当成「被针对」:

  1. 绝对 token 数容易误导。 不同模型的计价方式不同,缓存命中与否、输入输出比例都会影响实际消耗。同样是「一亿 token」,成本可能差出数倍,给一个笼统的数字反而会引发误判。
  2. 额度改成窗口制。 现在更常见的表述是「某时间段内可用多少」,这种机制下百分比和重置时间比累计总量更有意义。
  3. 页面改版期的过渡问题。 Analytics 这类偏运营向的面板经常在改版中被调整,出现渲染或数据缺失并不奇怪。

需要提醒的是,各家对额度窗口、包含模型的说明调整较频繁,涉及具体额度、计费规则时请以官方最新文档和账号内的实际显示为准。

四、官方数字缺失时,自己统计一份

如果确实需要精确到每天多少 token,最稳的办法是从本地会话记录入手。Codex 的命令行客户端通常会把会话过程以 JSONL 形式落盘,路径类似:

ls ~/.codex/sessions

目录一般按年月日分层,每个会话一个文件,里面会记录消息、工具调用以及 token 统计事件。先抽一个文件看看实际结构,再做汇总:

head -n 5 ~/.codex/sessions/YYYY/MM/DD/*.jsonl

确认字段名之后,用 jq 抓取统计事件并累加。下面只是示意,字段路径务必按你看到的实际结构调整:

jq -r 'select(.type=="event_msg" and .payload.type=="token_count")
  | .payload.info.total_token_usage.total_tokens' \
  ~/.codex/sessions/YYYY/MM/DD/*.jsonl \
  | awk '{s+=$1} END {print s}'

把单日目录换成按月遍历,就能做出自己的日报表。几点需要注意:

  • 本地日志只覆盖本机跑过的会话,网页端或其他设备上的使用不会出现在里面;
  • 统计事件通常记录的是累计值或增量值,先确认语义,否则会把总数重复累加;
  • 日志属于本地文件,清理缓存或重装可能丢失,重要数据建议定期归档。

如果你经常在多台设备之间切换,日志会散落在各处,汇总起来很麻烦。把长时间运行的批处理任务放到一台常开的机器上执行(例如机房里的独享 Mac,远程连接使用),日志和用量就会集中在一个位置,也不会因为本地合盖休眠导致会话中断。

五、排查清单:确认是不是你自己的环境问题

在断定「官方把数字藏了」之前,按顺序过一遍:

  • 客户端是否为较新版本,旧版本菜单结构可能完全不同;
  • 是否登录了正确的工作区/组织;
  • 换一个浏览器或无痕窗口,排除缓存导致的渲染异常;
  • 退出重登,刷新鉴权状态;
  • Analytics 页面是否有延迟,隔几小时再看一次;
  • 不同订阅类型的可见范围本来就不同,别拿别人的截图当基准。

如果以上都正常,那大概率就是面板本身的问题,不必反复折腾账号设置。

六、几种做法的取舍

  • 只关心额度够不够用: 看百分比和重置时间最省事,热力图做趋势参考,不必纠结绝对数字。
  • 要对账或做成本核算: 以官方账单和用量页为准,本地日志作为交叉验证,两者口径不同,不要强行对齐。
  • 要优化提示词、降低消耗: 本地日志更有价值,能看到单次任务的 token 分布,比总量数字有用得多。
  • 团队协作: 统一在一台固定机器上跑任务,或约定统一的工作区,否则统计永远对不齐。

小结

用量面板从「给数字」变成「给比例」,是产品展示口径调整的结果,核心功能并不受影响。眼下想查用量,桌面客户端的头像菜单和个人资料页是较快路径,热力图看趋势,命令行状态命令看单次会话。真要精确统计,从本地会话日志自己汇总最可靠,但要清楚它只覆盖本机。涉及额度规则、计费方式这类会变动的信息,仍以官方最新说明为准。

Codex用量统计token消耗额度查询客户端