项目说明
这个项目从最初的几个订阅监控功能开始,前前后后迭代了近两个月,经历了几十个版本。随着使用场景不断扩展,我也陆续加入了更多功能。非常感谢各位使用者在体验过程中提出的建议和反馈,正是这些真实的使用需求,帮助我不断完善了这个属于我的第一个应用。
项目功能
如果你正在用 Claude Code、Codex CLI、OpenCode这些Vibe Coding工具,或者订阅了多个AI应用工具,比如 Copilot、Cursor、Gemini CLI 这些。可能就会想到要实现以下几个功能:
把散落在各家网页和 CLI 里的额度消息提取出来,实时掌握各个账号还剩多少额度、五小时窗口快满了没有,而不需要一个个去翻,最好还能及时提醒自己。 想让 Claude Code 跑 DeepSeek、让 Codex 指向某个中转站或者订阅服务,模型配置可以一键切换;甚至使用中途可以不用退出,对话期间就可以直接换模型继续接着对话; 不用手动改 ~/.claude/settings.json、~/.codex/config.toml文件,一切都是可视化配置。 走第三方中转后,官方账单帮不上忙,本地也可以测一测到底花了多少钱、哪个站点贵,哪家缓存命中率高。 装了一堆 MCP server 和技能,时间一长根本记不清哪些真在被调用、哪些是装完再没碰过的僵尸skill,防止占用上下文。
我写这个AIUsage 项目,主要就是把这四件事放进一个 macOS 应用:
看额度和费用:十多家AI服务商的订阅额度、用量、费用,一个仪表盘汇总,Mac顶部菜单栏常驻一眼可见。 换上游不用手改配置 :内置 Claude Code、Codex、OpenCode 三套相互独立的代理配置区,建节点、点激活,配置文件自动接管,停用自动还原,全局代理可以直接实现对话期间无缝切换模型,而不需要退出重载配置文件。 按节点算API消耗 :实时记录每个节点,每个模型的消耗,用量,价格,缓存读写的大小,以及缓存命中率,实时记录每次对话模型的可用性,延迟情况等。 看清调用习惯 :读解析三家 CLI 的本地会话日志,统计 MCP / 技能 / 工具的调用次数,并标出装了却从没调用过的技能和 MCP。

设计灵感参考了 CodexBar 和 Quotio 两个额度看板,但 AIUsage 在此基础之上进行了拓展很多功能。
核心功能
额度与费用,一个仪表盘看全
进应用第一眼。每家已连接的服务商一张额度卡,卡上是当前周期剩余/已用、费用,以及刷新时间。卡片的进度指示样式可以在设置里换成横条、圆环或分段,进度含义可选 显示剩余 或 显示已用。
多家服务商(Codex、Copilot、Cursor、Gemini、Kiro、Warp、Kimi、MiniMax 等)的订阅额度、用量、费用汇到一页,每家一张卡,菜单栏常驻一眼可见。

三套独立代理:换上游不用手改配置
内置 Claude Code、Codex、OpenCode 三套相互独立的代理。建节点、填上游 Base URL / Key / 模型 / 定价、点激活,对应的配置文件自动接管,停用自动还原文件,中途崩溃也能从备份恢复,不会把配置越叠越乱。
Codex:忠实透传 OpenAI Responses,不改写请求体,最大化兼容原生工具语义。 Claude Code:支持OpenAI Chat Completion/Resopnses和Anthropic 三种格式API,内部自动进行接口协议转换,并接入Claude Code。 OpenCode:支持OpenAI Chat Completion/Resopnses和Anthropic 三种格式API,按节点协议自动选对 npm 包,用量与费用以 OpenCode 自己的本地账本为准。

全局代理:固定端口 + 热切换
每套代理对外只暴露一个固定端口,CLI 指向它之后,换上游只在界面切激活节点,CLI 不重启、配置不动。每个请求按激活节点真实的上游模型改写,费用记到真实节点和模型上。

统一 API 提供商:配一次,分发三处
三套代理的节点配置大半字段是重复的。把 Base URL、格式、Key、模型库与定价抽成一份 API 提供商,一键分发到 Codex / Claude / OpenCode,每套生成一个链接节点。改主配置,跟随的节点同步更新;在某个节点单独改了某字段,该字段转成本地覆盖、不再跟随,其余照旧继承。重复分发幂等,不建重复节点。

用量统计:按节点、按模型进行统计
Claude、Codex、OpenCode 三条线的用量汇到一页,按模型拆分费用与 token、今日/本周/本月/全部切换。

调用分析:你到底在用哪些 MCP 和技能
只读解析三家 CLI 的本地会话日志,统计 MCP / 技能 / 工具,甚至子代理的调用次数排行与每日趋势,并把装了却从没调用过的技能和 MCP 标出来(僵尸检测),包括检测统计调用成功率和耗时。

顶部菜单栏:不打开主窗也能切
这是Mac系统的优势,顶部菜单栏常驻状态项,显示额度百分比 + 费用,点开是快览弹窗:摘要、进度条、费用追踪,以及三套代理的轨道切换器——可以直接在这里开关全局代理、热切换激活节点。

怎么上手
从 Releases 下载 .dmg 或 .zip,拖进「应用程序」。 服务商 → 账号,连上你在用的订阅,仪表盘和菜单栏随即显示额度与费用。 想换上游就进对应代理页:新建节点 → 填上游 Base URL / Key / 模型与定价 → 激活,配置文件自动接管和切换。 想多上游随时切又不重启 CLI,就用全局代理:CLI 指向固定端口,之后只切激活节点。 用量统计看费用与 token,调用分析看 MCP / 技能调用习惯。
GitHub地址:https://github.com/sylearn/AIUsage
夜雨聆风