15 分钟快速搞定 CLIProxyAPI 配置

把 GPT Plus 订阅通过 CLIProxyAPI 转成 OpenAI 兼容的 API 服务,接入 CodeBuddy 等本地工具,顺便踩了两个防火墙的坑。

1 / 1

之前一直用 sub2api 把 ChatGPT 的网页端转成 API,给本地的编程工具提供模型接口。用着用着,某天突然发现不能用了。

具体是被封了还是接口变了,也没细究,反正是坏了。坏了之后就想找替代方案,一搜发现 CLIProxyAPI 这个项目,Star 数不少,而且思路和 sub2api 类似——把你已有的订阅变成 API,不需要额外买 Key。

区别在于 CLIProxyAPI 走的是 OAuth 登录,模拟的是 Codex CLI 的流量,而不是直接抓网页。据说更稳定,也更不容易被检测。

正好我有 GPT Plus,服务器也有,那就试试。

一、CLIProxyAPI 是什么

一句话:它是一个代理服务,把 Gemini、Claude Code、OpenAI Codex 这些 CLI 工具的 OAuth 认证,转成标准的 OpenAI 兼容 API。

也就是说,你不需要去 OpenAI 申请 API Key(也不需要花钱买 Token),直接用你的 Plus 订阅账号登录,CLIProxyAPI 就能帮你把请求转发过去,返回的结果格式和 OpenAI 官方 API 一模一样。

对于已有 Plus 但没有 API 额度的人来说,这基本等于白嫖。

二、15 分钟搞定全过程

整个流程拆开来就五步:安装、启动、登录、开防火墙、接入工具。一步步来。

第一步:安装

从 GitHub Releases 下载对应平台的二进制包,解压即可:

# 下载最新版(以 Linux AMD64 为例)
VERSION=$(curl -s https://api.github.com/repos/router-for-me/CLIProxyAPI/releases/latest | grep tag_name | cut -d '"' -f 4)
wget https://github.com/router-for-me/CLIProxyAPI/releases/download/${VERSION}/cli-proxy-api_linux_amd64.tar.gz

# 解压
tar -xzf cli-proxy-api_linux_amd64.tar.gz
chmod +x cli-proxy-api

不需要编译,不需要装依赖,下载完就是一个可执行文件。

第二步:启动服务

直接运行:

./cli-proxy-api

默认监听 0.0.0.0:8317。首次启动会自动拉取最新的模型目录,看到 API server started successfully on: :8317 就说明起来了。

第三步:OAuth 登录 GPT Plus

另开一个终端,跑登录命令:

./cli-proxy-api --codex-login

它会走 OpenAI 的 OAuth 设备流。服务器没有浏览器的话加 --no-browser,它会打印一个 URL,你本地打开登录就行。登录成功后 token 自动保存到 ~/.cli-proxy-api/,后续请求自动带上。

第四步:开防火墙

这里是第一个坑。腾讯云有两层防火墙,两层都要开端口:

层级 位置 操作
安全组 腾讯云控制台 添加入站规则,TCP 8317
UFW 服务器 OS 内部 sudo ufw allow 8317/tcp

我之前只开了安全组,结果 UFW 默认拒绝入站,请求在操作系统层就被拦了,怎么都连不上。这个坑不新鲜,但每次都会忘。

第五步:把 API 地址和 Key 填到本地工具

最后一步就是把 API 信息复制到你本地的编程工具里。以 CodeBuddy 为例:

  • 供应商:选 Custom
  • BASE URL:http://<服务器公网IP>:8317/v1
  • API KEY:填 config.yaml 里的任意一个 key
  • 模型名称:选你要用的模型,比如 gpt-5.5

保存,搞定。CodeBuddy 发出的请求会经过 CLIProxyAPI 转发到 OpenAI,整个链路对工具本身是透明的。

第六步:设置开机自启

服务器重启后,CLIProxyAPI 不会自动运行。要让它作为守护进程长期运行,可以用 systemd 管理:

# 复制服务文件到 systemd 目录
sudo cp /home/ubuntu/cliproxyapi/cliproxyapi.service /etc/systemd/system/

# 重新加载 systemd 配置
sudo systemctl daemon-reload

# 启用开机自启
sudo systemctl enable cliproxyapi

# 启动服务
sudo systemctl start cliproxyapi

之后可以用 sudo systemctl status cliproxyapi 查看运行状态,用 sudo journalctl -u cliproxyapi -f 实时查看日志。

这样设置后,服务器重启时 CLIProxyAPI 会自动拉起,不需要手动干预。

三、可用模型一览

登录成功后,CLIProxyAPI 会从 OpenAI 拉取当前账号可用的模型列表。我这边拿到了这些:

模型 说明
gpt-5.5 通用对话模型
gpt-5.6-terra Terra 系列
gpt-5.6-sol Sol 系列
gpt-5.6-luna Luna 系列
gpt-6-astra Astra 系列
gpt-5.3-codex-spark Codex Spark
gpt-image-1.5 图片生成
gpt-image-2 图片生成(新版)
codex-auto-review 自动代码审查

具体模型列表会随 OpenAI 的调整变化,以实际拉取到的为准。

四、总结

整个过程其实很简单:下载、启动、OAuth 登录、开防火墙、配工具。中间唯一浪费时间的就是那个双层防火墙的问题。

比起 sub2api,CLIProxyAPI 的优势在于不依赖网页抓取,走的是 OAuth 标准流程,理论上更稳定。而且它不只支持 GPT,Gemini、Claude Code 都能接,一个服务搞定多个订阅。

对于已经有 GPT Plus 但不想额外花钱买 API 的人来说,值得一试。

使用 Hugo 构建
主题 Stack 由 Jimmy 设计
参考 iOS 26 液态玻璃风格改造