我订阅了 Codex 的 200 美元套餐，但软件和官网只能看到剩余的五小时额度和本周额度，看不到每个月实际消耗了多少 Token。为了把这部分数据补出来，我写了一个读取 Codex 本地数据库的 Skill，并让它生成统一格式的中文报告。
它的效果是查询 Codex 在本机的实际使用记录，生成一个可视化的中文报告。比如这是我 2026 年 5 月的报告：当月消耗了 37.72 亿 Token，分布在 348 个会话里。
报告里有每天的消耗趋势，指向曲线上的日期点可以查看当天的 Token 数、会话数和均值。
往下还有来源和模型分布的饼图、高消耗日期的条形图。
最底下是几张详细的表格，包括月度明细、每日明细、来源拆分和高消耗会话。
从本地数据库补出用量趋势
在 Codex 里，不论是软件还是官网，都没有办法查看详细的用量情况。软件里只能看到剩余的五小时使用额度和本周使用额度。
我的诉求很具体：查看本月大概消耗了多少 Token、每天用了多少，并从连续数据里看出趋势。
我搜索了 Codex 和 OpenAI 自己的各个平台，确认没有地方能看到这个详细趋势。后来我查到 Codex 本地使用 SQLite 数据库存储数据，于是在 Skill 里写了脚本直接读取数据库，拿到详细信息。Skill 里还有一个用来组装 HTML 的脚本，保证生成的报告格式统一，同时尽量少消耗 Token。最后把它做成了一个完整的 Skill。
安装和使用
Skill 在 GitHub 仓库 oil-oil/codex-usage 里。
仓库里主要是两个脚本：generate_codex_usage_report.py 负责读取数据库并生成报告，render_token_analysis.py 负责把自定义分析渲染成 HTML。
安装方式是把仓库链接直接发给任何一个支持 Skill 的 Agent，让它安装。安装完成后，在对话框里输入斜杠命令调用这个 Skill，它就会运行脚本并把报告组装出来。
如果想绕开 Skill 直接运行脚本，最短命令是：
python3 /path/to/codex-usage/scripts/generate_codex_usage_report.py \
--db "$HOME/.codex/state_5.sqlite" \
--out ./codex-usage-report.html
如果还想查其他信息，比如上个月的数据，或者 Token 主要消耗在哪些方向、哪些话题，可以在调用 Skill 之后继续和 Codex 对话，这些都能查到。
Red Skill 暂时无法分发这类工具
Skill 完成以后，我除了把它放到 GitHub，也尝试使用小红书的 Red Skill 功能来分发。
但我发现一个问题：上传 Skill 的时候把目录拉进来，平台只支持 Markdown 和 TXT 文件，其他格式会被直接过滤掉。
很多 Skill 里都会包含 HTML、Python、JS 这类脚本文件，这本身也是 Skill 规范里常用的文件类型。如果只支持 Markdown 和 TXT，那它只能用来维护一些工作流或者纯文本的经验，限制太多了，大部分 Skill 都没有办法通过 Red Skill 分发。即便出于安全考虑，也应该用更开放的脚本检查机制，而不是只支持两种文本格式。
不过纯文本类的 Skill 还是可以通过 Red Skill 分享的。比如我之前写过一个 Codex 子 Agent 的 Skill，内容就是告诉 Agent Codex 可以调用子 Agent 去读文件，这种纯文本的 Skill 之后可以发到小红书上。
因此，codex-usage 目前仍然通过 GitHub 分发。Red Skill 可以承载纯文本流程，但这类依赖 Python 和 HTML 脚本的工具还不适合放进去。