Quotio

macOS 上 AI 编程助手的终极控制中心。

Quotio 是一款原生 macOS 应用程序，用于管理 CLIProxyAPI —— 一个为您的 AI 编程代理提供支持的本地代理服务器。它可以帮助您在一个地方管理多个 AI 账户、跟踪配额并配置 CLI 工具。

✨ 功能

• 🔌 多提供商支持：通过 OAuth 或 API 密钥连接 Gemini、Claude、OpenAI Codex、Qwen、Vertex AI、iFlow、Antigravity、Kiro、Trae 和 GitHub Copilot 等账户。
• 📊 独立配额模式：无需运行代理服务器即可查看配额和账户信息——非常适合快速检查。
• 🚀 一键配置 AI 代理：自动检测并配置 Claude Code、OpenCode、Gemini CLI 等 AI 编程工具。
• 📈 实时仪表板：实时监控请求流量、令牌使用情况和成功率。
• 📉 智能配额管理：按账户可视化配额跟踪，并提供自动故障转移策略（轮询 / 先填）。
• 🔑 API 密钥管理：为您的本地代理生成和管理 API 密钥。
• 🖥️ 菜单栏集成：从菜单栏快速访问服务器状态、配额概览和自定义提供商图标。
• 🔔 通知：当配额不足、账户冷却期或服务出现问题时发出警报。
• 🔄 自动更新：内置 Sparkle 更新程序，实现无缝更新。
• 🌍 多语言支持：支持英语、越南语和简体中文。

🤖 支持的生态系统

AI 提供商

提供商	认证方式
Google Gemini	OAuth
Anthropic Claude	OAuth
OpenAI Codex	OAuth
Qwen Code	OAuth
Vertex AI	服务账号 JSON
iFlow	OAuth
Antigravity	OAuth
Kiro	OAuth
GitHub Copilot	OAuth

IDE 配额跟踪（仅监控）

IDE	描述
Cursor	安装并登录后自动检测
Trae	安装并登录后自动检测

注意：这些 IDE 仅用于配额使用情况的监控，不能作为代理的提供商使用。

兼容的 CLI 代理

Quotio 可以自动配置以下工具使用您的集中式代理：

• Claude Code
• Codex CLI
• Gemini CLI
• Amp CLI
• OpenCode
• Factory Droid

🚀 安装

要求

• macOS 14.0 (Sonoma) 或更高版本
• 用于 OAuth 认证的互联网连接

Homebrew（推荐）

brew tap nguyenphutrong/tap
brew install --cask quotio

下载

从 Releases 页面下载最新的 .dmg 文件。

⚠️ 注意：该应用目前尚未使用 Apple 开发者证书签名。如果 macOS 阻止了该应用，请运行：

xattr -cr /Applications/Quotio.app

从源代码构建

1. 克隆仓库：

   git clone https://github.com/nguyenphutrong/quotio.git
   cd Quotio
   

2. 在 Xcode 中打开：

   open Quotio.xcodeproj
   

3. 构建并运行：

   • 选择“Quotio”方案
   • 按 Cmd + R 构建并运行

应用程序将在首次启动时自动下载 CLIProxyAPI 二进制文件。

📖 使用方法

1. 启动服务器

启动 Quotio 并点击仪表板上的“开始”按钮，以初始化本地代理服务器。

2. 连接账户

转到“提供商”选项卡 → 单击某个提供商 → 通过 OAuth 进行认证或导入凭据。

3. 配置代理

转到“代理”选项卡 → 选择已安装的代理 → 单击“配置” → 选择自动或手动模式。

4. 监控使用情况

• 仪表板：整体健康状况和流量
• 配额：按账户细分的使用情况
• 日志：原始请求/响应日志，用于调试

⚙️ 设置

• 端口：更改代理监听端口
• 路由策略：轮询或先填
• 自动启动：在 Quotio 打开时自动启动代理
• 通知：开启或关闭各类事件的提醒

📸 截图

仪表板

提供商

代理设置

配额监控

故障转移配置

API 密钥

日志

设置

菜单栏

🤝 参与贡献

1. 复刻项目
2. 创建你的功能分支 (git checkout -b feature/amazing-feature)
3. 提交你的更改 (git commit -m '添加超赞功能')
4. 推送到该分支 (git push origin feature/amazing-feature)
5. 打开一个拉取请求

💬 社区

加入我们的 Discord 社区，获取帮助、分享反馈并与其他用户交流：

⭐ 星标历史

📊 仓库活动

💖 贡献者

没有你们，我们不可能完成这一切。感谢有你！🙏

📄 许可证

MIT 许可证。详情请参阅 LICENSE 文件。

Quotio 快速上手指南

Quotio 是一款专为 macOS 设计的原生应用，作为您 AI 编程助手的“指挥中心”。它通过本地代理服务器（CLIProxyAPI）统一管理多个 AI 账号（如 Claude、Gemini、Copilot 等），提供配额监控、智能故障转移及 CLI 工具的一键配置。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：macOS 14.0 (Sonoma) 或更高版本。
• 网络连接：需要互联网连接以进行 OAuth 认证。
• 前置依赖：
  • 推荐安装 Homebrew 包管理器。
  • 若需从源码构建，需安装 Xcode。

注意：目前该应用尚未使用 Apple Developer 证书签名。如果在打开时遇到 macOS 拦截提示，需在终端执行以下命令解除限制：

xattr -cr /Applications/Quotio.app

安装步骤

推荐使用 Homebrew 进行安装，也可选择手动下载或通过源码构建。

方式一：Homebrew 安装（推荐）

brew tap nguyenphutrong/tap
brew install --cask quotio

方式二：手动下载

访问 Releases 页面 下载最新的 .dmg 文件，拖拽至应用程序文件夹即可。

方式三：从源码构建

# 1. 克隆仓库
git clone https://github.com/nguyenphutrong/quotio.git
cd Quotio

# 2. 在 Xcode 中打开项目
open Quotio.xcodeproj

# 3. 在 Xcode 中选择 "Quotio" Scheme，按下 Cmd + R 编译并运行
# 首次启动时会自动下载 CLIProxyAPI 二进制文件

基本使用

安装完成后，按照以下步骤快速配置并开始使用：

1. 启动代理服务

打开 Quotio 应用，在主仪表盘（Dashboard）点击 Start 按钮，初始化本地代理服务器。

2. 连接 AI 账号

• 切换到 Providers 标签页。
• 选择您需要使用的服务商（如 Google Gemini, Anthropic Claude, GitHub Copilot 等）。
• 点击对应图标，通过 OAuth 登录或导入 API Key/凭证。
• 提示：支持同时管理多个账号，系统将自动追踪各账号的配额使用情况。

3. 配置 AI 编程助手

• 切换到 Agents 标签页。
• 选择已安装的 CLI 工具（如 Claude Code, Codex CLI, Gemini CLI, OpenCode 等）。
• 点击 Configure，选择 Automatic（自动模式）让 Quotio 自动注入代理配置，或选择 Manual 手动设置。

4. 监控与运行

• 实时监控：在 Dashboard 查看实时请求流量、Token 消耗及成功率。
• 配额管理：在 Quota 页面查看每个账号的详细用量，系统支持“轮询（Round Robin）”或“优先填满（Fill First）”策略，当某账号配额耗尽时自动切换至备用账号。
• 菜单栏快捷操作：Quotio 会驻留在 macOS 菜单栏，您可随时查看服务状态、配额概览或快速切换提供商。

现在，您可以在终端直接使用配置好的 AI CLI 工具，所有请求将通过 Quotio 统一调度和管理。