Javis603/token-monitor
Local-first desktop widget for tracking token usage, costs, and limits across 36+ AI coding tools—including Claude Code, Codex, Cursor, OpenCode, and OpenClaw—with multi-device sync.
Token Monitor – 是什么
Token Monitor 是一个跨平台桌面小部件，可监控数十种 AI 驱动的编码助手（Claude Code、GitHub Copilot、Cursor 等）的令牌消耗和配额限制。它读取每个工具的本地日志或 API 密钥余额，聚合数据，并在可自定义的仪表板中显示实时数据。该应用可跨多台设备同步这些摘要，确保您始终看到统一、实时的 AI 使用情况。
核心功能（如 README 所述）
| 功能 | 工作方式 | 你看到的内容 |
|---|---|---|
| 实时令牌追踪 | 读取 35+ 支持工具的本地转录文件、SQLite 数据库或 API 密钥余额端点。 | 每次 AI 交互后数秒内更新令牌数量。 |
| 会话级分解 | 打开特定会话（例如 Claude Code 转录）并解析提示/响应的令牌拆分。 | 输入与输出令牌的详细视图、缓存命中与未命中、以及所用模型。 |
| 成本显示 | 使用内置价格表（或手动输入的订阅信息）将令牌转换为 USD、TWD、HKD 或 CNY。 | 令牌数与货币成本并列显示；汇率每日刷新。 |
| 配额/限制监控 | 从本地导出文件或 API 密钥端点（OpenRouter、Minimax 等）查询特定提供商的限制（每日、每周、计费周期）。 | 可视化配额条、满载百分比指示器，以及接近限制时的警报。 |
| 历史趋势与热力图 | 本地存储每日聚合数据（可选：在源文件删除后归档使用记录）。 | 一年热力图、连续使用计数器、按工具或模型的堆叠条形图/K线图。 |
| 多设备同步 | 将设备使用情况的紧凑摘要发送到一个中心（内置在应用内、自托管 Node、或 Cloudflare Worker）。其他设备通过 Server-Sent Events 接收更新。 | 所有设备显示相同实时数据；iOS 小部件也可从同一中心获取。 |
| 导出 | 按需或按计划将令牌使用情况写入 CSV/JSON。 | 可轻松导入电子表格、Grafana、Obsidian 或自定义脚本。 |
| 自定义 UI | 菜单栏（macOS）/系统托盘（Windows）弹出窗口、浮动气泡、macOS 原生小部件预览、主题与透明度控制、拖拽布局编辑器。 | 选择适合您工作流的外观；可添加快捷键、Discord Rich Presence 等。 |
支持的工具（节选）
- Claude Code, Codex, OpenCode, Hermes Agent, OpenClaw, Cursor, Antigravity, Kimi, Qwen, Grok Build, GitHub Copilot, Pi, Zed, Kilo, Command Code, MiMo Code, ZCode, Kiro, CodeBuddy, WorkBuddy, Proma, Qoder CN, Reasonix, DeepSeek, Cherry Studio, LM Studio, Unsloth, OpenRouter, Minimax, Volcengine, Ollama, Trae CN, Alibaba Cloud，以及任何遵循 New API 余额格式的第三方 API。
安装与首次运行
- macOS –
brew install --cask token-monitor（Apple Silicon 或 Intel dmg）。 - Windows – 下载签名的
.exe（安装程序或便携版）。 - Linux – 获取
AppImage（x64）。 - 启动应用；它将自动检测该机器上的支持工具，并以“仅本地”模式开始追踪使用情况。
多设备同步选项
- 在应用内托管中心 – 选择一台始终开机的机器，将生成的局域网 URL + 密钥复制到其他设备。
- 自托管 Node 中心 – 在无头服务器上设置
TOKEN_MONITOR_SECRET后运行npm run hub。 - Cloudflare Worker 中心 – 一键部署按钮；将工作器 URL 和密钥粘贴到每个客户端。 三种方式均使用 Server-Sent Events，因此所有连接的窗口将在数秒内收到更新。
哪些人可能需要它？
- 使用多种 AI 编码助手的开发者，需要追踪令牌支出和配额耗尽情况。
- 共享 AI 服务预算的团队，希望获得透明、以隐私为先的使用情况视图。
- 自由职业者或爱好者，希望在看到令牌数的同时实时查看成本，避免意外账单。
- 在多台电脑上工作的人（桌面、笔记本、WSL、iPhone），希望使用单一仪表板而非每台机器的独立监控。
隐私说明
所有提示/响应内容均保留在本地设备；仅聚合的令牌数量、成本和限制数据会发送到同步中心。中心可自托管、在应用内运行，或部署到 Cloudflare，让您完全控制数据的去向。
快速入门检查清单
- 为您的操作系统安装应用。
- 打开 Token Monitor – 它将自动检测支持的工具并开始显示实时使用情况。
- （可选）如果您有多个设备，请设置同步中心。
- 根据您的工作流自定义仪表板布局、货币和导出设置。
- 享受所有 AI 编码工具中实时的令牌支出和配额健康状况可视化。
相关
- 项目
- 项目
- 项目
- 项目
- 项目