Tokscale — 跨AI编码代理的令牌用量追踪器
在终端中追踪多个AI编码代理的令牌消耗与成本，支持全球排行榜和可视化仪表盘。
证据显示：CLI 工具读取多个本地数据源（如 ~/.claude/projects、~/.codex/sessions 等），并可能上传数据到远程排行榜（submit 命令）。有用户确认机制（如 submit 命令需显式执行），但未发现权限最小化设计（如按需读取、沙箱）。数据流透明度：README 明确列出数据源和上传命令，但未详细说明数据上传后的处理。敏感数据处理：涉及 API 密钥（如 Cursor 登录）和本地数据，但未说明加密存储。依赖安全：使用多个依赖，但未提供安全审计或漏洞扫描证据。外部影响：可能上传数据到远程服务器，但未说明数据删除或撤回机制。回滚：未提供数据回滚或撤销上传的功能。来源归属：作者信息明确，但发布者未验证。
证据显示：项目结构清晰，README 与代码一致，但未提供测试结果或 CI 状态。依赖可用性：依赖列表完整，但未验证所有依赖的可用性。失败消息：未提供错误处理或用户提示的示例。
证据显示：目标用户为 AI 开发者，场景明确（跟踪 token 使用）。能力边界：支持多种平台，但未明确不支持的功能。触发精度：命令和选项定义清晰，但未提供自动化触发机制。环境适配：支持多平台（Linux、macOS、Windows），但未提供容器化或虚拟化支持。
证据显示：信息架构清晰，README 有目录和详细说明。安装说明：提供多种安装方式（npx、bunx、deno）。命名稳定性：版本号明确，但未提供命名规范。示例和 FAQ：提供大量示例，但未提供 FAQ。已知限制：未明确列出。许可证：MIT 许可证明确。版本变更日志：未提供 CHANGELOG。维护责任：作者明确，但未提供维护计划。
证据显示：输出可用性：提供 TUI 和 JSON 输出，便于使用。边际价值：提供 token 跟踪和排行榜，有独特价值。成本效益：免费开源，但需自行部署。
证据显示：声明可追溯：README 中的功能描述与代码一致，但未提供测试证据。跨来源验证：未提供第三方验证。事实与推断分离：未明确区分事实和推断。
- 该工具会读取本地敏感数据（如 API 密钥、会话记录），并可能上传到远程服务器，请谨慎使用。
- 发布者身份未验证，请确认来源可信。
- 未提供数据删除或撤回机制，上传后可能无法撤销。
这个 Agent 能做什么，适合哪些场景？
Tokscale 是一款高性能 CLI 工具和可视化仪表盘，用于追踪多个 AI 编码代理的令牌使用量和成本。它支持超过 40 种代理，包括 OpenCode、Claude Code、Codex CLI、Cursor IDE、Gemini CLI 等，通过读取本地会话文件或数据库来获取数据，并利用 LiteLLM 的定价数据进行实时成本计算。该工具提供交互式 TUI 和轻量表格模式，能够按平台、日期范围或年份过滤数据，并生成 JSON 导出、图表和任务归属报告。此外，它还提供社交平台功能，允许用户提交使用数据到全球排行榜，并通过 web 前端展示 3D 贡献图，以及一个“Wrapped 2025”功能来回顾年度使用情况。Tokscale 基于 MIT 许可证开源，核心解析和聚合逻辑以 Rust 原生模块实现，提供约 10 倍的处理速度提升。
Tokscale 从本地存储的会话数据中读取令牌使用记录，支持通过 CLI 命令或 TUI 交互界面展示这些数据。它整合了来自多个 AI 编码代理（如 Claude Code、OpenCode、Codex、Gemini CLI 等）的本地日志和数据库，解析输入/输出/缓存/推理令牌计数，并使用 LiteLLM 的定价数据计算成本，支持层级定价和缓存折扣。用户可以通过 tokscale 命令启动 TUI 或使用 --light 模式获取表格输出，也可以使用 --json 导出数据，或者使用 graph 命令生成贡献图数据。此外，它提供了 pricing 命令用于查询实时模型价格，login、submit 和 autosubmit 命令用于将数据提交到公共排行榜。它还可以生成任务归属报告（通过 LLM 摘要）和订阅使用情况报告，以及针对特定工具（如 Cursor、Antigravity、Trae、Warp）的同步命令。
- 个人开发者希望监控自己在 Claude Code 和 OpenCode 中的令牌消耗，以优化使用成本。
- 团队领导者需要比较不同编码代理之间的成本，并查看全体成员的使用统计。
- 开发人员希望将使用数据提交到全球排行榜，与全球开发者竞争排名并创建公开个人资料。
- 用户需要生成任务归属报告，将令牌消耗归因到具体项目或任务，以进行项目成本分析。
- 开发者想要一个轻量级的终端仪表盘，无需打开浏览器即可快速查看当前使用情况。
- 研究人员希望导出 JSON 格式的详细使用数据，用于进一步分析和可视化。
这个 Agent 有哪些优点和局限？
- 支持超过 40 种 AI 编码代理，涵盖主流工具。
- 即时价格计算使用 LiteLLM 数据，支持层级定价和缓存折扣。
- 原生 Rust 核心提供约 10 倍的处理速度提升。
- 提供交互式 TUI、轻量表格和 JSON 导出等多种使用方式。
- 包含社交排行榜功能，可提交数据并查看公开个人资料，激励参与。
- 需要从每个代理的本地文件系统读取数据，可能存在隐私和权限问题。
- 许多功能（如 Cursor、Trae、Warp 集成）需要登录和同步，可能涉及额外的配置和网络请求。
- 部分功能（如任务归属报告）依赖外部 LLM（如 Apple FM、Claude、Codex）作为摘要后端，需要额外安装和认证。
- 某些代理（如 Trae CN）不支持，因为缺少官方 API。
- 高级功能如订阅使用情况可能仅支持特定提供商，且数据为提供商报告，可能不准确。
如何安装或部署这个 Agent？
快速安装：使用 npx tokscale@latest 或 bunx tokscale@latest 直接运行，无需额外安装。也可以通过 deno x npm:tokscale@latest 使用 Deno 运行。需要 Node.js 或 Bun。若要源码安装，克隆仓库并运行 bun install 和 bun run build:core（需要 Rust 工具链）。
如何使用这个 Agent？
基本命令：在终端运行 tokscale 启动交互式 TUI，或使用 tokscale --light 查看表格输出。使用 tokscale models 查看模型视图，tokscale monthly 查看每日视图，tokscale --json 导出 JSON 数据。使用 tokscale --client opencode 按客户端过滤，使用 --since 和 --until 设置日期范围。使用 tokscale pricing "model-name" 查询价格，使用 tokscale login 登录并 tokscale submit 提交数据到排行榜。