Tokscale：跨多平台追踪 AI 令牌使用 – CLI 工具

在 AI 辅助编程无处不在的时代，令牌 已成为生产力的新货币。每次你向 Claude、Gemini、Codex 或任何其他基于 LLM 的助手发送提示，都会消耗字符，而这些字符的使用会产生真实费用。未跟踪使用情况的开发者很快会发现自己正盯着意想不到的账单。

推出 Tokscale——一款轻量级、开源的命令行工具，可自动汇总来自众多工具的令牌使用数据：OpenCode、Claude Code、Codex CLI、Gemini CLI、Cursor IDE、AmpCode、Factory Droid 和 OpenClaw。只需一条命令，Tokscale 即可从本地会话文件夹拉取数据，查询 LiteLLM 的定价数据库，并输出整洁的报告和精美的可视化。

✅ 为什么选择 Tokscale？

• GitHub 上已有 20+ 关注者
• 508 ⭐
• 超过 7 天的实时定价来自 LiteLLM
• 交互式终端 UI（OpenTUI）
• 排行榜与社交平台
• 原生 Rust 核心（解析速度提升 10 倍）
• 可导出 JSON 以供仪表盘使用

入门指南

Tokscale 是通过 Bun 分发的——一个带有内置包管理器、速度超快的 JavaScript/TypeScript 运行时。如果你还未使用 Bun，只需快速安装：

curl -fsSL https://bun.sh/install | bash

1. 安装 Tokscale

bunx tokscale@latest

⚡ 小贴士：bunx 可以直接运行包而不将其添加到项目中——非常适合一次性使用。

2. 运行交互式 TUI

tokscale

启动后，你将看到一个醒目的仪表盘，包含：

• 概览：总令牌数、费用明细以及热门模型的快速预览。
• 模型：每个模型的费用和令牌计数。
• 每日：逐日细分。
• 统计：类似 GitHub 的贡献图。

可使用键盘（1–4 跳转标签页，方向键导航）或鼠标（可点击标签）。若想获得轻量化、非交互版本，添加 --light 标志：

tokscale --light

3. 筛选与日期范围

Tokscale 能让你按需切片数据：

# 显示上周 Claude Code 的使用情况
Tokscale --claude --week

# 限定自定义日期范围
Tokscale --since 2024-01-01 --until 2024-12-31

# 与费用输出结合
Tokscale models --month --github --json > monthly.json

CLI 为每个数据源提供短标志（--opencode、--codex、--cursor 等），让你轻松比较单个平台或多平台混合使用。

4. 实时定价查询

Tokscale pricing "claude-3-5-sonnet"

Tokscale 以 Litellm 为主要定价来源，并在遇到新或小众模型时回退至 OpenRouter。输出显示 输入、输出 与 缓存 的美元定价。

5——社交功能：排行榜与个人资料

Tokscale 不仅是本地统计工具，它还提供基于 Web 的平台，支持：

• 登录（通过 GitHub OAuth）
• 提交 汇总数据到全球排行榜
• 浏览 其他开发者的个人资料，比较令牌使用，并查看趋势
• 查看 自定义的“Wrapped”年度回顾图像

Tokscale login          # 打开浏览器进行 GitHub 授权
Tokscale submit          # 将数据推送到排行榜
Tokscale wrapped         # 生成类似 Spotify 的图片

进入平台后，你还可以归档旧数据或细化要提交的数据点。

与 CI/CD 的集成

Tokscale 的无头模式可捕获输出 JSON 的工具的令牌使用——非常适合持续集成管道。例如：

- name: Run AI check
  run: |
    mkdir -p ~/.config/tokscale/headless/codex
    codex exec --json "review code changes" > ~/.config/tokscale/headless/codex/pr-123.jsonl
- name: Collect usage
  run: tokscale --json > report.json

此 JSON 文件可直接导入指标仪表盘或 CI 徽章。

贡献指南

Tokscale 欢迎贡献——无论你想添加新 AI 工具支持、改进 Rust 核心还是调整 UI。仓库遵循标准的 GitHub 工作流：

1. Fork 仓库。
2. 创建功能分支。
3. 运行测试（bun run test:all）。
4. 提交拉取请求。

社区欢迎错误报告和功能请求——只需提交 issue 即可。

TL;DR

• 什么？CLI 用以跟踪多种 LLM 助手的令牌使用。
• 为什么？令牌 = 费用；实时查看成本流向。
• 如何？使用 Bun 安装，运行 tokscale，过滤或导出。
• 超越 CLI —— 排行榜、图表、CI 集成。
• 开源 —— MIT 许可证，活跃社区。

最后想法

Tokscale 不仅是一个指标工具；它让你在编程时保持对 AI 成本的敏感，帮助你跨服务 benchmark 生产力。凭借原生 Rust 后端和交互式 TUI，它如同终端版的生产力 IDE 扩展。如果你正踏上 AI 前沿，尝试 Tokscale 并在排行榜上分享你的使用情况吧。