damejan80/tokentab

它是什么

tokentab 是一个 Python 编写的命令行工具，专门解析 Claude Code、Codex 和 Gemini CLI 的会话日志，自动核算每个模型、项目和日期的 Token 消耗及费用，让 AI 编程成本一目了然。

核心亮点

• 多端兼容：原生支持三大主流 AI CLI 工具的日志格式
• 多维统计：按模型、项目、日期三个维度交叉分析支出
• 零配置解析：自动定位日志路径，无需手动导出或转换
• 轻量快速：纯 Python 实现，秒级完成本地日志扫描

为什么火

AI 编程工具普及后，开发者普遍面临“月底账单惊吓”——不知道钱花在了哪个项目、哪个模型上。tokentab 精准切中这一痛点，将散落的会话日志转化为结构化成本报告，让每一分 Token 花费都有据可查，上线后迅速获得 1100+ Star。

适合谁用

• 重度使用 AI 编程助手、需要做成本分摊的团队负责人
• 独立开发者，想监控个人 API 支出避免超预算
• 对 Token 消耗敏感，希望优化提示词和调用策略的工程师

快速上手

# 安装
pip install tokentab

# 查看今日所有项目的费用汇总
tokentab today

# 按项目维度查看本周明细
tokentab report --period week --group-by project

# 导出 CSV 用于财务对账
tokentab export --format csv --output costs.csv

项目采用 MIT 协议，支持自定义日志路径和费率配置，可无缝集成到现有开发工作流中。