开源一个 Codex Token 用量统计 Skill：一条命令查看最近 30 天、净用量和峰值周

最近在高频使用 Codex 的过程中，我遇到一个很实际的问题：

我到底用了多少 token？哪一天用得最多？最近一周和最近一个月的消耗趋势是什么？缓存到底帮我省了多少？

Codex 本地其实会保存 session 日志，其中包含 token_count 事件。基于这些本地日志，我做了一个 Codex Skill：codex-token-usage，用于统计 Codex 的 token 用量。

项目地址：

https://github.com/huajiexiewenfeng/codex-token-usage-skill

效果：

这个 Skill 能做什么

codex-token-usage 会读取本地 Codex session JSONL 日志，统计一段时间内的 token 使用情况。

目前支持的指标包括：

指标	说明
总量	total_tokens 汇总
Input	输入 token
Cached input	命中缓存的输入 token
Output	输出 token
Reasoning output	推理输出 token
非缓存 Input	Input - Cached input
净用量	非缓存 Input + Output
缓存命中率	Cached input / Input
日均总量	总量 / 统计天数
最多的一天	统计周期内 token 最高的一天
最多的一周	统计周期内 token 最高的一周

其中我个人最关注的是 净用量：

净用量 = Input - Cached input + Output

因为 cached input 是命中缓存的输入 token，直接看总 input 有时会高估实际消耗感知。

安装方式

这个项目已经适配 Skills CLI，可以一条命令安装：

npx skills add https://github.com/huajiexiewenfeng/codex-token-usage-skill --skill codex-token-usage

如果想先查看仓库里有哪些 skill，可以执行：

npx skills add https://github.com/huajiexiewenfeng/codex-token-usage-skill --list

在 Codex 中使用

安装后，可以直接在 Codex 里用自然语言调用：

统计我最近 30 天的 Codex token 用量，包含净用量和最多的一天

也可以统计本周：

统计本周 Codex token 用量，包含缓存命中率和最多的一天

或者统计某个月：

统计 2026 年 4 月的 Codex token 用量

Codex 会读取本地日志，并输出类似这样的表格：

指标	Token 数	说明
总量	757,007,618	total_tokens 汇总
Input	751,097,268	输入 token，包含 cached input
Cached input	671,033,344	命中缓存的输入 token
Output	3,351,840	输出 token
Reasoning output	476,450	推理输出 token
非缓存 Input	80,063,924	Input - cached input
净用量	83,415,764	非缓存 Input + Output
缓存命中率	89.34%	Cached input / Input
日均总量	25,233,587.27	总量 / 统计天数

同时也会给出最多的一天和最多的一周。

也可以直接运行脚本

如果你不想通过 Codex 调用，也可以直接运行仓库里的 Python 脚本。

统计最近 30 天：

python -B skills/codex-token-usage/scripts/codex_token_usage.py --days 30

统计某个自然月：

python -B skills/codex-token-usage/scripts/codex_token_usage.py --month 2026-04

统计指定日期范围：

python -B skills/codex-token-usage/scripts/codex_token_usage.py --start 2026-04-01 --end 2026-04-29

输出 JSON，方便后续做自动化或接入报表：

python -B skills/codex-token-usage/scripts/codex_token_usage.py --days 30 --format json

统计口径说明

Codex 的 session 日志中，token_count 事件里通常有两个容易混淆的字段：

• last_token_usage
• total_token_usage

这个 skill 使用的是：

last_token_usage

原因是 total_token_usage 是单个 session 内的累计值，如果逐条累加，会重复计算，导致总量虚高。

所以正确方式是逐条累加 last_token_usage 中的字段，例如：

last_token_usage.input_tokens
last_token_usage.cached_input_tokens
last_token_usage.output_tokens
last_token_usage.reasoning_output_tokens
last_token_usage.total_tokens

隐私说明

这个 skill 只读取本地 Codex 日志目录：

~/.codex/sessions
~/.codex/archived_sessions

它不会上传日志，不读取认证信息，也不会提交本地 session 数据。

仓库中只包含 skill 本身、统计脚本和测试脚本，不包含任何真实用量日志。

适合谁使用

这个 skill 适合：

• 高频使用 Codex 的开发者
• 想了解自己 token 消耗趋势的人
• 想区分总量和净用量的人
• 想看缓存命中率的人
• 想把 Codex 用量接入自动化统计的人

项目地址

GitHub：

https://github.com/huajiexiewenfeng/codex-token-usage-skill

安装命令：

npx skills add https://github.com/huajiexiewenfeng/codex-token-usage-skill --skill codex-token-usage

如果你也经常使用 Codex，并且想知道自己最近到底用了多少 token，可以试试这个小工具。