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 基础设施领域，对于任何希望将不同模型提供商视为单一、可互换后端的使用者都非常有用。