nguyenphutrong/quotio

Quotio – macOS 用 AI 程式助手指揮中心

是什麼 – 使用 Swift 編寫的原生 macOS 應用程式，可執行並控制名為 CLIProxyAPI 的本地代理伺服器。此代理將來自命令列 AI 程式工具（例如 Claude Code、Codex CLI、OpenCode）的請求路由至單一入口點，您可在該點管理多個 AI 提供商帳戶、監控 Token 配額，並自動切換提供者。

為何重要 – 當您使用多個 AI 驅動的程式生成器（如 OpenAI Codex、Anthropic Claude 等）時，通常需要分別管理 API 金鑰、監控使用限制，並手動設定每個 CLI 工具。Quotio 將所有這些集中管理：

• 一個地方即可新增多個提供者之 OAuth 或 API 金鑰憑證。
• 即時儀表板，顯示流量、Token 消耗與成功率。
• 當提供者的配額不足時，自動故障轉移（Round-Robin 或 Fill-First）。
• 菜單列狀態、通知以及基於 Sparkle 的自動更新。

主要功能

• 多提供者支援 – Claude、OpenAI Codex、Qwen、Vertex AI、iFlow、Antigravity、Kiro、GitHub Copilot。
• 獨立配額檢視 – 無需啟動代理即可查看使用狀況。
• 一鍵代理設定 – 自動偵測已安裝的 CLI 代理並為您寫入代理設定。
• 即時儀表板 – 流量、Token 使用量、成功率圖表。
• 智慧配額管理 – 各帳戶視覺化追蹤，自動路由策略。
• 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 面板監控流量、Token 使用狀況並除錯請求。
5. 調整設定 – 在 Settings 中變更監聽埠、路由策略、自動啟動行為與通知偏好。

社群與貢獻

• 請加入 README 中的 Discord 伺服器以取得協助與回饋。
• Fork 倉儲，建立功能分支，提交、推送並開立 PR 以貢獻程式碼。

授權 – MIT（參見 LICENSE）。

---

Quotio 是為依賴多個 AI 程式生成服務的開發者設計的實用工具，可在 macOS 上透過單一視覺化介面管理憑證、配額與代理路由。