项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5815
技术标签
使用教程
环境要求
- 已安装 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 <model-id> 可查看命中的定价条目;未匹配时可在 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
上一篇:agent-trace
下一篇:e2a
同类项目推荐
Your-First-LLM-Studio
开源
在 Mac 上本地跑、比、测多个大模型,一站式搞定
First LLM Studio: local-first LLM workbench for Apple Silicon + MLX. 本地优先 LLM 工···
aisbom
开源
给 AI 模型和数据集做“成分表”,让供应链透明可审计
Static security scanner for ML model files — detects pickle bombs, Keras Lambda RCE···
ai-on-openshift
开源
在OpenShift上快速部署AI工作负载,参考架构即拿即用。
AI-on-OpenShift website source code
nano-vllm-prefillonly
开源
砍掉解码只留 prefill,判别式大模型推理更快更省
A specialized optimization of nano-vllm for prefill-only inference tasks, designed f···
opencodex
开源
一个网关,让 Codex 和 Claude Code 用上任意大模型
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemi···
local-studio
开源
一个面板管住本地所有大模型推理引擎
Control panel for VLLM, Sglang, llama.cpp, exllamav3
casadi
开源
写符号表达式,自动求导并生成优化代码
CasADi is a symbolic framework for numeric optimization implementing automatic diffe···
matrixone
开源
一个库搞定事务、分析、向量与数据版本
AI-native HTAP database with Git-for-Data and built-in vector search, serving as the···
NeumAI
开源
一键搭建大规模向量数据管道,让 RAG 应用数据实时同步
Neum AI is a best-in-class framework to manage the creation and synchronization of v···
