3分钟上手 Token Monitor:零配置追踪 Claude Code、Codex、Cursor 的 Token 用量与成本
【免费下载链接】token-monitorLocal-first desktop widget for tracking token usage, costs, and limits across 43+ AI coding tools—including Claude Code, Codex, Cursor, OpenCode, OpenClaw, and more—with multi-device sync.项目地址: https://gitcode.com/gh_mirrors/tok/token-monitor
Token Monitor 是一款本地优先的桌面 Token 用量监控工具,可以零配置追踪 Claude Code、Codex、Cursor 等 43+ 款 AI 编程工具的 Token 消耗、实时成本与账户额度,并支持多设备同步。它直接读取本机各工具留下的会话日志,无需任何账号授权,启动即出数,还能把用量、花费和额度余量同步到你的多台电脑甚至手机小组件上。
1分钟完成 Token Monitor 安装
Token Monitor 覆盖三大平台:macOS 12+、Windows 10+ 和 Linux x64(AppImage)。
- macOS:使用 Homebrew 一条命令安装:
brew install --cask token-monitor,也可以从 Releases 页下载签名且经过公证的.dmg; - Windows:下载安装版或绿色版
.exe,安装包已做代码签名(详见 docs/code-signing.md); - Linux:下载
AppImage,直接运行即可。
安装完成后直接启动应用,默认就是本地模式:不需要注册、不需要配置任何 Hub 或 API Key,它会自动开始追踪本机的 AI 工具用量。3 分钟内的第一步,到这里就完成了 ✅
零配置上手:启动后你会看到什么
启动后,Token Monitor 自动扫描~/.claude/、~/.codex/等默认目录中的会话日志,几秒内即可在界面上看到当天与当月的 Token 总量和费用。你可以随时在 DAY / MONTH / TOTAL 之间切换统计周期:
更细的颗粒度同样开箱即用:
- 逐会话明细:点开任意 session,能看到每条回复的输入/输出/缓存 Token 拆分,甚至这次对话调用了哪些工具;
- 缓存命中统计:点击任一工具或模型,展开输入 Token 的 cache hit / miss 比例;
- 成本与货币:费用默认以 USD 显示,可切换 TWD、HKD、CNY,汇率每天自动更新。
用量趋势、额度告警与仪表盘
除了"今天用了多少",Token Monitor 更能回答"我的额度还能撑多久":
- AI 工具额度检测:针对 Claude Code、Codex、Cursor、OpenRouter 等 28+ 供应商,显示 session、日、周、计费周期的剩余额度与重置时间;
- Codex 一键切换:跟踪多个 Codex 账号,并可一键把某个账号切换为本地活跃账号,无需重新登录;
- 年度仪表盘:热力图、连续活跃天数、按工具/模型堆叠的趋势柱状图与 K 线图,跨所有设备聚合。
43+ 款 AI 编程工具开箱即查
Token Monitor 原生支持的工具列表相当长,常见的主力选手包括:
| 工具 | Token 用量 | 额度检测 | 会话明细 |
|---|---|---|---|
| Claude Code | ✅ | ✅ | ✅ |
| Codex | ✅ | ✅ | ✅ |
| Cursor(IDE/CLI/Grok Bot) | ✅ | ✅ | — |
| OpenCode | ✅ | ✅ | ✅ |
| GitHub Copilot | ✅ | ✅ | — |
| OpenClaw / Hermes Agent | ✅ | — | — |
| DeepSeek、Kimi、Cline、Zed、Devin 等 30+ 款 | ✅ | 部分 | 部分 |
每款工具读取的数据路径、注意事项都写在 README.md 的支持工具表中,各供应商的数据来源说明可查阅 docs/providers/ 目录下的独立文档(如 docs/providers/claude.md、docs/providers/codex.md)。如果某个工具的会话文件放在非默认位置,可以在 设置 → Collection 里添加自定义扫描路径。
多设备同步:3 种简单模式任选
一台电脑的数据只反映一台电脑。如果你同时在办公本、工作站和手机上用 AI 工具,可以在 设置 → Multi-device Sync 中选一种同步后端:
- Widget 内置 Hub(最简单):在一台常开的机器上选择"Host hub on this device",其他设备填上局域网地址 + 密钥即可,无需命令行;
- Node Hub:在常开的服务器上执行
npm run hub,适合无界面的无头机器,Hub 服务端逻辑见 src/hub/server.js; - Cloudflare Worker Hub:一键部署,跨网络同步,还能驱动 iOS 小组件(Widgy / Scriptable)——这样你掏手机就能看到 Claude 和 Codex 的额度余量:
另外,macOS 用户还可以选择iCloud Drive 同步(免服务器、仅快照同步),或使用 macOS 14+ 的原生系统小组件把用量、额度和热力图直接放到桌面。同步协议细节参考 docs/API.md。
隐私与数据安全
Token Monitor 是local-first设计:所有日志解析在本地完成,不上报任何遥测;提示词、回答与源代码内容始终留在你自己的机器上。它只发送聚合后的用量数字,且仅在你主动开启同步功能时才会离开本机。完整说明见 docs/privacy.md。
常见问题
Q:Windows 上 WSL 里的用量能统计吗?能。Windows 版本会自动检测正在运行的 WSL 发行版并合并其文件型用量(约每 5 分钟一次);OpenCode、Hermes 等 SQLite 类工具可在 WSL 内按 docs/wsl-sqlite-setup.md 配置无头 agent。
Q:Claude Code 默认只保留 30 天会话,历史会丢吗?可以开启Preserve deleted session usage(设置 → Collection),Token Monitor 会把每日工具/模型用量归档到本地,即使源文件被清理,热力图和趋势依然完整。
Q:数据存在哪里?应用状态存放在系统用户数据目录(macOS:~/Library/Application Support/Token Monitor/;Windows:%APPDATA%/Token Monitor/;Linux:~/.config/Token Monitor/),删除该目录即可彻底卸载。
Q:想把用量导出到自己的表格或 Grafana?支持一键导出与 CSV + JSON 双格式自动落盘,方案见 docs/export.md。
写在最后
装好、启动、看数字——这就是 Token Monitor 的完整上手流程。它的核心逻辑集中在 src/electron/main.js(桌面组件入口)、src/agent/agent.js(无头采集器)与共享的用量管线 src/shared/usage.js,整体架构可阅读 docs/architecture.md,全部配置项与环境变量收录在 docs/configuration.md。如果你每天同时在多款 AI 编程工具间切换,Token Monitor 能帮你把"Token 花到哪了、额度还剩多少"变成一屏可见的确定性。
【免费下载链接】token-monitorLocal-first desktop widget for tracking token usage, costs, and limits across 43+ AI coding tools—including Claude Code, Codex, Cursor, OpenCode, OpenClaw, and more—with multi-device sync.项目地址: https://gitcode.com/gh_mirrors/tok/token-monitor
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考