tokentab：把 Claude、Codex、Gemini 的会话账单打出来，看清每天到底烧了多少
一个 Python 小工具，专门读 Claude Code、Codex、Gemini CLI 的本地会话日志，按模型、按项目、按天算账。一周拿下 664 颗星
适合：同时跑 Claude Code、Codex、Gemini CLI，想搞清楚每天到底烧了多少 token 的开发者
先说结论
如果你同时跑 Claude Code、Codex、Gemini CLI 这几路AI编程助手，月底想算清楚到底烧了多少 token、哪个模型最费钱、哪个项目像个无底洞，tokentab 就是那个现成的答案。它不联网猜，直接读你本地的会话记录，按模型、项目、天数拆账，一行命令就能出表。
真正的问题
CLI 工具有个老毛病：聊得爽，花得糊涂。
平时在 IDE 里贴一段提示词、发一段对话，体感上好像不贵。但几路 CLI 同时开、来回切换模型、上下文一长，账单就悄悄往上走。等你月底想复盘“这钱花在哪了”，日志散落在 Claude、Codex、Gemini 各家目录，格式还不一样，肉眼根本拼不起来。
更尴尬的是，定价表总在变。Claude 一个价、Codex 一个价、Gemini 又一个价，输入输出还分两套系数，靠脑子记根本记不住。于是大家普遍遇到三个具体障碍：
- 日志路径散，找不全。Claude Code、Codex、Gemini CLI 各自一套目录约定，跨平台还略有差别。
- 计费口径乱，没法对齐。同样是“一次会话”，Claude 按 token 走、Codex 按请求走、Gemini 又混着来。
- 没有时间轴，看不出节奏。一天花三块和一天花三十块，看起来都是“今天在用AI”。
tokentab 的解法很朴素：把日志读出来，统一换算成美元，再按模型、项目、日期三个维度切片。它不替你做决策，但把账本铺平了。
怎么做更省力
安装没什么门槛，Python 装好之后一条命令就完事：
pip install tokentab
tokentab不带参数直接跑，它会扫描默认路径下的会话日志，在终端打出一张总览：今天花了多少、本周花了多少、按模型怎么分布。再往后加几个常用参数，就能切到自己关心的维度：
- 按项目分组：找出哪个仓库最费钱。
- 按日期看趋势：哪天突然飙了，是不是切了贵模型。
- 按模型对比：Opus、 Sonnet、GPT‑5、Gemini Pro 各自贡献了多少。
下面这张表，是常见几种 CLI 在 tokentab 里通常呈现的口径差别，可以拿来对着看自己的账单：
| 工具 | 日志默认位置 | 计量口径 | 适合算账的维度 |
|---|---|---|---|
| Claude Code | ~/。claude/projects | 按输入/输出 token | 项目、模型、天 |
| Codex CLI | ~/。codex/sessions | 按请求与 token 混合 | 天、模型 |
| Gemini CLI | ~/。gemini/tmp | 按 token 段累计 | 项目、天 |
实操上有两个小经验：一是第一次跑最好加 --dry-run，先看它扫到了哪些文件，确认日志路径没漏；二是周末固定拉一次周报，比每天盯要轻松，也更容易看出异常。
哪些坑要避开
用之前最好先确认三件事，少踩雷：
- 日志可能被工具清理。某些 CLI 默认保留窗口很短，旧记录被回收后 tokentab 自然就读不到。想算完整月度账，建议月初先备份一份。
- 定价表来自官方，但官方会调。tokentab 维护的是当时的快照，跨月对比时心里要留个“调价”的余量，别把波动全归到自己头上。
- 别把它当限流工具。它只算账，不限制调用。真正要控成本，得在它给的数字基础上，自己设个每日阈值。
还有一个容易忽略的点：本地日志可能包含代码片段和提示词原文，如果要分享报表，注意先脱敏，别把项目结构一并丢出去。
现在就能动手
今天就能做的三步，不复杂：
1。 先装上 tokentab，在项目根目录跑一次默认命令，看看它到底扫到了哪些 CLI 的日志。 2。 按周导出一次报表，重点对比“哪个模型用得最多”和“哪个项目花得最猛”，把这两个数字记在记事本里。 3。 给下周定一个简单的规则，比如 Opus 级别模型每天不超过 N 次、长上下文任务尽量切到便宜档，然后再跑一次，对比数字变化。
账本摊开之后，调模型、切工作流才有依据。否则省不省钱，全凭感觉。