💡阅读指南

当你同时用 Hermes、Claude Code、ChatGPT 这些 AI 编程工具时，Token 消耗散落在各处，很难知道每个月到底花了多少钱。Tokscale 是一个用 Rust 写的 CLI 工具，能自动扫描这些工具的本地数据，汇总出一份完整的 Token 使用报告。

🎬
本节附有教学视频 #25

该视频为课程站点内嵌片段，未收录于本地离线包；如需观看请回到线上课程对应课时。

6.1 数据散落在哪里

现在的程序员，同时使用多家服务商的大模型是再正常不过的事情。但一天下来，所有从本机消耗的 Token 到底有多少？

这个问题之所以难回答，是因为每个工具的消耗数据都存在不同的地方：

  • Hermes 的记录存在 ~/.hermes/state.db
  • Claude Code 的数据在 ~/.claude/projects/ 目录
  • ChatGPT CLI 的会话记录在 ~/.codex/sessions/

这些数据各自独立，没有统一的入口去查看。你唯一能感知到 Token 消耗的，可能就是月底收到的账单。

6.2 Tokscale 是什么

Tokscale 是一个开源的 CLI 工具和可视化仪表盘，专门用来追踪多个 AI 编程助手的 Token 消耗和费用。它用 Rust 编写，性能很好，启动几乎是瞬间完成。

名字来源于「卡尔达肖夫指数」（Kardashev scale），一个用来衡量文明技术等级的指标。卡尔达肖夫指数用能量消耗来划分文明等级，Tokscale 则用 Token 消耗来衡量你的 AI 使用强度。在 AI 时代，Token 就是新的能量。

它的核心能力有几个：

自动发现数据源。 不需要手动配置路径，Tokscale 会自动扫描常见 AI 工具的数据存储位置。Hermes、Claude Code、ChatGPT、Gemini CLI、Cursor、Kimi CLI、Qwen CLI 等 30 多个工具都支持。

统一的消耗报告。 把所有工具的 Token 消耗汇总到一起，按模型、按日期、按客户端展示，还能估算费用。

交互式 TUI 界面。 在终端里就能浏览数据，支持键盘导航、排序、过滤，不用离开命令行。

可视化贡献图。 类似 GitHub 的绿色格子，但展示的是你的 Token 使用热力图，还有 3D 版本。

6.3 安装

Tokscale 支持多种安装方式，选最顺手的就行：

Bash
# 通过 npx 直接运行（不需要安装）
npx tokscale@latest

# 通过 npm 全局安装
npm install -g tokscale

# 通过 Bun 运行
bunx tokscale@latest

# Rust 用户可以直接 cargo install
cargo install tokscale

需要 Node.js 18+ 或 Bun 运行时。如果只是想试试看，npx tokscale@latest 最省事，不需要全局安装任何东西。长期使用推荐 npm 安装。

6.4 基本用法

启动 TUI 仪表盘

直接运行 tokscale 就会进入交互式的 TUI 界面：

Bash
tokscale
alt text

TUI 提供 6 个视图：

  • Overview：日期维度的 Token 柱状图 + 模型费用排行
  • Models：按模型分列，显示 input/output/cache read/cache write 明细
  • Daily：按天查看消耗明细
  • Hourly：按小时查看
  • Stats：贡献热力图
  • Agents：按 AI 工具分列
alt text

常用快捷键：

code
1-6        切换视图
←/→/Tab    视图间切换
c/d/t      按费用/日期/Token 排序
s          打开数据源选择器
g          切换分组策略
p          切换颜色主题
r          刷新数据
e          导出为 JSON
q          退出

如果不需要交互界面，可以用 --light 模式直接输出表格：

Bash
tokscale --light
tokscale models --light
alt text

按工具过滤

如果只想看某个工具的消耗，用 --client 参数：

Bash
# 只看 Hermes 的用量
tokscale --client hermes

# 只看 Claude Code 和 ChatGPT
tokscale --client claude,codex

# 按周查看
tokscale --week

# 指定日期范围
tokscale --since 2026-06-01 --until 2026-06-10

查看模型费用

Bash
# 查看各模型的费用排行
tokscale models

# 导出为 JSON
tokscale models --json > report.json

查价格

Tokscale 内置了 LiteLLM 和 OpenRouter 的价格数据，可以直接查某个模型的价格：

Bash
tokscale pricing "claude-sonnet-4-20250514"
tokscale pricing "gpt-5.5"

提交到排行榜

Tokscale 有一个全球排行榜，可以把你的用量数据提交上去，生成个人年度报告：

Bash
# 提交数据
tokscale submit

# 预览会提交什么（不会真的提交）
tokscale submit --dry-run

# 按条件提交
tokscale submit --client hermes,claude --since 2026-01-01
💡需要登录

直接运行 tokscale submit 会提示 Not logged in。需要先执行 bunx tokscale@latest login 完成登录，或者设置 TOKSCALE_API_TOKEN 环境变量。登录后才能上传数据到排行榜。只是想本地看看用量的话不需要这一步。

bunx 是 Bun 的运行命令。如果还没装 Bun，可以先用 npm install -g bun 安装，然后就能用 bunx 了。 我对这些不是太感兴趣，就没有往下走了；有兴趣的同学可以去尝试下。

提交后可以在 tokscale.ai 上查看你的个人档案。

6.5 ■ 学点英语

中文 English 音标 说明
用量指标 Usage Metric /ˈjuːsɪdʒ ˈmetrɪk/ 衡量 token、请求量或成本消耗的数据
成本估算 Cost Estimation /kɔːst ˌestɪˈmeɪʃən/ 根据用量和单价预估费用的过程
数据源发现 Data Source Discovery /ˈdeɪtə sɔːrs dɪˈskʌvəri/ 自动找到可分析数据所在位置的过程
热力图 Heatmap /ˈhiːtmæp/ 用颜色深浅表示数值高低的可视化图