Tokentab

为什么需要

Claude Code、Codex、Gemini CLI 都是按 token 计费的，但官方 Dashboard 不够细致，看不到每个项目、每种任务消耗了多少。独立开发者同时用几个 AI 编程工具时，月底对账才发现某个项目跑超了——Tokentab 就是为解决这个问题写的。

它直接读本地 session log（~/.claude/projects/、~/.codex/sessions/、~/.gemini/tmp/），不调 API、不上传任何数据，所以即使计费 API 限流了它也能正常工作。

怎么用

安装：

git clone https://github.com/damejan80/tokentab
cd tokentab
pip install .
tokentab

默认显示最近 7 天的总用量。支持这些 flag：

• tokentab -today — 只看今天
• tokentab -month — 本月至今
• tokentab -p all — 全部历史
• tokentab --provider claude — 只看 Claude Code
• tokentab --project myapp — 只看某个项目
• tokentab --json | jq . — 机器可读
• tokentab -web — 启动本地 Web dashboard（监听 127.0.0.1:4747）

Web dashboard 把同样的数据画成月度账单样式，总额置顶、各项明细分列。每次请求都从磁盘读，所以数据永远新鲜，不缓存。绑定仅 localhost，连 CDN 字体都不拉——断网也能用。

使用案例

独立开发者李明同时用 Claude Code 写后端、Codex 写前端、Gemini CLI 跑实验，跑了一个月后用 tokentab -p all --json 导出全量数据，发现 Gemini CLI 跑 Python 实验那周烧了 $87，而 Claude Code 写生产代码只花了 $32。于是把实验类工作全切到本地 Ollama 上，月度 AI 成本从 $400 降到 $180。

Cursor 那个 slot 目前是 stub，作者在 README 里写了 TODO，说明还在适配阶段。

注意事项

• 完全本地，不会自动同步云端 dashboard，要看跨设备数据得自己合并 log
• 价格表是 hardcode 的，Anthropic/OpenAI 调价后需要等作者更新
• Web dashboard 默认绑定 localhost，不会暴露到公网，安全