开源AIUsage聚合多平台AI用量监控，支持Claude Code一键接入

背景

在当前的 AI 开发与应用生态中，开发者往往同时使用多个 AI 平台（如 OpenAI、Anthropic、Google 等）以及多种客户端工具（如 Claude Code、Codex、Cursor 等）。这种多平台、多客户端的使用习惯带来了两个主要痛点：一是各平台配额与用量的分散，导致用户难以直观掌握整体消耗情况；二是不同客户端对 API 接口的兼容性差异，特别是像 Claude Code 这类主要面向 Anthropic 模型优化的工具，难以直接无缝接入其他 OpenAI 兼容的代理节点。

在此背景下，LINUX DO 社区用户开源了一款名为 AIUsage 的原生 macOS 客户端应用。该项目旨在聚合主流 AI 平台的配额与用量监控，并解决跨平台 API 连接的兼容性问题。作为一个开源项目，AIUsage 不仅提供了可视化的仪表盘来追踪 Token 用量和费用，还通过内置代理机制实现了不同模型间的灵活切换，为开发者提供了一站式的 AI 资源管理解决方案。

核心内容

AIUsage 是一个专注于 macOS 平台的原生应用，主要功能涵盖 AI 服务用量监控、多账号管理以及 API 代理转换。其核心能力随着版本的迭代不断演进，具体功能演进如下：

1. 广泛的客户端支持与用量监控 AIUsage 目前支持监控多种主流 AI 客户端的用量，包括 Codex、Copilot、Cursor、Antigravity、Kiro、Warp、Gemini CLI、Amp 和 Droid。此外，它还支持本地 Claude Code 的费用统计。通过本地数据抓取，用户可以对比中转站的费用统计是否存在偏差，确保计费透明。

2. Claude Code 代理与模型映射（核心亮点） 针对 Claude Code 等客户端通常仅支持 Anthropic 原生模型的限制，AIUsage 引入了强大的代理机制：

• 代理透传与别名映射：在 0.6.2 版本中，新增了模型别名映射开关。开启后，客户端发送的 Opus、Sonnet、Haiku 等别名会自动替换为节点配置的模型槽位名称。这一机制允许用户通过 Claude Code 接入 DeepSeek、GPT-5.4 等任意 OpenAI 兼容模型，甚至支持 Anthropic 格式的 API 透明代理。
• 路由拦截与自动修复：在 0.5.5 版本中，引入了路由拦截器，专门用于自动修正 Claude Code SubAgent 的 thinking 字段异常（如缺失、null 或 disabled），从而消除第三方网关可能产生的 500 错误。这使得用户在使用 any 路由时，能够顺利调用 SubAgent 和 Haiku 模型，且无需进行额外的后端配置。

3. 可视化仪表盘与配置管理

• 界面重构：0.5.0 版本重构了仪表盘页面，提供了可视化的 Settings 编辑界面。用户可通过表单编辑 model、环境变量（env）、权限规则（permissions）、hooks 及高级设置。
• 配置迁移：配置信息迁移至独立的 JSON 文件（位于 ~/.config/aiusage/profiles/），支持便携迁移和分享。
• 双向同步：可视化编辑与 JSON 底层配置保持双向同步，支持 JSON 一键格式化和校验。

4. 系统级集成与用户体验优化

• 内置 HTTPS 支持：0.6.2 版本新增代理节点 HTTPS 监听功能，无需依赖 Caddy 等外部工具。首次启用时，应用会自动生成本地 CA 证书链并安装到 System Keychain（macOS 标准密码弹窗授权，一次性操作）。
• 菜单栏集成：从 0.4.0 版本开始，重构了 Mac 顶部菜单栏显示风格。支持显示多账号图标、自定义指标（如配额百分比、费用），并支持多模型账号（如 Antigravity）的折叠/展开显示。
• 账号管理：支持一键切换顶部显示的账号，以及 Claude Code 代理的切换。同时修复了 CodeX 账号凭证重启后失效的问题，并优化了 OpenAI 代理的 Token 和费用记录偏差。

关键要点

• 开源合规性：该项目在 LINUX DO 社区发布，已打上“开源推广”标签，声明项目完整开源无隐藏部分，并遵循社区监督。
• 跨平台 API 兼容：通过内置代理和别名映射，打破了 Claude Code 等客户端对特定模型供应商的限制，实现了 OpenAI 兼容模型与 Anthropic 客户端的互通。
• 自动化错误处理：内置的路由拦截器能自动修复 SubAgent 的 thinking 字段异常，解决了第三方网关常见的 500 错误，提升了稳定性。
• 原生 macOS 体验：作为原生应用，深度集成 macOS 系统特性，包括 System Keychain 证书管理、菜单栏状态显示及本地数据监控。
• 配置可视化与便携性：提供可视化的表单编辑界面，同时支持 JSON 配置文件的直接编辑和迁移，兼顾新手友好与高级用户的灵活性。
• 多客户端覆盖：目前支持监控 Codex、Copilot、Cursor、Gemini CLI 等 9 种主流 AI 客户端，填补了部分现有监控工具（如 quotio、codexbar）的功能空白。

意义与影响

AIUsage 的出现反映了 AI 开发工具链日益复杂化背景下，用户对“统一管控”和“灵活接入”的迫切需求。

首先，它解决了工具链碎片化的问题。开发者无需在多个监控软件之间切换，也无需手动配置复杂的代理规则，AIUsage 通过原生集成和自动化处理，降低了多平台管理的门槛。

其次，它在模型互操作性上做出了创新尝试。通过别名映射和路由拦截技术，AIUsage 使得用户能够以较低的迁移成本，将 Claude Code 等优质客户端接入更广泛的经济型或高性能 OpenAI 兼容模型池（如 DeepSeek、GPT-5.4 等），这在当前 API 价格波动和模型迭代迅速的背景下，为用户提供了极大的灵活性和成本优化空间。

最后，该项目的开源性质促进了社区的技术交流。通过提供可视化的配置工具和详细的错误修复机制，AIUsage 不仅是一个监控工具，更成为了一个学习和参考 AI 代理配置、证书管理及前端数据可视化的优秀案例，有助于提升整个开发者社区的技术水平。