Codex Token 用量统计（codex-token-usage）

一个用于统计本机 Codex 会话 Token 消耗的 Codex Skill。按时间范围汇总每个模型的输入、缓存、输出和总 Token，并以 Markdown 柱状图展示，同时给出估算额度。

功能

• 支持最近 24 小时、最近 7 天、最近一周、最近一个月和自定义时间范围
• 按每轮 turn_context 的真实模型归类，不依赖会话默认配置
• 每个模型显示输入（缓存/非缓存堆叠）与输出柱状图，标签带缓存命中率
• 其余指标（总计、估算额度等）用数字展示
• 末尾汇总所有模型的 Token 总数，表格模式同样支持
• OpenAI 模型使用官方 credit 费率，DeepSeek 使用参考 API 价（可在 pricing.json 调整）

安装

把整个 codex-token-usage 目录放到本机技能目录：

cp -R codex-token-usage ~/.codex/skills/

重启 Codex 后，在对话中直接说：

使用 $codex-token-usage 统计我最近 7 天的 Codex token 消耗

手动运行

python3 codex-token-usage/scripts/codex_token_usage.py --days 7 --chart

可选参数：

• --hours 24：最近 24 小时
• --days 7：最近 7 天
• --week：本周一 00:00 至今
• --month：最近 30 天
• --since 2026-08-01 --until 2026-08-04：自定义日期
• 去掉 --chart 输出 Markdown 表格

输出示例

Codex Token 用量：最近 24 小时

deepseek-v4-flash

输入（缓存命中率 97.0%）
  ███████████████████████░  399,153,778
  █ 缓存 387,217,536  |  ░ 非缓存 11,936,242

输出
  ████████████████████████  1,767,366

总计 401,228,463  |  估算 14.93 USD

总计
  输入 399,469,004（缓存命中率 97.0%）| 非缓存 12,095,052 | 缓存 387,373,952 | 输出 1,768,962 | 总计 401,552,283

数据说明

• 数据来自本机 ~/.codex 的会话记录，仅用于本地估算，可能与官方账单不同
• 费率配置位于 pricing.json，可按实际价格修改