☰
3分钟上手 Token Monitor:零配置追踪 Claude Code、Codex、Cursor 的 Token 用量与成本
2026/10/3 7:38:02 网站建设 项目流程

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 中选一种同步后端:

  1. Widget 内置 Hub(最简单):在一台常开的机器上选择"Host hub on this device",其他设备填上局域网地址 + 密钥即可,无需命令行;
  2. Node Hub:在常开的服务器上执行npm run hub,适合无界面的无头机器,Hub 服务端逻辑见 src/hub/server.js;
  3. 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询