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,然后打开这个文件

config.yaml
config.yaml

这里有两个最关键的地方需要注意:

  • Port:默认是 8317,只要不与其他端口冲突就无需变动。
  • secret-key:这是后台登录密码,自己可以随便写个好记的,待会登录面板需要用到。

登录授权

打开浏览器,输入 http://localhost:8317/management.html 进入管理界面,输入上一步中设置的密码进行登录。

management面板
management面板

配置模型AI提供商

可看到左侧可以通过多种方式配置大模型AI提供商,支持 Gemini CLI、ChatGPT Codex、Claude Code、Vertex API、OpenAI 兼容提供商等等,我们可以添加你所有的账号,CPA 会自动进行轮询使用。

配置模型AI提供商
配置模型AI提供商

我们这里演示一下如何添加 Codex API,我们点击左边的 OAuth 登录,选择 Codex 登录,打开链接

Codex 授权登录
Codex 授权登录

登录成功之后,在配额管理页面就可以看到 Codex 的额度

Codex 的额度
Codex 的额度

接下来在 cc-switch 页面配置对应的 baseUrl 和 apiKey 即可:

424e94e9-387a-445d-84de-dd540f109992.webp

注意:这个 apiKey 在【配置面板】菜单下面的 API 密钥列表 (api-keys) 里面设置,不是模型里面的 key

apiKey
apiKey

我们就可以在 codex 上使用到对应的 GPT 5 模型了

codex gpt5大模型

最后,其他的大模型提供商也是一样的配置,如果有不懂的欢迎评论区讨论。