tokentab Skill：让 Claude Code / Codex 消费透明化的本地 Token 账单工具

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

tokentab Skill：让 Claude Code / Codex 消费透明化的本地 Token 账单工具

在 AI 编程工具越来越普及的今天，同时跑着 Claude Code、Codex 和 Gemini CLI 的开发者不在少数。但问题是——你的 AI 编程助手到底烧了多少钱？这些 Token 花在了哪个项目、哪个模型、哪一天？大部分人心里没数。tokentab 正是为解决这个”黑盒账单”痛点而生的 Skill：它直接读取各编程助手的本地会话日志，离线解析出精准的 Token 用量与成本，按模型、项目、日期多维度拆分，所有数据不离开你的机器，没有任何账号和 API Key 要求。

功能与原则

tokentab 本质上是一个本地 CLI + 可选 Web 面板。它的核心能力有三个：

  • 离线解析会话日志：直接读取 Claude Code（~/.claude/projects/**/*.jsonl）、Codex（~/.codex/sessions/**/rollout-*.jsonl）、Gemini CLI（~/.gemini/tmp/**/session-*.json）的本地日志文件，提取 Token 用量数据。
  • 多维度成本拆分：按模型、项目、日期、使用类型（coding/debugging/refactor/testing 等）分别统计，帮开发者看清楚钱花在哪里。
  • 隐私优先：所有数据不联网、无需账号、无需 API Key，完全在本地运行。价格表也维护在本地文件中，永不主动联网查询。

设计原则是”数据不离开机器一步”——没有上报、没有遥测、没有账号体系。

认可度

截至 2026-09-16，tokentab 在 GitHub 已有约 605 颗星（上线约 6 天，增长速度约 164 颗/天），Twitter/X 上有多个开发者讨论，被多个 AI 资讯账号转发推荐。在 GitHub Trending 和 Trendshift 的 AI Coding Assistant 分类中均榜上有名，是近期上升速度最快的新兴开发者工具之一。

链接

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

原作者

crwdla（GitHub 个人开发者），目前主要围绕 Claude Code / Codex 生态开发实用工具，tokentab 是其代表作之一。

介绍

Claude Code、Codex 和 Gemini CLI 每次运行都会在本地留下会话日志，记录了每个 API 调用的 Token 用量。但这些日志散落在不同的路径下，格式也不统一，普通开发者很难直观看到自己花了多少钱、钱花在了哪里。

tokentab 的做法是：直接解析这些本地日志文件，按统一格式输出成本统计。它能识别各平台对缓存 Token 的不同处理方式（例如 Claude 将缓存读写分开统计，Gemini 将缓存计入输入 Token），自动校正避免重复计费。价格表在本地维护，读取后不会联网更新——因为作者认为”稍微过时的数字比崩溃好”。

输出有两种形式：

  • CLI 表格：适合日常快速查看，支持 -today、-month、-p all、--provider claude、--project myapp 等多种过滤维度，管道输出自动去掉颜色代码，方便粘贴到 PR 或聊天窗口。
  • Web 面板（python cli.py -web）：打开 localhost 的本地页面，以月度账单形式展示总览和明细，用系统自带字体，离线也能正常运行。

特点

  • 零配置，零账号：pip install 后直接运行，不需要任何 API Key 或账号注册
  • 全本地，离线运行：所有数据处理在本地完成，日志文件不离开本机
  • 多工具支持：开箱即用支持 Claude Code、Codex 和 Gemini CLI，Cursor 的适配已在结构上预留（未完工）
  • 缓存计费校正：自动识别并剔除重复计费的缓存读写，保证成本估算准确
  • 价格表本地维护：不依赖网络查询价格，内置手维护价格表，模型名模糊匹配容错

使用方法

安装步骤：

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

基本调用示例：

tokentab                          # 最近 7 天所有工具汇总
tokentab -today                   # 仅今天
tokentab -month                   # 本月
tokentab -p all                   # 历史全部记录
tokentab --provider claude        #只看 Claude Code
tokentab --project myapp          #只看指定项目
tokentab --from 2026-06-01 --to 2026-06-15  # 指定日期范围
tokentab --json | jq .            # JSON 格式输出（管道友好）
tokentab -web                     # 启动本地 Web 面板

使用场景与人群

适用场景：
– 同时使用多个 AI 编程助手（Claude Code + Codex + Gemini CLI）并希望统一管理成本
– 团队需要统计每人/每项目的 AI 工具消耗（可本地汇总后上报）
– 个人开发者想了解自己的 AI 编程投入分布，优化模型选择
– 对 AI 工具成本敏感，想找到”小任务用便宜模型”的机会

目标用户： 使用 Claude Code / Codex / Gemini CLI 的个人开发者和小型团队，尤其是同时跑多个工具或多个项目的人。

输入与输出案例

案例 1：日常成本查看
输入：

tokentab

输出：

总计（最近7天）
模型               会话数   Token（输入）   Token（输出）   估算成本
claude-opus-4-6    12       2.1M          340K           $3.42
claude-sonnet-4-6  34       5.8M          890K           $4.17
gpt-4o             8        1.2M          210K           $1.89
──────────────────────────────────────────────────────────────
合计                                                $9.48

案例 2：指定项目成本明细
输入：

tokentab --project myapp --from 2026-09-01 --to 2026-09-16

输出：

项目：myapp（2026-09-01 至 2026-09-16）
日期          模型                 Token（输入）  估算成本
2026-09-01   claude-opus-4-6     340K          $0.54
2026-09-03   claude-sonnet-4-6  180K          $0.13
2026-09-10   claude-opus-4-6     890K          $1.42
────────────────────────────────────────────
合计                                        $2.09

（输出为彩色表格，管道时自动去除颜色代码，可直接粘贴进 GitHub PR 或 Slack）

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

评论区

0 条评论

登录后可评论。

Skill超级捕获手 1668 阅读