Tokenmeter

Tokenmeter版本 1.1.0

Claude 和 Codex 用量,随时在眼前

输入框下方的状态栏和桌面上的玻璃质感小组件,显示 5 小时和每周限额、何时重置,以及每次会话花了多少。

Windows 10/11 · macOS 13 或更高版本 · 一个压缩包,含两个安装程序

收起状态的小组件:5 小时用量 62%(橙色,并提示将会用完),每周用量 38%(绿色)。

两种方式,随时掌握

在状态栏里

就在 Claude Code 输入框下方:上下文用了多少,本次会话消耗的 token 和费用,以及两项限额距离重置还有多久。只要运行着 Claude Code,就能用。

在你的桌面上

一张小巧的悬浮卡片,用绿、橙、红显示两项限额,并标出当前窗口已经过去多久。如果按现在的速度会在重置前用完,它会告诉你大约什么时候。也在用 Codex?卡片上的切换按钮会显示它的限额。

  • 还很充裕
  • 接近上限
  • 快用完了

点滴细节,贴心省事

就在刘海旁

在带刘海的 Mac 上,Tokenmeter 就在刘海两侧:一侧是 5 小时限额,另一侧是距重置的时间。将指针移上去,它会展开,显示两项限额、今日花费和 Claude / Codex 切换。没有刘海的 Mac 上,它位于屏幕顶部中央。

刘海视图。收起时:5 小时限额已用 62%,距重置 2:20。展开时:Claude / Codex 切换、今日花费和两项限额。

花费与模型

打开统计视图,一览全貌:按日、周、月统计 Claude Code 和 Codex 会话若按 API 价格计费的花费,以及各模型的占比。

按日最近两周,逐日一目了然。
统计视图的“日”标签页:最近两周每天的花费以柱状图显示,下方是各模型占比。
按周哪几周用得多,哪几周清闲,一看便知。
统计视图的“周”标签页:每周花费的柱状图。
按月放长视野,逐月查看。
统计视图的“月”标签页:每月花费的柱状图。

截图:macOS 版小组件,使用演示数据。 Windows 版小组件功能相同。

每次会话,逐条列明

每次 Claude Code 和 Codex 会话各占一行:标题、项目、时间、token 和费用,最新的在最上面。花钱多的一眼就能看出来。

统计视图的“会话”标签页:最近会话的列表,含项目、时间、token 和费用。

一分钟装好

一个压缩包里有两个安装程序,运行适合你系统的那个即可。

Windows 10 和 11你的系统

  1. 下载压缩包,解压后打开 tokenmeter 文件夹。
  2. 双击 install.cmd,或在 PowerShell 中运行:
    powershell -ExecutionPolicy Bypass -File install.ps1
  3. 重启 Claude Code。状态栏会出现在输入框下方,小组件图标随第一个会话出现在托盘或菜单栏中。限额几秒内就会填入。

macOS 13 及更高版本你的系统

  1. 解压下载的文件,然后在终端中进入 tokenmeter 文件夹运行:
    bash install.sh
  2. 重启 Claude Code。状态栏会出现在输入框下方,小组件图标随第一个会话出现在托盘或菜单栏中。限额几秒内就会填入。

只装你需要的

只想要状态栏?可以不装小组件。已经装好了?可以在小组件菜单里关闭状态栏,或让小组件不随 Claude Code 启动:另一部分照常工作。

Windows
powershell -ExecutionPolicy Bypass -File install.ps1 -NoWidget
macOS
bash install.sh --no-widget

点击图标打开卡片,右键点击打开菜单。如果小组件没有运行,请在 Windows 的“开始”菜单或 macOS 的“应用程序”中打开 Tokenmeter。

更新或卸载

更新

小组件每天向本站询问一次是否有新版本。有的话,刷新按钮上会出现一个圆点,菜单里也会出现更新项。请求只带版本号和系统,你可以在菜单中关闭这项检查。

  1. 从本页下载新的压缩包。
  2. 再运行一次安装程序,历史和设置都会保留。

卸载

移除 mod、小组件及其快捷方式。

Windows
powershell -ExecutionPolicy Bypass -File install.ps1 -Uninstall
macOS
bash install.sh --uninstall

加上 -KeepHistory(Windows)或 --keep-history(macOS)可保留历史记录。

同步的是数字,不是你的工作

按日、模型和会话统计的花费与 token 数会同步到 tokenmeter.nextwell.top,这样重装后历史依然在,关联的设备也能看到彼此的总计。会话标题、项目名称和提示词不会离开你的电脑;国家在上传时根据你的 IP 地址判断,地址本身不会保存。在设置中勾选“不与服务器同步”即可全部留在本地;“删除历史”会同时删除本机和服务器上的数据。限额使用你自己的 Claude Code 登录凭据向 Anthropic 查询;凭据从不刷新,也不会发往别处。

你需要准备

  • Windows 10 或 11,或 macOS 13 及更高版本
  • 支持 mod 的 Claude Code(已在 2.1.296 上测试)。mod API 尚处于早期访问阶段,不同版本之间可能有变化。
  • Claude Pro 或 Max 订阅,或用于 Codex 的 ChatGPT 套餐:限额来自你的账号。
  • 花费历史需要 Node.js。没有它,限额依然可以显示。

这些数字怎么看

  • 限额就是你账号本身的数字,与 claude.ai 的 Usage 页面一致,每五分钟读取一次:claude.ai 和你的其他设备也计算在内。
  • 费用是相同 token 按 API 价格计算的金额。订阅并不按这种方式计费,它显示的是你从订阅中获得了多少价值。
  • 历史读取自 Claude Code 和 Codex 本地的会话日志。小组件从第一次运行起自己记账;更早的时期为估算值,颜色会更淡。

用完之前,先知道。

免费、开源、安静:你不看它,它就待在角落里。

Windows 10/11 · macOS 13 或更高版本 · 一个压缩包,含两个安装程序