CLIProxyAPI (下面简称CPA)是一个开源代理工具,支持为 Gemini、OpenAI、Claude、Qwen、iFlow 等所有平台配置多个账户,并通过轮询或填充优先策略实现负载均衡,最大化利用各平台配额。
为什么要使用 CPA
在没有使用CPA之前,你在使用大模型API可能会遇到以下两个核心问题。
API请求格式兼容问题
我们都知道,不同AI提供商(OpenAI、Claude、Gemini等)使用完全不同的API格式,我们需要为每个提供商编写适配代码来给工具使用,这样无疑增加了维护成本。
多账号配额管理问题
有钱的朋友平时可能会购买了多个平台的大模型提供商, OAuth令牌、API密钥、服务账户等多种认证方式需要分别管理,令牌刷新和过期处理繁琐,但是单一账户的API调用配额有限,达到限制后服务中断,影响开发连续性,如果依赖单一提供商,当服务出现故障时没有备用方案,就会导致工作中断。
那接下来我们来看一下如何使用这个 CPA?
下载 CLIProxyAPI
我们可以通过官方提供的 Windows 软件包进行下载,具体链接为:https://github.com/router-for-me/CLIProxyAPI/releases 。由于我的系统是 64 位的,所以我们要选择相应的软件包,下载下来后解压到磁盘上,例如“D:\Tools\cliproxy”。
在解压后的文件夹里,我们需要config.example.yaml 文件,并重新命名为 config.yaml,然后打开这个文件
这里有两个最关键的地方需要注意:
- Port:默认是 8317,只要不与其他端口冲突就无需变动。
- secret-key:这是后台登录密码,自己可以随便写个好记的,待会登录面板需要用到。
登录授权
打开浏览器,输入 http://localhost:8317/management.html 进入管理界面,输入上一步中设置的密码进行登录。
配置模型AI提供商
可看到左侧可以通过多种方式配置大模型AI提供商,支持 Gemini CLI、ChatGPT Codex、Claude Code、Vertex API、OpenAI 兼容提供商等等,我们可以添加你所有的账号,CPA 会自动进行轮询使用。
我们这里演示一下如何添加 Codex API,我们点击左边的 OAuth 登录,选择 Codex 登录,打开链接
登录成功之后,在配额管理页面就可以看到 Codex 的额度
接下来在 cc-switch 页面配置对应的 baseUrl 和 apiKey 即可:

注意:这个 apiKey 在【配置面板】菜单下面的 API 密钥列表 (api-keys) 里面设置,不是模型里面的 key
我们就可以在 codex 上使用到对应的 GPT 5 模型了
最后,其他的大模型提供商也是一样的配置,如果有不懂的欢迎评论区讨论。
评论