tokscale

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

开源 🏷️定价信息待确认 ✅ 目前可打开 智能体 🍴 复刻 478 🐛 待处理 83 👀 关注 33
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 5815
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

tokscale 项目界面预览图
图片来源:项目官网

项目数据

分类智能体
开发团队junhoyeo
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态✅ 目前可打开
是否开源是
开源协议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 星标★ 5815
上线时间2025-12-01 00:00:00
代码更新2026-11-06
仓库体积117.7 MB
本站数据更新2026-11-09
维护状态活跃
收录时间2026-08-09
浏览次数6

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5815

使用教程

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

环境要求

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

安装与启动步骤

  1. 1直接运行 CLI

    无需安装,npx 直接拉取最新版并启动终端界面,查看各 AI 工具的 token 用量与成本。

    npx tokscale@latest
  2. 2用 Deno 运行

    不想使用 npx 时可改用 Deno 直接执行,同样无需安装别名。

    deno x npm:tokscale@latest
  3. 3安装 Bun

    只有本地开发或从源码构建才需要,已有 Bun 可跳过。

    curl -fsSL https://bun.sh/install | bash
  4. 4安装依赖

    在仓库根目录执行,安装项目所需依赖。

    bun install
  5. 5开发模式运行

    以开发模式启动 CLI,仅用于本地开发;正式使用请走 bunx tokscale。

    bun run cli
  6. 6构建原生核心

    在仓库根目录构建原生核心;通过 bunx 安装时二进制已预编译,无需此步。

    bun run build:core
  7. 7查看单个工具用量

    只看指定客户端的用量,示例为 opencode;换其他客户端名即可查看对应数据。

    tokscale --client opencode
  8. 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 工···

★ 81 2026-08-09
aisbom 开源

给 AI 模型和数据集做“成分表”,让供应链透明可审计

Static security scanner for ML model files — detects pickle bombs, Keras Lambda RCE···

★ 83 2026-08-09
ai-on-openshift 开源

在OpenShift上快速部署AI工作负载,参考架构即拿即用。

AI-on-OpenShift website source code

★ 109 2026-08-09
nano-vllm-prefillonly 开源

砍掉解码只留 prefill,判别式大模型推理更快更省

A specialized optimization of nano-vllm for prefill-only inference tasks, designed f···

★ 120 2026-10-05
opencodex 开源

一个网关,让 Codex 和 Claude Code 用上任意大模型

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemi···

★ 18315 2026-08-09
local-studio 开源

一个面板管住本地所有大模型推理引擎

Control panel for VLLM, Sglang, llama.cpp, exllamav3

★ 1843 2026-10-14
casadi 开源

写符号表达式,自动求导并生成优化代码

CasADi is a symbolic framework for numeric optimization implementing automatic diffe···

★ 2332 2026-10-04
matrixone 开源

一个库搞定事务、分析、向量与数据版本

AI-native HTAP database with Git-for-Data and built-in vector search, serving as the···

★ 2063 2026-10-24
NeumAI 开源

一键搭建大规模向量数据管道,让 RAG 应用数据实时同步

Neum AI is a best-in-class framework to manage the creation and synchronization of v···

★ 868 2026-08-09