TokenTab 教程：算清 Claude Code / Codex / Gemini CLI 的 token 账

📌 项目地址：github.com/crwdla/tokentab | 星数：1,137+ | 协议：MIT | 语言：Python | 数据源：本地会话日志，零API key

📋 项目简介

编码 Agent 的订阅费看似固定，但真实成本是立体的：Claude Code 订阅额度、Codex 按量计费、Gemini CLI 免费层与付费层混用——到底哪个模型在哪个项目上烧掉了最多的钱？TokenTab（crwdla 出品，2026 年 9 月开源即 1,100+ 星）就是回答这个问题的 CLI 工具：读取 Claude Code、Codex 和 Gemini CLI 在本机留下的会话日志，按模型、项目、日期三个维度统计成本。它的聪明之处在于完全不碰 API——日志本来就在你磁盘上，做一个旁路解析器就够了。

💡 为什么需要它：订阅制掩盖的真实用量

2026 年编码 Agent 的计费形态分裂成三层：订阅包月（感觉免费）、按量 API（每 token 计价）、混合模式（订阅额度耗尽自动切付费）。开发者面临的实际问题是：感觉不到花钱的订阅正在训练你挥霍 token 的习惯。一个重型重构任务在 Opus 级模型上的消耗可能是轻量模型的 20 倍；某个项目里 Agent 反复读大文件，另一个项目里你的提示词高效紧凑——没有对账工具，这些差异全部隐形。TokenTab 把三家主流 CLI 的日志拉通成一张账单，让你看到真实口径。统计之后想省钱，配合SoL-Pi效率扩展教程（直接省 token）或my-free-code多提供商网关教程（换更便宜的模型源）就是完整闭环。

🚀 使用方式

TokenTab 是典型的"安装即用"型 CLI：

# 安装（pip 或 GitHub Releases）
pip install tokentab

# 在装了 Claude Code / Codex / Gemini CLI 的机器上运行
# 自动扫描三家工具的默认会话日志目录
tokentab            # 输出按模型/项目/日期聚合的成本报表

工作原理决定了两条使用纪律：在产生日志的机器上跑（它读的是本地文件，不联网不鉴权）；不改动任何 Agent 配置（纯旁路解析，删掉它也不影响 Agent 运行）。三家工具的日志格式各异，TokenTab 抹平了差异——这也是它存在的核心价值。

📊 三个维度各自回答什么问题

✅ 适用与定位

• 适合：订阅+API 混用的重度编码 Agent 用户；团队里想给"AI 编码成本"做核算的管理者；想优化提示词效率的开发者（日期维度就是 A/B 试验的观测面）
• 注意：项目 2026-09-07 创建、迭代初期，功能面以统计报表为主，可视化仪表盘等形态看后续路线

成本三件套的完整拼图：TokenTab 管测量（花到哪）、网关管路由（my-free-code 换源省钱）、扩展管优化（SoL-Pi 省 token）——测量先行，另外两件才知道往哪使劲。