Repolode
junhoyeo

junhoyeo/tokscale

一款基于 Rust 的命令行与终端界面工具,统计多种 AI 编程助手的 token 用量和费用。

Star
5,720
Fork
465
未关闭 Issue
88
最近提交
13小时前

这是什么?

Tokscale 读取 Claude Code、Codex CLI、Gemini CLI、Cursor、OpenCode 等 AI 编程助手在本地写入的会话数据,按天、周、月以及模型、客户端、项目、会话等维度汇总 token 数量和估算费用。结果可以在带多个标签页的交互式终端界面中查看,也可以输出为普通表格或 JSON,便于脚本和其他工具调用。

费用基于 LiteLLM 的价格数据计算,OpenRouter 作为备用来源,并支持分层计价和缓存 token 折扣。对于上游价格库尚未覆盖的模型,用户可以自定义价格。解析与汇总由 Rust 原生核心完成。

项目还提供带贡献图风格的 Web 可视化界面,以及可将用量提交到排行榜、生成公开主页的社交功能。

核心功能

  • 01交互式终端界面,包含总览、模型、按日、按小时、会话、项目和代理等视图
  • 02支持追踪 Claude Code、Codex CLI、Gemini CLI、Cursor、OpenCode 等数十种编程助手的用量
  • 03按输入、输出、缓存读写和推理 token 分项统计
  • 04基于 LiteLLM 价格数据估算费用,支持 OpenRouter 备用与自定义价格
  • 05可按客户端、日期范围或年份筛选,并导出 JSON

适用场景

  • 按月查看在多个 AI 编程助手上的实际花费
  • 将 AI 编程成本归因到具体项目或工作区
  • 通过 JSON 输出把用量数据接入脚本或仪表盘
  • 对比不同模型和客户端的 token 消耗,找出主要开销来源

快速上手

  1. 1

    使用 bunx 将用量数据提交到排行榜

    bunx tokscale@latest submit

使用前须知

  • 部分客户端没有本地用量数据,因此 Freebuff 的 token 用量是根据对话记录估算的。
  • Cursor 的用量需要桌面端自动登录或粘贴 cookie,并从缓存的 API 数据中读取。

标签

常见问题

tokscale 是什么?
一款基于 Rust 的命令行与终端界面工具,统计多种 AI 编程助手的 token 用量和费用。 Tokscale 读取 Claude Code、Codex CLI、Gemini CLI、Cursor、OpenCode 等 AI 编程助手在本地写入的会话数据,按天、周、月以及模型、客户端、项目、会话等维度汇总 token 数量和估算费用。结果可以在带多个标签页的交互式终端界面中查看,也可以输出为普通表格或 JSON,便于脚本和其他工具调用。
tokscale 可以免费使用吗?用的什么许可证?
tokscale 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
tokscale 还在维护吗?
活跃维护中。tokscale 最近一次提交是在 2026年10月22日。
tokscale 适合用来做什么?
按月查看在多个 AI 编程助手上的实际花费 将 AI 编程成本归因到具体项目或工作区 通过 JSON 输出把用量数据接入脚本或仪表盘 对比不同模型和客户端的 token 消耗,找出主要开销来源
tokscale 怎么安装和运行?
使用 bunx 将用量数据提交到排行榜: bunx tokscale@latest submit
在哪里获取 tokscale?
源代码和安装说明在 GitHub 上:https://github.com/junhoyeo/tokscale

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目