TokenTracker：AI 用量成本追踪器

项目简介

TokenTracker 是一个本地优先（local-first）的 AI Token 用量与成本追踪工具，覆盖 Claude Code、Codex、Cursor、Gemini CLI 等 47 款 AI 编程工具。日志全部在本机解析，不需要云账号或 API Key；它只统计 token 数、时间戳和模型名，prompt、补全内容和代码都不会离开你的机器。项目同时提供本地仪表盘、原生桌面应用和命令行工具。

主要功能

• 开箱支持 47 款工具：Claude Code、Codex CLI、Cursor、Gemini CLI、Antigravity、Kiro、OpenCode、GitHub Copilot、Cline、Zed Agent、Goose、Kilo Code、Roo Code、LM Studio、TRAE 等。
• 本地仪表盘：默认地址 http://localhost:7680，提供用量趋势、按模型拆分成本、GitHub 风格活动热力图和项目归因。
• 原生桌面端：macOS 菜单栏应用带小组件，Windows 系统托盘应用，Linux 托盘应用，各自内嵌服务器和 WebView 仪表盘。
• 桌面宠物与小组件：像素宠物会随真实编码活动变化；4 个桌面小组件分别展示用量、活动热力图、常用模型和用量限额。
• 成就系统：15 条成就线，把日常用量、连续天数、工具与模型多样性转成可收集的徽章。
• 实时用量限额：覆盖 Claude / Codex / Cursor / Gemini / Kimi / Kiro / Grok / Copilot / Antigravity / ZCode / Qoder 等配额窗口，并在本地应用暂时关闭时使用上次缓存。
• 服务状态页：汇总 8 家官方供应商状态页的运行与故障信息。
• 成本引擎：2200+ 模型价格来自 LiteLLM 并每日自动刷新，配合 24 小时磁盘缓存与内置离线快照，断网也能算出美元成本。
• 可选功能：全球排行榜、跨设备账号视图（云端同步，默认关闭）、Skills 标签页（浏览 250+ 公共 skills 并同步到多个工具）。

安装与使用

要求 Node.js 20+。最快的方式是直接运行：

npx tokentracker-cli

首次运行会安装 hooks、同步数据并打开本地仪表盘。也可以全局安装后使用更短的命令：

npm i -g tokentracker-cli
tokentracker status
tokentracker doctor

macOS 用户可用 Homebrew 安装菜单栏应用：

brew install --cask xiufengsun/tokentracker/tokentracker

桌面安装包（macOS TokenTrackerBar.dmg、Windows TokenTracker-Setup.exe、Linux TokenTracker-linux-x86_64.AppImage，另有 .deb / .rpm）可在 releases 页面 获取。macOS 下载 DMG 后拖入 Applications；Windows 运行免管理员的用户级安装器；Linux 对 AppImage 执行 chmod +x 后直接运行。

注意事项

• 隐私设计：只读取本地用量指标，不读取 prompt、补全结果和代码。
• 读取 Cursor 数据时优先调用系统 sqlite3，不可用时回退到 node:sqlite。
• Linux 的 AppImage 自带 GTK/WebKit，体积约 120MB；.deb / .rpm 依赖发行版库，体积约 55MB。Debian 12 因缺少 libappindicator3-1 无法安装 .deb，请改用 AppImage。
• GNOME 下托盘图标需要安装 AppIndicator 扩展。
• 厂商未公开价格的模型（例如腾讯 hy3-preview）只统计 token，成本显示为 $0，直到厂商公布价格。

本作品整理自 GitHub 开源项目 xiufengsun/TokenTracker，原作者 @xiufengsun，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。