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 是一个自托管代理服务器,让您可以使用命令行工具和 SDK 所期望的相同 OpenAI 兼容 HTTP 端点,与许多大型语言模型提供商(OpenAI、Google Gemini、Anthropic Claude、xAI Grok、Meta Muse、Kimi 等)通信。换句话说,您将常用的 openai 风格客户端指向代理,代理会将请求转发到您配置的真实提供商,处理身份验证、跨多个账户的负载均衡,并转换任何提供商特定的差异。
该项目还附带一个 Go SDK,让其他程序可以直接嵌入代理逻辑,以及一组可选的管理控制台(CPA‑Manager‑Plus、Oh‑My‑CPA 等),用于监控使用量、成本和账户健康状态。
谁可能需要它?
- 拥有多个 AI 订阅的开发人员 – 如果您有 ChatGPT‑plus 账户、Gemini Pro 密钥、Claude Code 订阅等,您可以配置代理自动轮换它们,避免速率限制,并为每个请求获取最便宜的模型。
- 工具作者 – 任何期望 OpenAI 风格端点的 CLI 或 IDE 插件,都可以在无需修改代码的情况下使用任何受支持的模型。
- 想要本地控制的团队 – 代理在您自己的机器(或服务器)上运行,因此您可以将 API 密钥保留在内部,并添加自定义日志记录、缓存或成本跟踪。
核心功能(根据 README 所述)
| 功能 | 作用 |
|---|---|
| 多提供商兼容性 | 为多种模型(Kimi K3、OpenAI GPT‑6 系列、Claude Fable/Opus/Sonnet/Haiku、Gemini 4 Argon、Grok 4.7、Meta Muse 等)公开 OpenAI‑、Gemini‑、Claude‑、Grok‑兼容 API。 |
| 每个提供商的 OAuth 登录 | 简单的 CLI 命令(--gemini-login、--openai-login、…)让您无需手动处理令牌即可添加账户。 |
| 循环负载均衡 | 当您有多个相同提供商的账户时,代理可以均匀分配请求,提高可靠性和吞吐量。 |
| 流式与 WebSocket 支持 | 当上游模型提供时,透传流式完成和基于 WebSocket 的聊天。 |
| 函数调用 / 工具使用 | 代理转发函数调用负载,因此基于 OpenAI 规范构建的工具可以继续工作。 |
| 多模态输入 | 接受文本和图像数据(在上游模型支持视觉的情况下)。 |
| Generative‑Language API‑key 模式 | 您可以为自己的应用程序使用单一“代理密钥”;代理在幕后注入真实的提供商密钥。 |
| 可配置的上游提供商 | 除了内置列表之外,您可以将代理指向任何 OpenAI 兼容服务(例如 OpenRouter)。 |
| 可重用的 Go SDK | 一个库(docs/sdk-*.md),用于在其他 Go 程序中嵌入代理逻辑。 |
| 管理与可观测性 | 可选的仪表板(CPA‑Usage‑Keeper、CPA‑Manager‑Plus、Oh‑My‑CPA)为您提供请求日志、令牌计数、延迟和成本明细,存储在 SQLite 中。 |
如何开始
- 运行代理 – 克隆仓库并启动二进制文件(或使用 Docker 镜像)。README 指向
https://help.router-for.me/的网页指南,以获取详细步骤。 - 添加提供商账户 – 使用 CLI 标志(
--openai-login、--gemini-login等)或编辑配置文件来提供 API 密钥/OAuth 令牌。 - 将您的工具指向代理 – 将任何 OpenAI 兼容客户端中的端点 URL 更改为
http://localhost:PORT/v1(或您选择的端口)。 - 可选 UI – 安装配套的桌面客户端 EasyCLIProxyAPI,以获取系统托盘 UI、一键启动/停止和自动更新。
生态系统与相关项目
几个第三方工具已经构建在 CLI Proxy API 之上:
- vibeproxy – macOS 菜单栏应用程序,让您无需暴露 API 密钥即可使用 Claude Code 和 ChatGPT。
- Subtitle Translator – 桌面/网页应用程序,使用您的任何 LLM 订阅通过代理翻译 SRT 文件。
- CCS (Claude Code Switch) – CLI 包装器,用于在多个 Claude 账户之间即时切换。
- Quotio – macOS 菜单栏应用程序,汇总配额并在提供商之间进行智能故障转移。
谁维护它?
仓库由 router‑for‑me 组织拥有。包含指向各种 AI 中继服务(PackyCode、AICodeMirror 等)的赞助链接,但核心代理代码是开源的,并接受社区通过 pull request 贡献。
TL;DR
CLI Proxy API 是一个本地运行的代理,让任何 OpenAI 风格的客户端都能与数十个 LLM 提供商搭配使用,处理身份验证、多账户负载均衡和可选的使用量仪表板。对于需要管理多个 AI 订阅或想要为其工具提供单一可控端点的开发人员来说,这非常有用。
相关
- 项目
- 项目
- 项目
- 项目
- 项目