tokentab Skill：让你的 AI 编程工具消费从糊涂账变透明

Skill超级捕获手 技术创作者 2026-09-02 16 阅读

你的 AI 编程助手的花费是一笔糊涂账吗？tokentab 这个开源 CLI 工具把你的 Claude Code、Codex 和 Gemini CLI 的用量数据从本地日志里直接捞出来，按模型、按项目、按天分别算出账单——全离线、不上传、一个命令出报表。

功能与原则

tokentab 读取三大 AI 编程 CLI 工具已经存在本地的会话日志（JSONL 格式），解析出每次调用的 token 消耗，乘以当前定价表得出费用。核心原则：数据不离开本机，不依赖任何网络请求，不创建任何账号。日志读到什么就展示什么，定价表是本地 hand-kept 的静态文件，永不断网。

认可度

  • GitHub star：约 673（截至 2026-09-02）
  • 定位为 AI 编程工具成本可见性细分赛道，2026 年 8–9 月在 GitHub Trending 和多个 AI 开发社区获得曝光
  • 搜索热度在近期显著上升，属新晋 trending 工具

链接

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

原作者

GitHub 用户 damejan80，项目以 MIT 许可证开源。

介绍

Claude Code、Codex、Gemini CLI 这类工具每次运行都会在本地留下 JSONL 格式的会话日志，记录每次 API 调用的 token 用量。但这些数据散落在不同路径、不同工具之间，普通用户根本没有动机去汇总分析。tokentab 解决了这个问题——它是一个即装即用的 Python CLI，解析日志后输出费用报表。

支持的三种工具及其日志路径：

  • Claude Code：~/.claude/projects/**/*.jsonl
  • Codex：~/.codex/sessions/**/rollout-*.jsonl
  • Gemini CLI：~/.gemini/tmp/**/session-*.json

工具本身不安装任何代理，也不主动联网定价（定价表在本地 tokentab/pricing/prices.py）。由于 Claude 的缓存按读/写分开统计，tokentab 会先把缓存部分减掉，避免同一批 token 被算两次钱。

特点

  • 全离线运行：无账号、无 API key、日志数据不上传，本地处理完毕
  • 多工具聚合：Claude Code、Codex、Gemini CLI 三合一视角，统一报表
  • 多维度拆分：可按模型、按项目、按天分别看费用
  • 内置 Web 看板：tokentab -web 起一个本地 HTTP 服务（纯 Python 标准库，无 Flask 等依赖），浏览器里看图表
  • 机器可读：--json 输出适合管道到其他系统或写进 PR

使用方法

# 克隆安装
git clone https://github.com/damejan80/tokentab
cd tokentab
pip install .

# 默认查最近 7 天全部费用
tokentab

# 只看今天
tokentab -today

# 看本月
tokentab -month

# 指定项目
tokentab --project myapp

# 指定时间窗口
tokentab --from 2026-06-01 --to 2026-06-15

# JSON 输出（适合管道）
tokentab --json | jq .

# Web 看板（浏览器打开）
tokentab -web

使用场景与人群

适用场景：
– AI 编程工具重度用户想了解月度成本分布
– 团队 Lead 需要统计各成员 Claude Code 消耗
– 开发者想找出哪个项目用了最贵的模型做最小的事

目标用户： 使用 Claude Code、Codex、Gemini CLI 之一或组合的开发者，尤其是订阅了多个模型套餐、想搞清楚账单构成的人。

输入与输出案例

案例 1：查今早的花销

tokentab -today

输出（示意）：按模型拆分的今日总费用，例如 claude-opus-4-6-20260514 $2.34 | claude-sonnet-4-6-20260514 $0.87 | Total $3.21

案例 2：指定项目按月汇总

tokentab --project backend-api --from 2026-08-01 --to 2026-08-31

输出：该月 backend-api 项目下各模型的 token 消耗和费用，并按调用类型（coding/debugging/exploring）区分活动类型。

GitHub: https://github.com/damejan80/tokentab

评论区

0 条评论

登录后可评论。

Skill超级捕获手 16 阅读