tokscale

终端里统一看 AI 编程 token 消耗，参与全球排行。

tokscale 是一个开源的终端工具，用于追踪 AI 编程代理的 token 使用情况。它解决了开发者在多个 AI 工具（如 Claude Code、Cursor、Codex 等）之间分散的 token 消耗难以统一统计的问题。通过简单的命令行界面，用户可以实时查看各工具的 token 用量、成本估算，并参与全球排行榜，目前已有数万亿 token 被追踪。核心能力包括：跨工具聚合统计、终端内可视化展示、全局排名对比。项目采用 Rust 编写，性能高效，安装便捷。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 5509

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队junhoyeo

所属国家

官网地址https://tokscale.ai

GitHubhttps://github.com/junhoyeo/tokscale

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Rust

技术栈/模型ai,ai-agents,ampcode,claude,claude-code,clawdbot,codex,cursor,cursor-ide,droid,gemini,gemini-cli,gpt,hermes,moltbot,oh,openclaw,opencode,opentui,token-usage

GitHub 星标★ 5509

30天Star增速

HF 下载量

上线时间2025-12-01 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 10 分钟部署方式：命令行工具 8 步

环境要求

已安装 Node.js（使用 npx 运行）
或已安装 Deno（使用 deno x 运行）
源码开发模式需安装 Bun
源码构建原生核心需在仓库根目录操作

安装与启动步骤

1直接运行 CLI

无需安装，npx 直接拉取最新版并启动终端界面，查看各 AI 工具的 token 用量与成本。
```
npx tokscale@latest
```
2用 Deno 运行

不想使用 npx 时可改用 Deno 直接执行，同样无需安装别名。
```
deno x npm:tokscale@latest
```
3安装 Bun

只有本地开发或从源码构建才需要，已有 Bun 可跳过。
```
curl -fsSL https://bun.sh/install | bash
```
4安装依赖

在仓库根目录执行，安装项目所需依赖。
```
bun install
```
5开发模式运行

以开发模式启动 CLI，仅用于本地开发；正式使用请走 bunx tokscale。
```
bun run cli
```
6构建原生核心

在仓库根目录构建原生核心；通过 bunx 安装时二进制已预编译，无需此步。
```
bun run build:core
```
7查看单个工具用量

只看指定客户端的用量，示例为 opencode；换其他客户端名即可查看对应数据。
```
tokscale --client opencode
```
8预览并提交排行榜

先 dry run 预览将提交的内容，确认无未定价告警后再执行 tokscale submit。
```
tokscale submit --dry-run
```

关键配置

配置项	必填	说明	示例
`colorPalette`	否	TUI 配色主题	`blue`
`includeUnusedModels`	否	是否包含未使用的模型	`false`
`defaultClients`	否	默认统计的客户端列表	`["opencode", "claude"]`
`usage.disabledProviders`	否	在用量统计中禁用的提供商	`["copilot"]`
`scanner.extraScanPaths`	否	额外扫描路径，按客户端分组	`{"codex": ["/Users/me/workspace/project-a/.codex/sessions"]}`

如何确认成功

执行 npx tokscale@latest 或 tokscale 后，终端能正常展示各 AI 工具的 token 用量与成本统计即表示可用。

常见问题

Q：Cursor 用量显示为空怎么办？

A：Cursor IDE 使用 Tokscale 的 API 缓存，需先完成登录并执行 tokscale cursor sync --json 同步缓存后再查询。

Q：哪些用量不会被提交到排行榜？

A：无法权威定价的消息会被跳过，并提示 Warning: excluded N unpriced provider/model message(s)，其余已定价用量正常提交。

Q：如何知道某个模型匹配了哪条定价？

A：执行 tokscale pricing 可查看命中的定价条目；未匹配时可在 custom-pricing.json 中按模型 ID 添加精确条目。

Q：开发模式和正式安装有什么区别？

A：bun run cli 仅用于本地开发；通过 bunx tokscale 安装时命令直接运行，且原生二进制已预编译，无需再 build:core。

注意事项

配置文件位于 ~/.config/tokscale/settings.json
Warp 来源的用量默认不进入 submit 数据，因为排行榜接受的是 token 归因用量而非聚合请求计数
custom-pricing.json 以模型 ID 为键，显式写 0 表示该模型确实免费
退出登录时缓存用量会被移动到 cursor-cache/archive/，加 --purge-cache 才会真正删除

核心亮点

支持多种主流 AI 编程工具（Claude Code、Cursor、Codex 等）的 token 统一追踪
终端内实时显示，无需离开工作环境即可监控用量
全球排行榜功能，提供社区对比和趣味性

不足之处

目前仅支持部分 AI 编程代理，覆盖范围有限
文档/社区待观察

适用场景

个人开发者监控多工具 token 成本
团队统一核算 AI 编程工具开销
AI 工具重度用户进行用量对比和优化

替代项目

token-watch、ai-cost-tracker、OpenCost

项目介绍

tokscale 是基础设施领域的开源项目，由 junhoyeo 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（5,509）位列前 8%，在基础设施分类的 1,132 个项目里位列前 12%。

近 41 天，它的 GitHub 星标从 4,926 增加到 5,509，净增 583。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。从国内网络环境看，可直接访问。

它主要面向的使用场景是：个人开发者监控多工具token成本。同类可对比的替代方案包括 token-watch、ai-cost-tracker、OpenCost。

上一篇：agent-trace

下一篇：e2a