CLI Proxy API（CPA）反代 ChatGPT Codex 教程（2026 最新版）
对于很多高频使用 ChatGPT Codex 的用户来说，真正的痛点往往不是安装，而是 API Token 消耗速度与长期使用成本。
CLI Proxy API（简称 CPA）的出现，本质上解决了两个核心问题：
- 将 OpenAI OAuth 登录态转换为本地 OpenAI API
- 通过多账号认证降低 Codex 使用成本
本文将从实际部署角度，完整讲解：
- CLI Proxy API 安装与配置
- OAuth 登录与认证文件生成
- Codex CLI 接入
- CC Switch 配置方法
- Token 使用统计恢复
- 多账号认证方案
- 接码平台与邮箱选择
整篇内容采用图文形式，适合新手用户快速部署。
为什么很多人开始使用 CPA
传统 OpenAI API 存在几个明显问题：
| 问题 | 影响 |
|---|---|
| API 成本较高 | 高频调用费用明显 |
| 限流严格 | 容易触发速率限制 |
| 多账号管理困难 | Token 难统一管理 |
| Codex CLI 配置复杂 | 新手容易踩坑 |
CLI Proxy API 的核心思路，是把：
OpenAI OAuth 登录转换为：
OpenAI API 兼容接口从而让：
- Codex CLI
- CC Switch
- OpenAI SDK
- 第三方客户端
都能够直接接入本地反代服务。
使用前准备
正式开始之前，需要提前准备以下环境。
基础环境要求
- Windows 系统
- 可访问 OpenAI 的网络环境
- 开启 Tun（虚拟网卡）模式
- OpenAI Free 账号
- 手机接码平台
OAuth 登录阶段建议全程开启 Tun 模式，否则可能出现登录失败或认证异常。
成本情况
根据实际测试：
| 项目 | 成本 |
|---|---|
| 单账号接码成本 | 0.3 ~ 0.5 元 |
| Token 刷新周期 | 每周 |
| 推荐账号数量 | 20 ~ 30 个 |
对于中轻度使用场景，这类方案的长期成本其实非常低。
下载 CLI Proxy API
获取程序
项目地址：
https://github.com/router-for-me/CLIProxyAPI/releases建议优先选择：
| 组件 | 推荐版本 |
|---|---|
| 后端 | 6.10 以下 |
| 前端 | 1.10 以下 |
原因是：
从 CLI Proxy API 6.10 开始，官方移除了 Token 使用统计接口。
如果你需要：
- Token 消耗统计
- 使用监控页面
- 配额观察
则需要使用旧版本。
下载界面
配置 CLI Proxy API
下载完成后解压程序。
目录结构如下：
修改 config.yaml
官方配置文档：
https://help.router-for.me/cn/configuration/options.html推荐配置：
host: ""
port: 8317
remote-management:
allow-remote: true
secret-key: "你的密码"
auth-dir: "./.cli-proxy-api"
debug: true
usage-statistics-enabled: true参数说明
| 参数 | 说明 |
|---|---|
| host | 服务监听地址 |
| port | API 服务端口 |
| allow-remote | 是否允许远程访问 |
| secret-key | 管理后台密码 |
| auth-dir | 认证文件目录 |
| debug | 调试日志 |
| usage-statistics-enabled | Token 统计开关 |
启动 CPA 后台
配置完成后：
直接运行：
cli-proxy-api.exe随后访问：
http://localhost:8317/management.html#/login即可进入后台管理页面。
登录页面
OAuth 登录与认证
进入后台后：
- 点击 OAuth 登录
- 选择开始 Codex 登录
整个流程建议开启 Tun 模式。
OAuth 登录页面
生成认证文件
认证成功后：
CPA 会自动生成对应认证文件。
认证完成页面
查看账号额度
刷新后台后即可看到当前账号额度信息。
配额页面
创建 API Key
进入配置面板：
- 新建 API Key
- 保存配置
之后 Codex CLI 会通过该 Key 调用本地 CPA 服务。
配置 Codex CLI
如果已经安装 Codex CLI，可以直接开始接入。
PowerShell 一键配置
$d="$env:USERPROFILE\.codex"; if(!(Test-Path $d)){mkdir $d -Force}; "model_provider = `"cpaapi`"`nmodel = `"gpt-5.3-codex`"`nmodel_reasoning_effort = `"medium`"`n`n[model_providers.cpaapi]`nname = `"cpaapi`"`nbase_url = `"http://localhost:8317/v1`"`nwire_api = `"responses`"" | Out-File -FilePath "$d\config.toml" -Encoding ascii; "{`n `"OPENAI_API_KEY`": `"your apikey`"`n}" | Out-File -FilePath "$d\auth.json" -Encoding ascii记得将：
your apikey替换为自己的 API Key。
手动配置方式
config.toml
路径：
~/.codex/config.toml配置内容：
model_provider = "cpaapi"
model = "gpt-5.3-codex"
model_reasoning_effort = "medium"
[model_providers.cpaapi]
name = "cpaapi"
base_url = "http://localhost:8317/v1"
wire_api = "responses"auth.json
路径：
~/.codex/auth.json配置内容：
{
"OPENAI_API_KEY": "your apikey"
}使用 CC Switch 接入 CPA
除了 Codex CLI，CPA 也可以直接接入 CC Switch。
添加供应商
参数配置
| 参数 | 内容 |
|---|---|
| 供应商名称 | 自定义 |
| API Key | CPA 后台生成的 Key |
| API 地址 | http://localhost:8317/v1 |
配置示例
测试连接
连接成功后即可正常调用。
验证 Token 是否正常消耗
重新打开：
- CMD
- PowerShell
随后调用 Codex。
如果后台额度开始减少，则说明 CPA 已正常工作。
命令行调用
Token 使用变化
恢复 CPA Token 统计页面
由于新版已经移除统计接口，因此需要旧版管理中心。
推荐版本：
| 组件 | 推荐版本 |
|---|---|
| CLI Proxy API | 6.9.49 |
| Management Center | 1.9.3 |
下载旧版管理中心
下载后会得到：
management.html文件。
下载页面
替换 management.html
关闭 CPA 后：
进入：
static目录。
替换原有：
management.html文件即可。
替换位置
启用 Token 统计功能
确认：
usage-statistics-enabled: true已经开启。
重新启动 CPA 后即可恢复统计页面。
Token 统计页面
多账号认证方案
对于高频调用场景：
单账号显然不够。
因此通常会采用：
- 多账号
- 多认证文件
- Token 轮换
- 自动切换
等方案。
邮箱选择建议
经过大量测试：
| 邮箱类型 | 情况 |
|---|---|
| Gmail | 基本需要手机号 |
| Outlook | 风控较严格 |
| 临时邮箱 | 成功率较低 |
| Cloudflare 临时邮箱 | 仍可能要求手机号 |
| 2925 邮箱 | 成功率相对较高 |
为什么推荐 2925 邮箱
优势包括：
- 支持无限子邮箱
- 长期有效
- 方便批量注册
- 更适合长期维护认证文件
例如：
[email protected]
[email protected]
[email protected]接码平台推荐
目前稳定性较高的平台：
- 5sim
- hero-sms
5sim 使用建议
建议优先观察：
- 国家成功率
- 运营商成功率
5sim 示例
hero-sms 使用建议
推荐方式：
- 少量多次购买
- 超时快速取消
- 多国家轮换测试
hero-sms 示例
关于登录与注册
由于 OpenAI 登录频繁需要邮箱验证码，因此：
更推荐直接在 CPA OAuth 中完成登录与注册。
这样可以减少：
- 邮箱验证次数
- 登录异常
- 重复认证问题
总结
CLI Proxy API 的核心价值，在于：
- 将 OpenAI OAuth 转换为本地 API
- 降低 Codex 长期使用成本
- 提供本地统一调用入口
适合：
- 高频 Codex 用户
- AI 开发者
- 自动化脚本
- 本地 AI 工作流
- 多账号 Token 管理场景
后续还可以继续扩展：
- Docker 部署
- Linux 部署
- Nginx 反代
- 自动切号
- Token 池
- 多认证文件管理
- 自动保活
- OpenAI SDK 接入
