Tokscale:1746⭐的 AI Coding Agent Token 追踪利器
如果你同时使用多个 AI 编程助手(OpenClaw、Claude Code、Codex 等),可能会有一个困扰:不知道每个月在这些工具上到底花了多少 Token。今天推荐的 Tokscale 是一个专门解决这个问题的高性能 CLI 工具。
项目概览
| 属性 | 内容 |
|---|---|
| GitHub | junhoyeo/tokscale |
| Stars | 1,746 |
| 语言 | Rust |
| 特点 | 多 Agent 支持、TUI 界面、Token 可视化 |
| 最后更新 | 活跃 |
它解决了什么问题
AI 编程助手越来越普及,但它们的计费方式往往是按 Token 计算。当你同时使用多个工具时:
- OpenClaw 处理日常任务
- Claude Code 写复杂逻辑
- Codex 做代码审查
- Gemini CLI 辅助搜索
这些分散的消耗很难汇总。Tokscale 自动扫描这些工具的数据库和日志文件,给你一个统一的 Token 使用视图。
支持的 AI 工具
| 工具 | 数据位置 | 支持状态 |
|---|---|---|
| OpenClaw | ~/.openclaw/agents/ | ✅ 支持 |
| Claude Code | ~/.claude/projects/ | ✅ 支持 |
| OpenCode | ~/.local/share/opencode/ | ✅ 支持 |
| Codex CLI | ~/.codex/sessions/ | ✅ 支持 |
| Gemini CLI | ~/.gemini/tmp/ | ✅ 支持 |
| Hermes Agent | ~/.hermes/state.db | ✅ 支持 |
核心功能
实时 TUI 仪表盘
Tokscale v2 用 Rust 重写了 TUI 界面,支持键盘导航。主界面显示:
- 今日/本周/本月的 Token 统计
- 各 AI 工具的用量占比
- 估算费用(基于当前模型价格)
自动发现数据源
不需要手动配置路径,Tokscale 会自动检测常见 AI 工具的数据存储位置。支持 legacy 路径和新版路径的迁移检测。
可视化排行榜
运行 bunx tokscale@latest submit 可以将数据提交到 tokscale.ai,生成个人 Wrapped 2025 报告,还能查看全球用户的 Token 用量排行。
3D Contributions Graph
前端可视化页面提供类似 GitHub contributions 的 3D 热力图,直观展示你的 AI 使用习惯。
快速开始
# 通过 npm 安装
npm install -g tokscale
# 或使用 bun
bun install -g tokscale
# 启动 TUI
tokscale
如果你是 Rust 用户:
cargo install tokscale
使用场景
费用控制
当使用 Claude Code 处理大项目时,Token 消耗可能失控。Tokscale 的实时统计能帮你及时发现异常用量。
效率分析
通过 Wrapped 报告,可以回顾自己的 AI 使用模式:
- 哪个 Agent 用得最多?
- 什么时间段效率最高?
- Token 都花在哪些类型的任务上?
团队协作
在团队环境中,可以用 Tokscale 统计项目整体的 AI 辅助成本,为预算规划提供数据支持。
技术亮点
- Rust 实现:高性能、低内存占用
- 跨平台:支持 macOS、Linux、Windows
- 零配置:自动检测数据源,开箱即用
- 本地优先:所有数据处理在本地完成,保护隐私
注意事项
- 需要 Node.js 18+ 或 Bun 运行时
- 部分功能(如 leaderboard)需要提交数据到云端
- 费用估算基于公开价格,实际账单可能因套餐不同而有差异
结语
Tokscale 填补了 AI 编程助手生态的一个空白:用量可视化。在 AI 工具越来越普及的今天,了解自己在这些工具上的投入产出比变得重要。1,746 星的 Tokscale 虽然还不算大众工具,但对于重度 AI 用户来说是个实用的监控利器。
项目信息
| 属性 | 内容 |
|---|---|
| 仓库 | https://github.com/junhoyeo/tokscale |
| 官网 | https://tokscale.ai |
| 许可证 | MIT |
| 语言 | Rust + TypeScript |
| 维护者 | @junhoyeo |