TokenRemain
AI 编码工具的剩余额度，常驻 Mac 菜单栏。
凭证只留在本机：只读、不刷新、不上传。
官网 ·
iPhone 测试版 ·
更新记录 ·
隐私政策 ·
问题反馈 ·
English
[!TIP]
1.4 新功能：Dashboard 新增「账号管理」，多账号可单独启停与重命名；趋势页拆分输入 / 输出 / 缓存写入 / 缓存读取，并在本机估算各模型输出速度（tok/s）；成本估算支持 13 种显示币种；Claude Desktop / Cowork 会话计入本地统计。完整内容见更新记录。
功能
🧭 额度：撑不撑得到重置，一眼就知道
- 27+ 家工具并排展示：每个官方额度窗口都带进度条、重置倒计时和更新时间。
- 节奏预测：按真实窗口进度判断当前节奏能否撑到重置，撑不到时给出预计可用时长。
- 多账号：同一工具的多个账号分行显示；「账号管理」页可按应用开关监控、启停账号、重命名、更新凭证，同套餐账号可选合并查看。
- 随处可见：菜单栏胶囊、跨空间浮窗、Dock 图标双仪表（两款应用自选），macOS 26 上使用 Liquid Glass。
📊 用量：Token 花在哪、跑得多快
- 今日成本：内置 ccusage 离线统计 15+ 种本地编码 Agent（含 Claude Desktop / Cowork），按官方 API 标价估算。
- Token 构成：输入、输出、缓存写入、缓存读取分开统计；点击趋势图任意一天即可展开按模型的明细。
- 输出速度：从本机 Claude Code 与 Codex 会话日志估算各模型的端到端 tok/s，只读取时间戳与 Token 计数。
- 显示币种：USD、CNY、EUR、JPY 等 13 种；只换算 API 标价估算，官方账单与余额保持原币种。
🔐 隐私：凭证从不离开你的 Mac
- 只读本机已有凭证：无需注册账号，无遥测，不刷新第三方 token，不上传凭证。
- 可选加密同步：默认关闭；开启后只把白名单字段组成的快照加密写入你自己的 iCloud，供 iPhone、Apple Watch 与桌面小组件显示。
- AI 动态：精选 Anthropic、OpenAI 等官方账号，额度重置与重大更新可推送本机通知。
- 低能耗：后台 CPU 比 v1.2.2 降低 95%（测试方法）；界面支持简体中文、繁體中文、English、日本語、한국어 等多种语言。
界面一览
iPhone 版目前为 TestFlight 公开测试；数据由 Mac 单向加密发布，移动客户端源码不在本仓库开源范围内。
快速上手
- 安装：下载 DMG，把 TokenRemain 拖进「应用程序」后打开。
- 选择工具：欢迎页会扫描本机已安装的 AI 工具，勾选要追踪的即可。凭证沿用各工具自己的登录，无需在 TokenRemain 里再登录；Codex 可沿用官方桌面 App 的登录。
- 补充密钥：Z.ai、OpenRouter 等需要 API Key 的服务，直接在对应额度卡里粘贴，或在「数据来源」页的「API Key 设置」中填写。密钥只存本机钥匙串。
- 按需调整：在「设置 › 刷新与同步」调整额度刷新频率（1–30 分钟或仅手动）；在「设置 › 通用」选择 Dock 图标显示的两款应用和显示币种；在「账号管理」页管理多账号。
[!NOTE]
Claude Code / Cowork 的本地 Token 统计无需额外安装 CLI。Claude 额度需要可读取的 Claude Code 登录，或在「数据来源」中手动配置 claude.ai 会话（见常见问题）；仅登录 Claude 桌面 App 不保证能续期 Code 凭证。
支持接入的应用
🟢 自动 = 登录对应工具即接入 · 🔑 API Key = 粘贴一次密钥，仅存 macOS 钥匙串
| 应用 | 接入 | 读取内容 |
|---|
| Claude Code | 🟢 | 5 小时 / 7 天窗口；第三方 ANTHROPIC_BASE_URL 标注实际 API |
| Codex | 🟢 | 5 小时 / 7 天窗口、重置卡；自定义 base_url 标注实际 API |
| Cursor | 🟢 | 月度账期额度，Cursor 模型与其他模型分池显示 |
| Grok（xAI） | 🟢 | 周池剩余额度 |
| Grok Bot | 🟢 | 周额度；通过本机 Cursor 登录读取，需与 Grok Bot 使用同一 Cursor 账户 |
| GitHub Copilot | 🟢 | 月度 Credits |
| Devin | 🟢 | 日 / 周配额 |
| Windsurf | 🟢 | 日 / 周配额 |
| Antigravity | 🟢 | 配额池 |
| OpenCode | 🟢 | 套餐本地估算；第三方 provider 标注实际 API |
| Z.ai / 智谱 | 🔑 | Coding Plan 额度；macOS 国内站另支持普通 API Key 的人民币余额（中国 → API 余额） |
| OpenRouter | 🔑 | Key 限额、Credits 与账户余额 |
| 应用 | 接入方式 | | 应用 | 接入方式 |
|---|
| DeepSeek | API Key | | Qoder | Cookie |
| Kimi | API Key / Cookie | | Kiro | kiro-cli /usage 解析 |
| MiniMax | API Key | | 火山引擎 | AK:SK 签名 |
| MiMo Code | Cookie | | Ollama | session Cookie |
| GLM Team | API Key + Org + Project | | 阿里云百炼 Token Plan | 控制台 Cookie |
| Amp | 自动读取 Amp CLI 的 Key，或 Cookie | | Muse | Cookie（muse.ai） |
| Muse Code | Cookie（dev.meta.ai），按团队读取 | | Factory | Cookie（app.factory.ai） |
| Augment | Cookie（app.augmentcode.com） | | 第三方 API | New API / 自定义余额接口 |
Cookie 型服务怎么接入：在浏览器登录对应网站后，从开发者工具复制请求里的 Cookie 值（或右键请求「复制为 cURL」），粘贴到该服务的额度卡，或在接入引导里点「从剪贴板粘贴」即可（也可用 QODER_COOKIE、MIMO_COOKIE、OLLAMA_COOKIE、MUSE_COOKIE、MUSE_CODE_COOKIE、AMP_COOKIE、FACTORY_COOKIE、AUGMENT_COOKIE 环境变量提供）。Cookie 与 API Key 一样只存本机钥匙串；TokenRemain 从不读取浏览器自身的 Cookie 存储。Cookie 等同于登录凭证，请勿分享；退出网站登录后它会失效，需要重新粘贴。
本地成本来源：内置 ccusage 动态发现 Claude Code、Codex、Gemini、Goose 等 15+ 种本地 Agent，并合并 ~/.claude、~/.config/claude、CLAUDE_CONFIG_DIR 与 Claude Cowork 的会话目录（自动去重，可在「数据来源」页添加自定义目录）；Trae 只读取所选目录中的时间、模型与 Token 计数。托管模型按官方标价估算，Ollama 等本地模型记零成本；价格未知时仍保留 Token 数。
隐私
你机器上已有的凭证 ──只读──▶ 各服务商官方 API ──▶ 本地渲染并缓存
每一条都附有可核对的源码或测试：
- 只读凭证，绝不刷新：只读各工具自己维护的 token，从不写回、不争用 refresh token；后台读取关闭钥匙串交互，不会弹出授权窗。 🔍 契约脚本 · 测试 · 源码
- 手动密钥只进本机钥匙串：粘贴的 API Key 存入 macOS 钥匙串，且禁止同步到 iCloud 钥匙串。 🔍 源码 · 测试
- 无账号、无遥测、无凭证中转：额度查询直连各服务商官方 API；依赖只有 Sparkle 与本仓库的同步包，没有任何分析 SDK。 🔍 依赖清单
- 价格与汇率更新不带任何本机数据：价格表每天至多一次无 body、无参数、无认证头的 GET；只有选择 USD 以外的币种时，才向公开汇率接口发出同样固定的请求。 🔍 价格测试 · 契约脚本 · 汇率源码
- 同步默认关闭，端到端加密：开启后，只有白名单字段组成的展示快照在本机 AES-GCM 加密，再写入你自己的 iCloud 私有库。 🔍 默认关闭测试 · 字段白名单 · 加密实现
其他联网行为（均不携带凭证或用量）：AI 动态从 api.tokenremain.com 拉取公开内容，通知默认关闭，开启后才用随机安装 ID 注册推送；服务状态读取 status.openai.com、status.claude.com 的公开接口；非 USD 显示币种读取 open.er-api.com 的公开参考汇率；更新检查读取 GitHub 上签名的 appcast；局域网直连同步监听 TCP 47831，只接受已配对设备。
细节见隐私政策。
常见问题
TokenRemain 从不刷新 token，只读取工具自己保存的登录状态。到对应工具里重新登录并正常使用一次，数据会自动恢复；Antigravity 等工具需要先打开使用一次，凭证才会写到本机。
在「数据来源」的 Claude 行粘贴你自己的 claude.ai sessionKey 或 Cookie。验证成功后只保存在本机钥匙串、不参与 iCloud 钥匙串同步；TokenRemain 不会导入浏览器 Cookie，也不会刷新第三方凭证。配置后默认 Claude 额度明确来自该网页账号，独立 CLI 账号仍使用各自凭证；移除 Cookie 即恢复本地 OAuth。多个组织无法唯一匹配时需要填写目标组织 UUID。
该网页接口不是公开接口，访问质询、会话过期或网络失败都可能导致暂时无法读取，此时卡片保留上一次的额度和原更新时间。
此时卡片显示的是最近一次成功的缓存，网络恢复后自动重试，不会要求你重新登录。官方 API 走系统代理；凭证过期需要借助 Claude Code CLI 续期时，TokenRemain 会依次尝试 App 环境变量、Claude Code settings.json 的 env、系统代理（含 PAC）和登录 shell 导出的代理变量，选第一条能连通 api.anthropic.com 的。仍无法恢复时，可在终端运行一次 claude 并执行 /usage。
会。本地统计自动合并 ~/.claude、~/.config/claude、继承的 CLAUDE_CONFIG_DIR 和 Claude Cowork 的 .claude/projects 目录，由内置 ccusage 离线读取并去重；「数据来源」页可以查看发现的目录，也能添加包含 projects 的自定义配置目录。普通聊天、网页和手机会话不产生本地 Token 日志，因此不会计入。
预警取所有窗口中最紧缺的一个（通常是 7 天窗口），卡片头行显示的是 5 小时窗口，两者不是同一个窗口。
成本按官方 API 标价估算本地 Token 用量，用于衡量用量规模，不等于订阅账单。切换显示币种只换算这部分估算值，官方账单金额与账户余额始终保持原币种。
TokenRemain 在每次本地统计刷新后，增量读取 Claude Code 与 Codex 会话日志新追加的部分，只提取时间戳、模型名与 Token 计数，估算各模型的端到端输出速度（包含首 Token 延迟）。扫描在低优先级下进行，有时间和数据量上限，结果只保存在本机。
Claude Code 设置了 ANTHROPIC_BASE_URL，或 Codex 配置了自定义 base_url 时，额度来自实际提供服务的 API，卡片会注明来源。如果你用的是官方登录却被这样标注，请提交 issue 并附上脱敏后的配置。
退出 TokenRemain 并删除 App 后，可清理本地偏好与缓存：
defaults delete com.jamesli.usagedock
rm -rf ~/Library/Caches/com.jamesli.usagedock ~/Library/Application\ Support/com.jamesli.usagedock
手动粘贴的密钥可在「钥匙串访问」中搜索 com.jamesli.usagedock 删除。开启过同步的话，如需清除 iCloud 中的数据，请联系支持。
还有问题？请提交 issue 或查看支持页。
参与开发
欢迎提交 issue 与 PR。构建、测试、目录结构与代码约定见 CONTRIBUTING.md；安全问题请按 SECURITY.md 私下报告，不要公开提交 issue。
下载趋势
基线为截至 2026-08-07 的 163 次历史下载（明细），此后由匿名下载入口即时累计，并每小时与 GitHub 上的 DMG 下载总数对账，不含任何个人数据。
致谢
第三方版权与许可声明见 NOTICE。
许可
源代码与源文档采用 Apache License 2.0；TokenRemain 名称、Logo、图标、机器人形象与原创设计素材不在授权范围内，详见品牌与素材许可说明。
TokenRemain 是独立应用，与 Anthropic、OpenAI、Anysphere、xAI、GitHub、智谱 AI 或任何服务商均无隶属、背书或赞助关系；服务名称与标识仅用于标示你可选择接入的服务。发布者与支持联系人：Dongheng Li · [email protected] · © 2026
