TokenRemain：macOS AI 编码额度菜单栏工具

项目简介

TokenRemain 是一款 macOS 菜单栏应用，把 Claude Code、Codex、Cursor、Grok、GLM 等 27+ 款 AI 编码工具的剩余额度、重置倒计时和当日成本汇总在同一屏里。它直接从本机已有的登录状态和本地日志读取数据，只读、不刷新第三方 token、不上传凭据，也不需要注册账号。

主要功能

额度（Quota）

• 并排展示每款工具的所有官方额度窗口，带进度条、重置倒计时和数据新鲜度；Overview 按最紧急优先排成一张表。
• 节奏预测：根据当前窗口的真实进度判断按此速度能否撑到重置，撑不到时给出耗尽时间预估。
• 多账号：同一工具的每个账号单独成行，账号管理页可开启或暂停监控、重命名、更新凭据。
• 多种查看位置：菜单栏胶囊、跨 Space 的浮动窗口、Dock 图标上的两个进度条（应用可自选），以及 macOS 26 的 Liquid Glass 面板。

用量（Usage）

• 当日成本：内置 ccusage 离线统计 15+ 款本地编码工具（含 Claude Desktop / Cowork），按官方 API 标价估算。
• 每日用量趋势支持用 Apps 菜单增删应用，选择会被记住。
• token 构成与输出速度：输入、输出、缓存写入、缓存读取分别统计；点某一天可看按模型的拆分和基于本地 Claude Code、Codex 日志估算的端到端 tok/s。
• 订阅：填写每月套餐价格，支持按账号覆盖、排除雇主付费项；Overview 的套餐徽章跟随此设置。
• 显示货币支持 USD、CNY、EUR、JPY 等，仅换算标价估算值。

隐私

• 读取本机已有登录信息，无遥测，不刷新第三方 token，不上传凭据。
• 可选加密同步默认关闭；开启后只把白名单快照加密写入你自己的 iCloud，供 iPhone、Apple Watch 和主屏小组件使用。
• 界面支持英语、简体中文、繁體中文、日本語、한국어等。

安装与使用

1. 从官网下载 DMG，把 TokenRemain 拖入「应用程序」并打开。
2. 首次启动会扫描本机已安装的 AI 工具，勾选要追踪的项目即可，无需单独登录。
3. 对 Z.ai、OpenRouter 等需要 API Key 的服务，直接在对应额度卡片或 Data Sources 页的「API key settings」里粘贴，密钥保存在 macOS 钥匙串。
4. 在 Settings › Refresh & Sync 设置额度刷新间隔（1–30 分钟或手动）；在 Settings › General 选择 Dock 图标的两个应用和显示货币；在 Overview › Subscriptions 填写实际订阅费用。

系统要求：macOS 14+，Universal 版本，已通过 Apple 公证。网站：https://tokenremain.com

注意事项

• Claude Code / Cowork 的本地 token 统计不需要额外安装 CLI；但 Claude 额度需要一个可读取的 Claude Code 登录，或在 Data Sources 页配置 claude.ai 会话，仅登录 Claude 桌面端不保证凭据持续续期。
• iPhone 端目前处于公开 TestFlight 测试，数据由 Mac 单向发布并加密，移动端源码不在本仓库开源范围内。
• 项目采用 Apache-2.0 许可证。

本作品整理自 GitHub 开源项目 Carstin520/token-remain，原作者 @Carstin520，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。