nguyenphutrong/quotio

Quotio – macOS 上的 AI 代码助手指挥中心

是什么 – 用 Swift 编写的原生 macOS 应用，可运行并控制名为 CLIProxyAPI 的本地代理服务器。该代理将来自命令行 AI 代码工具（如 Claude Code、Codex CLI、OpenCode）的请求路由到单一入口点，您可在该点管理多个 AI 提供商账户、监控令牌配额，并自动切换提供商。

为何重要 – 当您使用多个 AI 驱动的代码生成器（如 OpenAI Codex、Anthropic Claude 等）时，通常需要分别管理 API 密钥、监控使用限制，并手动配置每个 CLI 工具。Quotio 将所有这些集中管理：

• 一处添加多个提供商的 OAuth 或 API 密钥凭证。
• 实时仪表板，显示流量、令牌消耗和成功率。
• 当某个提供商的配额不足时，自动故障转移（轮询或填满优先）。
• 菜单栏状态、通知以及基于 Sparkle 的自动更新。

主要功能

• 多提供商支持 – Claude、OpenAI Codex、Qwen、Vertex AI、iFlow、Antigravity、Kiro、GitHub Copilot。
• 独立配额视图 – 无需启动代理即可查看使用情况。
• 一键代理配置 – 自动检测已安装的 CLI 代理并为您写入代理设置。
• 实时仪表板 – 流量、令牌使用量、成功率图表。
• 智能配额管理 – 每账户可视化追踪，自动路由策略。
• API 密钥管理器 – 为本地代理生成并存储密钥。
• 菜单栏集成与通知 – 快速查看服务器健康状态和低配额警报。
• 自动更新 – 内置 Sparkle 更新器。
• 多语言 UI – 英语、越南语、简体中文。

支持的生态系统

• 提供商 – 上述列表中的 OAuth 或服务账户 JSON 认证。
• IDE 配额监控 – Cursor、Trae（只读监控）。
• CLI 代理 – Claude Code、Codex CLI、Amp CLI、OpenCode、Factory Droid（自动配置为使用代理）。

安装

1. Homebrew（推荐）

   brew tap nguyenphutrong/tap
   brew install --cask quotio
   

2. 直接下载 – 从 GitHub Releases 页面获取最新 .dmg 文件。
3. 从源码构建 – 克隆仓库，用 Xcode 打开 Quotio.xcodeproj，运行 Quotio 方案。
   • 应用首次启动时会下载 CLIProxyAPI 二进制文件。
   • macOS 可能会阻止未签名的应用；运行 xattr -cr /Applications/Quotio.app 以允许其运行。

基本工作流程

1. 启动服务器 – 在仪表板上点击 Start。
2. 添加账户 – 在 Providers 选项卡中，通过 OAuth 认证或粘贴 API 密钥。
3. 配置代理 – 在 Agents 选项卡中，选择已安装的 CLI 工具并点击 Configure（自动或手动模式）。
4. 监控 – 使用 Dashboard、Quota 和 Logs 面板监控流量、令牌使用情况并调试请求。
5. 调整设置 – 在 Settings 中更改监听端口、路由策略、自动启动行为和通知偏好。

社区与贡献

• 请加入 README 中的 Discord 服务器以获取帮助和反馈。
• Fork 仓库，创建功能分支，提交、推送并提交 PR 以贡献代码。

许可证 – MIT（参见 LICENSE）。

---

Quotio 是为依赖多个 AI 代码生成服务的开发者设计的实用工具，可在 macOS 上通过单一可视化界面管理凭证、配额和代理路由。