AI 编程工具用了多少 token？花了多少钱？额度还剩多少？菜单栏上看一眼就知道。
English | 简体中文
AI 编程工具的 token 用量、费用与订阅额度——菜单栏一屏看完。TokenMe 只读各家工具落盘的日志与数据库，在本机汇成一份索引：不碰代码内容、无遥测；多机经 ssh 汇总成同一份账，配额走各家自己的接口只读探测，七家每日签到一键代领。macOS 与 Windows 原生安装包，Linux 一等采集端，外加 CLI。
- 宠物命中像素级精确：图片画到哪里才能点哪里，透明区域不再误触
- 面板不再卡在「正在索引」：boot 读取自动重试，App Nap 节流已阻断
- ZCode 每日领取自动打卡，支持安装版客户端版本；领取过程全程留痕可查
- webview 异常写入日志，问题可自述；详见 CHANGELOG
菜单栏点开后分五页，一层层往下钻：
- 概览——当天的 token、费用与缓存命中率，按小时分布的用量柱状图；「活动」页签是 GitHub 式的年度热力图，右滑翻看上周、上月与去年。下面是各家配额条：剩余比例和重置倒计时，支持签到的工具在行头一键领取；窗口跨过 80% 或耗尽时弹一条原生通知——提醒档位与「问哪几家」都归设置管；
- 速度——TTFT（首 token 延迟）与 TPS 被动测量，Codex、Claude Code 还能主动发起一次短请求实测；
- 工具——每个工具的请求数、会话数、token 量与缓存率，一行一个，行配色取自应用图标；
- 排行——按会话排名，一眼找出最贵的那几个；
- 明细——单次请求级的记录，可以按模型、项目筛选。
界面语言跟随系统，中英双语。费用是折算出来的：token 计数乘以 models.dev 的模型单价——和官方扣款记录未必分毫不差，但足够回答钱花在哪、花得值不值。几十万条事件的索引在本机秒级建好，之后每次增量扫描只需几十毫秒。
按平台选择：macOS · Windows · Linux · 从源码构建
Homebrew（推荐）——tap 一次，之后用短名：
brew tap Bencibr/tokenme https://github.com/Bencibr/homebrew-tokenme
brew trust bencibr/tokenme # 一次即可——brew 6 对第三方 cask 有信任确认
brew install --cask tokenme # 菜单栏面板
brew install tokenme-cli # CLItap 随每次发布自动更新，brew upgrade 即可升级；cask 安装不带隔离标记，Gatekeeper 不会拦。
手动装 DMG：到 Releases 下载，拖入 Applications。安装包是 ad-hoc 签名（没有开发者证书），Gatekeeper 可能拦一下——右键打开即可，或清掉隔离标记后正常启动：
sudo xattr -rd com.apple.quarantine /Applications/TokenMe.app到 Releases 下载安装程序。安装器支持"所有用户"模式：共享电脑上请选择所有用户，升级时也保持同一模式——这样会原地替换机器级安装，并对所有 Windows 账户生效。安装包同时包含 tokenme 命令行工具，并自动将其 bin 目录加入用户 PATH（只为我）或系统 PATH（所有用户）。安装后重新打开终端，即可运行 tokenme --help、tokenme daily 和 tokenme quota。升级不会重复添加 PATH 项，卸载时会移除该安装目录的 PATH 项。
没有菜单栏面板，但 Linux 是一等采集端：完全静态的二进制（musl，x86_64 / aarch64，不需要 glibc 对齐，机器上也不用装 Rust 或 Python）。到 Releases 下载压缩包（内附 install-linux.sh）：
tar xzf tokenme-cli-*-linux-musl.tar.gz
cd tokenme-cli-*-linux-musl
./install-linux.sh --every 15 --push you@display-host一条命令装进 ~/.local/bin 并挂上定时上报。面板底栏的「服务器」入口还能把 ssh 这半边代办掉：探测主机、固定指纹、投放采集器、按周期拉取合并——细节见用户指南 §4。
git clone https://github.com/Bencibr/tokenme.git
cd tokenme
cargo install --path crates/usage-cli --bin tokenme # CLI
./scripts/build-macos.sh # macOS 面板装好先跑一次探测，再看最近一周的账：
tokenme detect # 自动探测本机装了哪些工具、日志在哪
tokenme daily --days 7 # 最近一周的每日消耗与账单
tokenme quota # 各家订阅的实时额度与重置倒计时不开面板时，CLI 读的是同一份索引：
$ tokenme daily --days 3
┌────────────┬──────────┬──────────┬────────┬────────────┬────────┬────────┬─────────┬────────┐
│ Day │ sessions │ requests │ input │ cache read │ output │ total │ cost │ cached │
├────────────┼──────────┼──────────┼────────┼────────────┼────────┼────────┼─────────┼────────┤
│ 2026-09-25 │ 216 │ 12,900 │ 56.2M │ 1.68B │ 4.5M │ 1.74B │ $99.15 │ 96.8% │
│ 2026-09-26 │ 45 │ 4,592 │ 30.5M │ 704.9M │ 1.8M │ 737.1M │ $54.53 │ 95.9% │
│ 2026-09-27 │ 6 │ 2,534 │ 25.1M │ 377.1M │ 1.1M │ 403.4M │ $46.49 │ 93.8% │
├────────────┼──────────┼──────────┼────────┼────────────┼────────┼────────┼─────────┼────────┤
│ total │ 256 │ 20,026 │ 111.8M │ 2.76B │ 7.4M │ 2.88B │ $200.18 │ 96.1% │
└────────────┴──────────┴──────────┴────────┴────────────┴────────┴────────┴─────────┴────────┘
| 命令 | 说明 |
|---|---|
tokenme daily --days 30 |
按天汇总吞吐、缓存率与费用 |
tokenme report --window week --group model |
单窗口多维拆分与环比 |
tokenme quota |
实时配额与重置倒计时 |
tokenme budget set zcode --monthly 50 |
为无限额工具设定成本上限 |
tokenme export / tokenme import |
把本机一段窗口导出给另一台机器合并——纯文件、幂等、无账号 |
tokenme pricing explain <model> |
审计定价来源 |
以下工具全部内置适配器——共 30 款，直接从各工具自己落盘的日志与数据库建立索引；配额条只读凭据、绝不代你登录。签到、令牌自动续期与宿主退出暂停的细节见用户指南：
| 工具 | 实时配额 | 签到 | 兼容性测试 | macOS | Windows |
|---|---|---|---|---|---|
 Claude Code |
官方 5 小时/周期窗口 | — | ✅ | ✅ | ⏳ |
 Codex |
ChatGPT 速率窗口 | — | ✅ | ✅ | ✅ |
 OpenCode |
OpenCode Go 三美元窗口（仅官方 provider） | — | ✅ | ✅ | ⏳ |
 Open Design |
Design Plan 5 小时/7 天额度 | — | ✅ | ⏳ | ✅ |
 Pi |
— | — | ✅ | ✅ | ⏳ |
 Oh My Pi |
— | — | ✅ | ✅ | ⏳ |
 Cline |
账号窗口限额 | — | ✅ | ✅ | ✅ |
 Codely（Tuanjie / Unity，含 Cowork 桌面端） |
5 小时/每周窗口 | — | ✅ | ⏳ | ✅ |
 ZCode |
5 小时/周期窗口 + 会话预算 | ✅ | ✅ | ✅ | ✅ |
 Qoder |
订阅额度 | ✅ | ✅ | ✅ | ⏳ |
| Qoder CN |
Credits + 套餐/资源包 | ✅ | ✅ | ⏳ | ✅ |
 Antigravity |
自算（CLI /usage） |
— | ✅ | ✅ | ⏳ |
 Antigravity IDE |
自算（本地会话库） | — | ✅ | ✅ | ⏳ |
 AgnesCode |
会员点数（注入一次令牌） | — | ✅ | ✅ | ✅ |
 AtomCode |
CodingPlan 配额 | — | ✅ | ✅ | ⏳ |
 WorkBuddy AI（国际版） |
会员点数 | — | ✅ | ✅ | ✅ |
| WorkBuddy（国内版） |
积分包配额 | ✅ | ✅ | ⏳ | ✅ |
 CodeBuddy |
Craft 积分 | — | ✅ | — | ✅ |
 Hermes |
— | — | ✅ | ✅ | ⏳ |
 FunIDE |
GLM 套餐点数 | ✅ | ✅ | ✅ | ⏳ |
 妙手（原 CatPaw） |
积分余额 | — | ✅ | ✅ | ✅ |
 DSH |
DeepSeek 账户余额 | — | ✅ | ✅ | ✅ |
 Crow5 |
— | — | ✅ | ✅ | ⏳ |
| Mimocode | — | — | ✅ | ✅ | ⏳ |
 Cola |
套餐配额 | — | ✅ | ✅ | ⏳ |
 JoyCode |
IDE 点数 | — | ✅ | ✅ | ⏳ |
 Trae |
订阅配额 | — | ✅ | ✅ | ⏳ |
| Trae CN |
订阅配额（按积分包拆分） | ✅ | ✅ | ✅ | ⏳ |
 Kimi Code |
5 小时/每周/每月额度 | — | ✅ | ✅ | ✅ |
 MiniMax Code |
5 小时/周额度 + 积分余额 | ✅ | ✅ | ✅ | ✅ |
兼容性测试：每款适配器都带夹具测试套件，CI 每次提交全量运行；每项接入落地前都用真实机器的数据验证过。
平台验证：随实机验证进度更新。⏳ 表示该平台的路径已实现、但尚未在实机上跑通；验证通过后更新标记即可。
仅配额的来源：Copilot（高级请求额度，官方后端）只探测配额、不索引用量；Gemini CLI 的探测刻意关闭——实测其落盘 OAuth 令牌已过期，要续期就得用 Gemini CLI 自带包里的 client id/secret 去提交表单，而磁盘上也找不到该接口要的 project id（
crates/usage-quota/src/providers/gemini.rs）。
AgnesCode 令牌注入：其登录令牌只存在于应用内存，无法静默读取。登录 agnescode.agnes-ai.cn 后从请求头取
access_token，写入 tokenme 系统配置目录下的agnes.token（macOS 为~/Library/Application Support/tokenme/agnes.token，Linux 为~/.config/tokenme/agnes.token，Windows 为%APPDATA%\tokenme\agnes.token），或设置AGNES_TOKEN即可启用。
TokenMe 可以从本地客户端活动中被动测量 TTFT（首 token 延迟）和 TPS（每秒生成 token 数）。这些是客户端实际观测值，不是厂商基准测试。启用采集后才开始记录，不会补录此前的活动。
| 宿主 | 被动测量 | 用户主动测试 |
|---|---|---|
| Codex | 从本地 Codex rollout 流中读取轮次级 TTFT；流中提供输出 token 数和计时信息时计算 TPS | 支持：通过 Codex CLI app-server 发起一次短请求 |
| Claude Code CLI | 从 Claude Code OpenTelemetry span 读取请求级 TTFT 和 TPS；首段内容耗时单独标记，不等同于 TTFT | 支持：通过临时、仅对该进程生效的遥测配置发起一次短请求 |
| DSH（DeepSeek Harness） | 从本地压缩会话日志读取请求级 TTFT 和 TPS；日志包含首 token 时间时才可测量 | 暂不支持，仅被动采集 |
DSH 按会话汇总：TTFT 取请求均值，TPS 按输出 token 除以解码耗时；旧日志缺首 token 时间则无此指标。主动测试点击后才发一条短提示（消耗套餐额度），结果与被动均值分开显示，提示词与回复一概不留。
多台电脑上都装了 TokenMe 时，可以让一台做主端、其余做从端：从端的用量自动汇入主端，主端的数据也会下发到从端，任何一台机器上都能看到全家桶的合并视图。
- 前提：两台机器在同一局域网；主端开机 TokenMe 在运行（它就是你的同步服务器）。
- 配对：主端面板 → 设备同步 → 生成配对邀请，从端扫码/粘贴即可。默认逐台确认，也可开免认证接入。
- 端口：主端监听 47821 端口，首次启动如弹防火墙授权请允许。
- 容量：一台主端最多带 8 台从端。
- 升级：从旧版本升级后如提示"需要重新配对"，重新生成一次邀请即可，用量数据不受影响（数据本就各自留底，同步是汇聚不是搬运）。
只索引计数，不碰内容——你的代码和 Prompt 不会被存储，入库的只有每次请求的 token 计数、模型名与项目路径。扫描全程只读，无遥测、无第三方代理。索引库位于系统数据目录（macOS 为 ~/Library/Application Support/tokenme/）；各工具日志路径见用户指南。
多机汇总时数据也只走你自己的通道——ssh/scp，或面板「服务器」入口的一键部署——无账号、无云端；细节见用户指南 §4。
| 问题反馈 | GitHub Issues |
| 微信交流群 |  |
| 邮箱 | 面板「设置 → 联系我们」直达（地址在 apps/tokenme-bar/src/lib/about.ts） |
基于 MIT 协议开源。
完整参考：docs/COMMANDS.md · 场景指南：docs/USER_GUIDE.md · 架构总览：docs/ARCHITECTURE.md