你有没有过这种感觉——
用 AI 编程助手写了几个月代码，某天突然想知道：这段时间到底烧了多少 Token？钱花得值不值？哪个模型用得最多？
没有。
大多数 AI 编程工具都不会主动告诉你这些。Cursor 不显示账单，Claude Code 没有消费面板，OpenCode 的数据藏在 SQLite 里，你自己不查就永远不知道。
Tokscale 就是来解决这个问题的。
Tokscale 是什么
Tokscale 是一个 CLI 工具，专门用来追踪 AI 编程助手的 Token 消耗和成本。它支持 18 个平台，包括 OpenCode、Claude Code、Codex CLI、Cursor IDE、Hermes Agent 等等。
核心功能：
- 交互式 TUI
：终端里直接看图表，不需要打开浏览器 - 实时定价
：接入 LiteLLM 价格数据，输入、输出、缓存、推理 Token 分开算 - 按平台筛选
：只看 OpenCode，或者和 Claude Code 对比 - Wrapped 年度回顾
：生成一张类似 Spotify Wrapped 的年度使用报告
安装
三种安装方式：
# 方式一：npx 直接运行
npx tokscale@latest
# 方式二：bunx
bunx tokscale@latest
# 方式三：全局安装（需要持久化在 PATH 里）
npm install -g tokscale
不需要配置，零设置启动。首次运行会自动扫描常见数据目录。
数据在哪
Tokscale 读取各平台本地存储的数据文件来分析使用量。OpenCode 的数据在：
~/.local/share/opencode/opencode.db
v1.2+ 版本使用 SQLite 数据库，比旧版的 JSON 文件读取更快。Tokscale 会自动扫描所有渠道的数据库（opencode.db、opencode-stable.db、opencode-nightly.db），无论你用的是哪个版本都能兼容。
怎么用
基本命令：
# 启动交互式 TUI（默认）tokscale# 使用特定标签启动 TUItokscale models # 模型标签tokscale monthly # 每日视图（显示每日分解）# 使用传统 CLI 表格输出tokscale --lighttokscale models --light# 明确启动 TUItokscale tui# 导出贡献图数据为 JSONtokscale graph --output data.json# 以 JSON 输出数据（用于脚本/自动化）tokscale --json # 默认模型视图为 JSONtokscale models --json # 模型分解为 JSONtokscale monthly --json # 月度分解为 JSONtokscale models --json > report.json # 保存到文件
查价格
想知道某个模型现在多少钱：
tokscale pricing "claude-sonnet-4-5"Tokscale 会查询 LiteLLM 价格数据库，返回当前的单价信息。
Wrapped 2025
年底想发朋友圈炫耀（或者自我反省）？Wrapped 功能生成一张年度使用报告图：
tokscale wrapped
报告包含：总 Token 数、Top 3 模型、Top 3 客户端、活跃天数、成本、连续活跃记录。
TUI 里的键盘操作
进入 TUI 后用数字键或方向键切换视图：
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
9 种颜色主题可选，从 Green 到 YlGnBu，总有一款你喜欢。
社交平台功能
Tokscale 支持提交数据到公开排行榜：
tokscale login # GitHub 认证
tokscale submit # 提交使用数据
tokscale whoami # 查看当前账户
提交后可以在 https://tokscale.ai 查看你的公开资料和排名。
也可以生成 GitHub README 嵌入小部件：
[](https://tokscale.ai/u/<username>)
几个注意点
会话清理周期：Claude Code 默认 30 天清理一次旧会话。如果你想保留完整历史记录，需要手动修改 ~/.claude/settings.json，把 cleanupPeriodDays 设成一个很大的数字，比如 9999999999。
Cursor 需要单独登录：Cursor IDE 的数据不走本地文件，是通过 API 同步的。第一次用需要运行 tokscale cursor login 从浏览器获取会话令牌。
价格数据有缓存：Tokscale 把价格数据缓存在 ~/.cache/tokscale/ 目录，TTL 1 小时。如果发现价格没更新，删掉缓存文件重新查。
写在最后
AI 编程助手用多了，Token 消耗是个黑箱。OpenCode + Tokscale 帮你把这个黑箱打开，看清楚钱花在了哪里、哪个模型值得继续用、哪个客户端可以换掉。
如果你同时用多个 AI 编程工具，Tokscale 的聚合视图特别有用。一个命令把所有平台的数据拉出来对比，比每个工具各自查一遍高效得多。
你在用哪个 AI 编程助手？有没有算过一个月烧多少 Token？评论区聊聊。
