1. 项目概述为什么我们需要一个AI订阅用量监控器如果你和我一样是个重度依赖AI编程工具的开发者那你肯定对下面这个场景不陌生为了搞清楚自己这个月还剩多少Claude的会话额度得先打开浏览器登录Anthropic的官网在一堆仪表盘里翻找刚查完又想起来GitHub Copilot的订阅好像快到期了于是又得切到GitHub的账单页面接着Cursor的信用点、Codex的周限额…… 查一圈下来十分钟过去了不仅打断了手头的工作流还搞得人心烦意乱。更糟的是这些数据分散在各个角落你很难对自己在所有AI工具上的总消耗和剩余额度有一个全局的、实时的把握。这就是OpenUsage诞生的背景。它不是什么复杂的系统而是一个极其简单、却又直击痛点的解决方案一个常驻在macOS菜单栏的小工具把你所有AI编程工具的订阅用量集中在一个面板里展示。进度条、徽章、清晰的标签一目了然彻底告别心算和反复登录。我用了它几个月最大的感受就是“省心”。你不再需要关心数据在哪只需要瞟一眼屏幕右上角所有信息尽在掌握。这对于那些同时订阅了多个AI服务比如我同时用着Claude、Cursor、Copilot和几个国内工具的开发者来说简直是刚需。这个项目本身也很有意思它完全由AI生成作者声称没有一行代码是手写的并且是开源、社区驱动的。这意味着它的功能会随着社区贡献不断丰富支持的AI服务提供商Provider也会越来越多。接下来我就结合自己的使用和探索带你深入拆解这个工具从设计思路、核心功能到实操部署和高级玩法让你不仅能用好它还能理解它背后的巧思。2. 核心设计思路与架构解析OpenUsage的设计哲学非常明确轻量、聚合、可扩展。这三点贯穿了它的整个架构也是它能在众多工具中脱颖而出的关键。2.1 轻量化与菜单栏常驻作为一个用量监控工具最重要的就是“无感”。它不能占用太多系统资源不能拖慢电脑速度更不能频繁弹窗打扰用户。OpenUsage选择以原生macOS应用的形式作为一个菜单栏图标常驻。这种设计有几个显著优势零侵入性它不占用Dock栏位置只在顶部的菜单栏占据一个极小的图标空间几乎不干扰你的桌面布局和工作视线。瞬时访问点击图标面板瞬间弹出数据即刻呈现。这种交互速度远快于打开浏览器并登录多个网站。系统级集成作为原生应用它可以更好地利用macOS的系统特性比如全局键盘快捷键、通知中心等体验更丝滑。从技术实现看为了达到“轻量”和“原生体验”项目没有选择Electron这类跨平台框架虽然能兼容Windows/Linux但体积和内存占用较大而是直接针对macOS进行开发。这确保了应用启动速度快、内存占用低实测常驻内存仅在几十MB级别真正做到了“开箱即用用完即走”的菜单栏应用体验。2.2 插件化架构可扩展性的核心支持众多的AI服务提供商是OpenUsage的核心价值。但每个提供商的API接口、认证方式、数据格式都不同如果每增加一个支持都要重写核心代码那将是一场维护噩梦。OpenUsage的解决方案是插件化Plugin-based架构。这个架构是如何工作的简单来说OpenUsage的核心程序只负责做几件事提供UI框架菜单栏图标和面板、调度数据刷新、管理配置和存储。而具体到每一个AI服务如Claude、Cursor其数据抓取、解析和展示的逻辑都被封装在一个独立的“Provider插件”中。核心程序Core相当于一个容器和调度器。它定义了一套标准的插件接口Plugin API。这套接口规定了插件必须实现的方法比如fetchUsage()获取用量、getConfig()获取配置等。Provider插件每个支持的AI服务都是一个独立的插件模块。插件开发者只需要按照Plugin API的规范实现从该服务获取用量数据的具体逻辑。例如claude-provider插件会知道如何调用Claude的API或模拟网页请求并把它返回的复杂JSON数据转换成OpenUsage核心程序能理解的、统一的“剩余额度/总额度”格式。这种架构带来的好处是巨大的敏捷更新当某个AI服务更新了它的API或网页结构时只需要更新对应的那个插件即可无需动核心代码更不需要用户重新下载整个App。社区驱动正如项目文档所说新的Provider主要依靠社区贡献。任何开发者都可以为自己常用的、但尚未被支持的AI服务编写一个插件并通过Pull Request贡献给项目。这使OpenUsage的生态能够快速成长。灵活性与安全性理论上未来架构开放后用户甚至可以自行编写和加载私有插件用于监控公司内部或特定定制的AI服务而无需等待官方支持。目前插件是与主应用捆绑发布的但作者明确提到了未来将使其更加灵活允许用户动态加载插件。这为工具的未来发展留下了充足的想象空间。2.3 数据流与刷新机制理解了架构我们再看看数据是如何流动的。当你点击菜单栏图标时面板上显示的数据并非每次都实时从网络获取那样会太慢。OpenUsage采用了一种缓存与定时刷新相结合的智能策略。定时后台刷新你可以在设置中配置刷新频率例如每15分钟、30分钟或1小时。应用会在后台按照这个频率自动、静默地调用各个已启用插件的fetchUsage()方法从各AI服务商那里拉取最新的用量数据并更新本地缓存。前端显示缓存当你打开面板时UI会立即显示上一次刷新后缓存在本地的数据保证瞬间响应。手动强制刷新面板上通常会有一个刷新按钮点击后会立即触发一次所有插件的网络请求获取最新数据并更新UI。数据聚合与展示核心程序拿到所有插件返回的标准化数据后进行简单的聚合计算比如总剩余额度占比然后渲染出带有进度条、百分比和剩余天数的可视化面板。这个机制在“数据及时性”和“用户体验流畅性”之间取得了很好的平衡。你既不会因为网络延迟而面对一个加载中的空白面板也能通过定时刷新确保看到的数据不会过于陈旧。3. 详细功能拆解与实操配置说完了设计我们来看看OpenUsage具体能做什么以及怎么把它配置得顺手。我将以最常用的几个Provider为例带你走一遍完整的配置流程。3.1 核心功能一览在深入配置前我们先快速过一遍它的核心功能清单这些功能共同构成了其出色的用户体验一站式概览所有配置好的AI工具用量集中在一个可滚动的面板内每个服务以卡片形式展示包含名称、图标、用量进度条、具体数值如120/500 Credits和重置周期。可视化进度条进度条颜色会根据用量情况变化例如绿色表示充足黄色表示中等红色表示即将用完让你对状态有直觉感知。自动刷新可配置的全局刷新间隔确保数据常新。全局快捷键可以设置一个系统级的快捷键如CmdShiftU来快速显示/隐藏用量面板即使OpenUsage不是当前活动窗口也能调用。本地HTTP API应用在本地启动一个HTTP服务默认端口6736其他脚本或应用可以通过调用http://127.0.0.1:6736/usage这样的接口以JSON格式获取结构化的用量数据。这对于想自己做二次开发或与其它自动化工具如显示在Touch Bar上集成的用户非常有用。代理支持对于需要网络代理才能访问某些AI服务的用户OpenUsage支持配置SOCKS5或HTTP代理确保所有网络请求都能正常进行。3.2 安装与初体验安装过程非常简单对于绝大多数用户推荐直接下载编译好的发行版。下载访问项目的 GitHub Releases页面 找到最新的.dmg文件下载。安装打开下载的.dmg文件将OpenUsage.app拖拽到“应用程序”文件夹中。首次运行与权限从“应用程序”文件夹或Launchpad中启动OpenUsage。首次运行时macOS可能会提示需要“辅助功能”权限。这一步至关重要。OpenUsage需要此权限来模拟点击菜单栏区域以正确放置其图标。请务必在系统提示时点击“打开系统设置”并勾选允许。如果错过了提示可以手动前往系统设置 隐私与安全性 辅助功能中找到并勾选OpenUsage。基础配置启动后菜单栏会出现一个类似条形图的图标。点击图标会弹出主面板。首次使用面板可能是空的因为你还没有添加任何Provider。点击面板底部的Settings或类似配置按钮进入配置页面。注意如果安装后菜单栏没有出现图标或者图标显示异常99%的原因是“辅助功能”权限未开启。请务必检查系统设置。这是macOS上许多菜单栏应用的常见门槛。3.3 配置主流AI服务提供商Provider配置的核心就是为你使用的每个AI服务添加并认证对应的Provider。我们以GitHub Copilot、Claude和Cursor这三个最流行的为例。3.3.1 配置 GitHub CopilotCopilot的用量数据相对容易获取因为它与你的GitHub账户直接绑定。在OpenUsage设置页找到Providers或Add Provider选项。在列表中选择GitHub Copilot。通常配置界面会引导你进行OAuth授权或要求你提供GitHub Personal Access Token (PAT)。推荐使用PAT方式因为它更稳定且可以精细控制权限。你需要前往 GitHub - Settings - Developer settings - Personal access tokens - Tokens (classic)生成一个全新的Token。所需权限在生成Token时至少需要勾选user用于读取用户信息和copilot用于读取Copilot用量范围的权限。具体名称可能略有不同请以OpenUsage插件文档提示为准。将生成的Token粘贴到OpenUsage的配置框中保存。返回主面板稍等片刻或手动刷新你应该就能看到Copilot的用量信息了通常会显示你的订阅类型Premium和剩余天数。3.3.2 配置 Claude (Anthropic)Claude的配置稍微复杂一点因为它没有公开的、简单的“剩余用量”API。OpenUsage的Claude插件通常通过模拟浏览器会话或调用非公开接口来获取数据。在Provider列表中选择Claude。配置项很可能要求你提供Session Cookie。这是因为插件需要伪装成一个已登录的浏览器来访问Anthropic的用户用量页面。如何获取Session Cookie在Chrome或Safari中登录 claude.ai 。打开开发者工具F12切换到Application或存储标签页。在Cookies下找到https://claude.ai。寻找一个名称类似于sessionKey或intercom-session-...的Cookie具体名称可能随时间变化请参考OpenUsage的Claude插件文档。将该Cookie的Value复制出来。将复制的Cookie值粘贴到OpenUsage的Claude配置中。重要警告Session Cookie相当于你的登录凭证具有很高的敏感性。请确保你信任OpenUsage这款开源软件并且只在你的个人电脑上使用。切勿将此Cookie分享给他人。保存后Claude的用量信息就会显示出来通常包括“会话额度”、“周额度”以及“高峰期/非高峰期”的细分使用情况。3.3.3 配置 CursorCursor的用量信息通常通过其官方API获取需要API Key。在Provider列表中选择Cursor。前往Cursor应用的设置Preferences界面通常在Account或Billing部分可以找到生成API Key的选项。复制生成的API Key。将API Key粘贴到OpenUsage的Cursor配置中。保存后你可能会看到诸如“剩余信用点”、“总使用量”、“API用量”等详细信息。3.3.4 通用配置技巧与注意事项逐一测试添加完一个Provider后最好先点击测试或手动刷新确认数据能正确拉取再添加下一个便于排查问题。关注文档每个Provider的配置方法可能更新。当某个Provider无法正常工作时第一件事是去OpenUsage项目Wiki或docs/providers/目录下查看对应Provider的最新文档。令牌与Cookie的安全像API Key、Session Cookie这类敏感信息OpenUsage通常会将其加密后存储在macOS的钥匙串Keychain中这是相对安全的。但出于最佳安全实践建议定期尤其是怀疑有安全风险时在AI服务提供商的后台重置这些令牌。代理配置如果你的网络环境需要代理才能访问某些服务如Claude记得在OpenUsage的Settings - Network或Proxy部分配置代理服务器地址和端口。支持SOCKS5和HTTP代理这能解决大部分网络连通性问题。3.4 高级功能本地HTTP API与自动化集成这是OpenUsage一个非常强大但容易被忽略的功能。它开启了一个自动化集成的可能性。3.4.1 什么是本地HTTP APIOpenUsage在启动后会在你的电脑本地127.0.0.1开启一个HTTP服务默认端口是6736。这个服务提供了简单的RESTful接口让你可以通过HTTP请求获取当前的所有用量数据。3.4.2 如何使用最简单的方法就是用curl命令在终端里测试curl http://127.0.0.1:6736/usage执行后你会得到一个JSON格式的响应里面包含了所有已配置Provider的用量详情。数据是结构化的例如{ timestamp: 2023-10-27T08:00:00Z, providers: [ { name: GitHub Copilot, type: copilot, usage: { total: 30, used: 12, remaining: 18, unit: days, reset_date: 2023-11-27 } }, { name: Claude, type: claude, usage: { session: {total: 100, used: 35, remaining: 65}, weekly: {total: 500, used: 150, remaining: 350} } } ] }3.4.3 自动化集成场景示例有了这个API你可以玩出很多花样状态栏脚本使用Shell脚本如通过curl获取数据并解析或Python脚本将用量信息显示在iTerm2的状态栏、tmux的状态行或者用sketchybar、SwiftBar等更强大的菜单栏定制工具创建更个性化的展示。通知提醒写一个定时任务Cron job或LaunchAgent每隔一段时间检查API返回的数据。当某个服务的剩余额度低于你设定的阈值比如少于10%时自动发送一个系统通知可以使用osascript命令提醒你。# 一个简单的Shell脚本示例检查Copilot剩余天数小于5则报警 REMAINING$(curl -s http://127.0.0.1:6736/usage | jq .providers[] | select(.typecopilot) | .usage.remaining) if [ $REMAINING -lt 5 ]; then osascript -e display notification Copilot仅剩$REMAINING天 with title AI用量警报 fi需要先安装jq工具来解析JSON数据记录与分析将每天的用量数据抓取下来存入本地数据库如SQLite或CSV文件。长期积累后你可以分析自己在不同AI工具上的使用趋势和消费习惯为优化订阅策略提供数据支持。与其它应用联动如果你使用Obsidian、Notion等笔记软件可以通过其API或插件将用量信息自动插入到你的每日工作日志中。这个本地API将OpenUsage从一个单纯的查看工具变成了一个数据源为你的个性化工作流自动化提供了基石。4. 常见问题排查与使用心得即使设计得再完善在实际使用中也可能遇到各种问题。下面是我在长期使用中总结的一些常见坑点和解决方案。4.1 问题排查清单问题现象可能原因解决方案菜单栏不显示图标1. 辅助功能权限未开启。2. 应用启动失败。1. 检查系统设置 隐私与安全性 辅助功能。2. 尝试重启应用或查看系统控制台Console日志。某个Provider显示“Error”或“No Data”1. 认证信息失效Token过期、Cookie失效。2. 提供商API或网页结构已更新。3. 网络问题特别是需要代理的服务。1. 重新获取并更新Token/Cookie。2. 查看该Provider的GitHub Issue看是否有已知问题。3. 检查OpenUsage的代理设置并尝试手动在浏览器中访问该服务商网站确认网络连通性。数据刷新不及时1. 自动刷新间隔设置过长。2. 后台刷新进程被系统休眠中断。1. 在设置中缩短刷新间隔如改为15分钟。2. 尝试手动点击面板上的刷新按钮。macOS的App Nap机制可能影响但通常问题不大。应用意外退出或卡死1. 与特定Provider插件冲突。2. 内存或资源异常。1. 尝试在设置中暂时禁用最近添加的Provider看是否恢复稳定。2. 重启应用。如果频繁发生向GitHub仓库提交Issue附上系统日志。本地HTTP API无法访问1. OpenUsage未运行。2. 防火墙阻止了端口6736。3. 应用配置中禁用了API功能。1. 确保OpenUsage正在运行。2. 检查macOS防火墙设置通常默认允许本地连接。3. 检查设置中是否开启了“Enable Local HTTP API”选项。4.2 安全使用心得敏感信息管理虽然OpenUsage使用钥匙串但良好的习惯是只为这些AI服务创建具有最小必要权限的令牌Token。例如GitHub Token只给read:user和copilot权限不要给不必要的repo或write权限。定期轮换凭证对于像Claude的Session Cookie这类高敏感凭证建议每1-2个月在Claude网站上退出登录再重新登录然后在OpenUsage中更新Cookie。这可以降低凭证泄露带来的长期风险。关注项目动态作为开源项目关注其GitHub仓库的Release和Security Advisories。及时更新到新版本可以获取安全修复和新功能。4.3 性能与资源优化OpenUsage本身非常轻量但如果你配置了非常多的Provider比如十几个并且刷新间隔设置得很短如5分钟可能会带来一些不必要的网络请求和电量消耗。按需启用只启用你真正在付费或经常使用的AI服务。不常用的可以暂时在设置中禁用需要时再打开。合理设置刷新频率对于用量变化不频繁的服务如按月重置的Copilot可以将刷新间隔设置为6小时甚至12小时。对于按周或按会话重置的服务如Claude可以设置为1-2小时。找到一个平衡点。监控网络请求如果你发现电脑风扇无故狂转或网络活动异常可以使用活动监视器Activity Monitor的网络标签页或类似Little Snitch的防火墙工具查看OpenUsage是否在频繁发起连接。这有助于识别某个配置错误的Provider在疯狂重试。5. 社区参与与未来展望OpenUsage的成功很大程度上归功于其活跃的社区。正如其文档所言这是一个“社区驱动”的项目。如何参与贡献提交问题Issue如果你发现某个Provider不能用了或者有一个新的AI工具希望被支持最好的方式是在GitHub仓库上提交一个清晰的Issue。描述问题现象、期望行为并附上相关的日志或截图。贡献代码Pull Request如果你有开发能力贡献代码是更直接的方式。最常见的贡献就是编写新的Provider插件。项目提供了详细的 插件开发指南 。通常你需要研究目标AI服务的网页或API编写一个能获取用量数据的类并实现标准的插件接口。一个结构良好、带有测试的PR很容易被合并。改进文档文档的清晰度对开源项目至关重要。如果你在配置过程中发现文档有歧义、过时或缺失可以提交PR修正或补充文档。我对未来版本的期待从目前的开发路线和社区讨论来看有几个方向值得期待动态插件加载实现真正的“即插即用”用户可以从一个插件市场下载和安装Provider无需等待应用整体更新。更丰富的数据可视化除了简单的进度条未来或许可以集成微型图表展示过去一段时间内的用量趋势。跨平台支持虽然目前专注于macOS体验但社区对Windows和Linux版本的需求一直存在。如果核心代码足够解耦未来或许会出现社区维护的跨平台版本。用量预测与建议基于历史使用数据预测额度何时耗尽并给出调整使用习惯或升级订阅的建议。最后一点个人体会使用OpenUsage大半年它已经成了我开发环境里一个“沉默的伙伴”。它不会主动打扰我但当我需要时信息就在那里。它解决的不是一个技术难题而是一个体验上的痒点——那种对分散信息的掌控焦虑。这个项目的意义也在于此它展示了优秀的工具软件如何通过聚焦一个微小但普遍的需求并通过优雅的设计和开放的生态将其做到极致。更重要的是它本身作为“完全由AI构建”的案例也为我们思考AI在软件开发中的角色提供了有趣的参考。如果你也在管理多个AI订阅不妨试试它或许你也会和我一样再也回不去那个需要打开无数个网页标签来查用量的时代了。