router-for-me/CLIProxyAPI

Wrap Antigravity, ChatGPT Codex, Claude Code, Grok Build, Muse Code, Devin as an OpenAI/Gemini/Claude/Codex compatible API service, allowing you to enjoy the free Gemini Series, GPT Series, Grok Series, Claude model through API

CLI Proxy API – 它是什麼

CLI Proxy API 是一個自託管的代理伺服器，將 OpenAI 風格的 HTTP API 轉換為針對各種大型語言模型提供商（OpenAI、Google Gemini、Anthropic Claude、xAI Grok、Kimi 等）的呼叫。透過在本地執行此代理，您可以繼續使用任何預期 api.openai.com 端點的現有 CLI 工具、SDK 或編輯器擴充功能，同時代理會將請求轉發給真實提供商、處理身份驗證（OAuth 或 API keys），並可在多個帳號之間平衡流量。

核心功能 (如 README 所述)

多提供商相容性 – 為 OpenAI、Gemini、Claude、Grok、Kimi 等提供 OpenAI 相容端點。
OAuth 與 API-key 登入 – 支援各提供商的原生登入流程，因此您無需向工具暴露原始金鑰。
負載平衡與輪詢 (Round-robin) – 您可以為每個提供商設定多個帳號，代理會自動分配請求。
串流、非串流與 WebSocket – 傳遞上游模型支援的所有回應模式。
函式呼叫 / 工具使用 – 轉發函式呼叫負載，使依賴 OpenAI 函式呼叫的工具無需修改即可運作。
多模態輸入 – 在上游模型允許的情況下，接受文字與影像負載。
管理 API – 獨立的文件檔案 (MANAGEMENT_API.md) 描述了用於檢查與控制代理的 HTTP API。
Go SDK – 可重複使用的 Go 函式庫 (docs/sdk-*.md) 讓開發者能將代理邏輯直接嵌入自己的 Go 程式中。
可選的使用量追蹤服務 – 本專案未內建統計功能，但建議使用第三方輔助工具如 CPA Usage Keeper 或 CPA-Manager-Plus 進行日誌記錄、成本估算與儀表板顯示。

典型工作流程

安裝代理（或配套的桌面客戶端 EasyCLIProxyAPI 以取得 UI）。
設定 config.yaml 中的一個或多個提供商帳號（提供 OAuth 登入 URL）。
執行代理；它會在本地連接埠（例如 http://127.0.0.1:8000）監聽。
將任何 OpenAI 相容的 CLI 工具（例如 curl、openai-cli、VS Code 擴充功能）指向該本地位址，而非官方端點。
代理會轉發請求、在帳號間進行負載平衡，並回傳未經修改的回應。

生態系統與重要整合

桌面客戶端 – EasyCLIProxyAPI（圖形介面、系統匣圖示、自動更新）以及多個社群建構的系統匣/TUI 應用程式。
管理儀表板 – 使用 Next.js/React 建構的網頁面板、VS Code 擴充功能以及輕量級 PowerShell 系統匣工具。
第三方工具 – 如 vibeproxy、Subtitle Translator、Claude Proxy VSCode、ZeroLimit 等專案皆依賴此代理來統一 AI 訂閱，而無需直接處理 API 金鑰。
中繼服務 – README 列出了許多贊助的 API 中繼提供商（PackyCode、AICodeMirror 等），提供折扣存取權；代理可透過「OpenRouter 風格」的上游設定指向其中任何一個。

誰適合使用？

開發者：擁有多個付費 LLM 訂閱，並希望為所有 CLI 工具使用單一本地端點的人。
工具作者：不希望嵌入特定提供商 SDK 的人；他們可以發布通用的 OpenAI 相容客戶端，讓使用者執行代理。
團隊：需要跨提供商進行配額追蹤、自動故障轉移或成本估算的人。
進階使用者：希望嘗試較新模型（例如 GPT-5.6、Claude Fable、Gemini 3.5 Flash）而無需重寫現有指令稿的人。

入門與文件

快速入門指南 – https://help.router-for.me/
管理 API 規範 – MANAGEMENT_API.md（託管於同一個說明網站）。
SDK 文件 – docs/ 下的多個 Markdown 檔案，涵蓋基本用法、進階執行器、自訂提供商與監控元件。
社群範例 – examples/custom-provider 資料夾展示了如何新增上游服務。

授權與貢獻

本儲存庫透過標準的 fork-and-pull-request 工作流程邀請貢獻。未提及特殊 CLA；貢獻者被要求遵循一般的 GitHub 流程。

總結

CLI Proxy API 是一個真正的開源工具，位於本地命令列工具與一系列商業 LLM API 之間，將它們標準化為熟悉的 OpenAI HTTP 架構，同時增加了多帳號負載平衡、OAuth 處理與可選的監控功能。它明確定位於 AI 基礎設施領域，對於任何希望將不同模型提供商視為單一、可互換後端的使用者都非常有用。