tokentab

工具简介

tokentab 是一款本地运行的 CLI 工具，读取 Claude Code、Codex、Cursor 和 Gemini CLI 在本地留下的会话日志，自动统计各模型、各项目、各日期的 token 用量和费用。完全不联网、不需要账号、不需要 API Key，数据全部来自本机日志。

核心能力

1. 多工具覆盖：同时读取 Claude Code、Codex 和 Gemini CLI 的会话日志
2. 多维度费用统计：按模型、项目、日期、工作类型分类统计
3. 本地 Web 面板：python cli.py -web 启动图表化月度账单，纯本地，断网可用
4. 价格表本地维护：不需要联网，模型名称模糊匹配支持
5. 无依赖安装：pip install 即可，无第三方运行时依赖

安装配置

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

使用步骤

1. 基础查看：python cli.py
2. 仅今天：python cli.py -today
3. 查看当月：python cli.py -month
4. 指定项目：python cli.py --project myapp
5. 时间范围：python cli.py --from 2026-06-01 --to 2026-06-15
6. Web 面板：python cli.py -web（启动 http://localhost:4747）

适用场景

1. 个人开发者成本追踪
2. 团队用量审计
3. 同一任务在不同模型上的 token 用量和费用对比
4. 预算管理

适用人群

频繁使用 Claude Code、Codex、Gemini CLI 等 AI 编码工具的开发者，以及需要追踪 AI 工具使用成本的自由职业者和小型团队。

工作原理

Token 数据直接解析各工具本地日志，Claude 缓存 token 单独处理避免重复计费，价格表为本地 JSON 文件。

官方链接

GitHub：https://github.com/crwdla/tokentab