README.zh.md

Quotio

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

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

🌟 Sponsors

Featured Sponsor

Thanks to PatewayAI for sponsoring this project! PatewayAI specializes in high-quality official model API relay services. It fully supports Claude and GPT series, with transparent billing and enterprise-grade services. Our Economy Mode offers discounts as low as 5% off! Sign up via this link to receive trial credits. You can also join occasional promotions to claim free credits. The two-way referral reward is up to $150.

Standard Sponsors

	Power your AI-powered workflows with Swiftproxy, a residential proxy provider offering rotating and static residential proxies for reliable web access and data collection. Access 90M+ residential IPs across 220+ locations, with HTTP(S), SOCKS5, and flexible rotating and sticky sessions. Try it for free and get started with residential proxies from just $0.7/GB. Use code PROXY90 for an additional 10% off. Explore Swiftproxy →
	感谢 88API Token聚合平台赞助了本项目！88API 是一家由香港企业运营并且主要面向开发者、创作者与 AI 应用用户的一站式多模型 API 平台，通过统一接口接入文本、图片、语音和视频模型，覆盖 AI 编程、智能翻译、内容创作、配音、图像生成、视频生成等常见工作流。可以直接在 CC Switch 中完成 Provider 添加并切换，支持国际主流付款方式，可提供发票，提供企业级稳定服务。通过此链接注册可以获取专属赠送额度！ Explore 88API →
	Proxy-Seller gives you reliable proxy infrastructure for any workflow: private residential, mobile (4G/5G/LTE), ISP, and datacenter IPv4/IPv6 proxies, all with HTTP(S) and SOCKS5 support. Tap into 47M+ residential IPs across 220+ locations, target exactly the country, city, or ISP you need, and count on 99.7% uptime backed by 24/7 support. Quotio users get 15% off with promo code QUOTIO. Explore Proxy-Seller →
	x6.ai: One API key for every major model. Official-key and proxy channels, up to 90% off, free credits on sign-up. Pay with Alipay, Google Pay, Apple Pay, Visa or Mastercard. Explore x6.ai →

Interested in sponsoring Quotio? Contact quotio@bytrong.app.

✨ 功能特性

• 🔌 多提供商支持：通过 OAuth 或 API Key 连接 Claude、OpenAI Codex、Qwen、Vertex AI、iFlow、Antigravity、Kiro、Trae 和 GitHub Copilot 账号。
• 📊 独立配额模式：无需运行代理服务器即可查看配额和账号，适合快速检查。
• 🚀 一键 Agent 配置：自动检测并配置 Claude Code、OpenCode 等 AI 编程工具。
• 📈 实时仪表盘：实时监控请求流量、token 使用量和成功率。
• 📉 智能配额管理：按账号可视化配额追踪，并支持自动故障转移策略（轮询 / 先满）。
• 🔑 API Key 管理：为本地代理生成并管理 API Key。
• 🖥️ 菜单栏集成：在菜单栏快速查看服务器状态、配额概览和自定义提供商图标。
• 🔔 通知提醒：当配额不足、账号冷却或服务异常时推送提醒。
• 🔄 自动更新：内置 Sparkle 更新器，平滑升级。
• 🌍 多语言支持：英文、越南语和简体中文。

🤖 支持的生态

AI 提供商

提供商	认证方式
Anthropic Claude	OAuth
OpenAI Codex	OAuth
Qwen Code	OAuth
Vertex AI	Service Account JSON
iFlow	OAuth
Antigravity	OAuth
Kiro	OAuth
GitHub Copilot	OAuth（监控模式下支持 GitHub.com 或数据驻留的 GHE.com 主机）

IDE 配额追踪（仅监控）

IDE	说明
Cursor	安装并登录后自动检测
Trae	安装并登录后自动检测

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

兼容的 CLI Agent

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

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

🚀 安装

系统要求

• macOS 14.0（Sonoma）或更高版本
• OAuth 认证需要互联网连接

Homebrew（推荐）

brew tap nguyenphutrong/tap
brew install --cask quotio

下载

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

官方发布包使用 Developer ID 签名并经过 Apple 公证，无需绕过 Gatekeeper。

从源码构建

1. 克隆仓库：

   git clone https://github.com/nguyenphutrong/quotio.git
   cd quotio/apps/macos

2. 在 Xcode 中打开：

   open Quotio.xcodeproj

3. 构建并运行：

   • 选择 “Quotio” scheme
   • 按下 Cmd + R 构建并运行

应用首次启动时会自动下载 CLIProxyAPI 二进制文件。

📖 使用方法

1. 启动服务器

打开 Quotio，在仪表盘点击 Start 初始化本地代理服务器。

2. 连接账号

进入 Providers 标签页 → 点击一个提供商 → 通过 OAuth 认证或导入凭据。

3. 配置 Agent

进入 Agents 标签页 → 选择已安装的 Agent → 点击 Configure → 选择自动或手动模式。

4. 监控使用情况

• Dashboard：整体健康状态与流量
• Quota：按账号查看使用情况
• Logs：用于调试的原始请求/响应日志

⚙️ 设置

• 端口：更改代理监听端口
• 路由策略：轮询（Round Robin）或先满（Fill First）
• 自动启动：Quotio 打开时自动启动代理
• 通知：开关各类提醒

📸 截图

仪表盘

提供商

Agent 配置

配额监控

API 密钥

设置

菜单栏

🤝 贡献

1. Fork 本项目
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交修改（git commit -m 'Add amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 创建 Pull Request

💖 贡献者

没有你们，我们无法做到这一切。感谢！🙏

📄 许可证

MIT License。详见 LICENSE。