UPGPTs

中文

English

中文

English

Appearance

CLIProxyAPI 教程（2026）：把 Codex 会员转成本地 API Key，免买额度直连 Claude Code ​

作者：UPGPTs 团队首次发布：2026-09-27最后更新：2026-09-27

这篇文章解决什么问题： 手里有 Codex 会员，但平时主要用 Claude Code，会员额度用不上，又不想再花钱买官方 API 额度。本文用开源工具 CLIProxyAPI 在本机起一个代理，把 Codex 会员账号接出来，变成一把标准 OpenAI 格式的本地 API Key，再用 CC Switch 填进 Claude Code。全程 Windows 实操，中间踩过一个冷却时间的坑（auth_unavailable 报错），也写在里面。

CLIProxyAPI 在你本机跑一个兼容 OpenAI 格式的服务，用 OAuth 把会员账号登进去，然后对外发一把 API Key。Grok、Kimi 的会员同样可以这样转。客户端这边，Claude Code、NextChat、Cherry Studio、OpenClaw、WorkBuddy、Hermes、Pi 这些工具都能接上，只要它允许你自己填 API 地址和 Key。

CLIProxyAPI 把 Codex 会员账号转成本地 API Key 的定位说明

📚 本文目录（点击跳转） ​

开始之前：四个前提 ​

缺一个后面都走不通：

  1. 一个 Codex 会员账号。 这是要被转成 API Key 的那个账号。还没有账号可参考 Codex 使用教程 或 ChatGPT / Codex 订阅价格对比 了解如何开通。
  2. 本机装好 Claude Code。 没有的话执行 npm install -g @anthropic-ai/claude-code，需要先有 Node.js 环境。
  3. 本机装好 CC Switch。 最后一步用它把地址和 Key 填进 Claude Code，官网 和 GitHub Releases 都能下载，Windows 选 .msi 一路下一步即可。装法和用法见 CC Switch 接入教程。
  4. 一个能连上 AI 服务的网络环境。 连不上就在第五步配代理。

第一步：下载并解压 CLIProxyAPI ​

访问项目地址 CLIProxyAPI：

访问 CLIProxyAPI 的 GitHub 项目主页

下载对应的 Windows 版本：

在 Releases 页面下载 CLIProxyAPI 的 Windows 版本

解压之后有一件事必须先做：把 config.example.yaml 重命名为 config.yaml。程序读的是 config.yaml，不改名字配置不生效。

解压后把 config.example.yaml 重命名为 config.yaml

第二步：改配置文件（四处） ​

在 config.yaml 里改四处。前两处必改，后两处建议改。

1. host 改成 127.0.0.1（必改） ​

把配置文件中的 host 改为 127.0.0.1

改成 127.0.0.1，只允许本机访问。host 默认是空值，空值会监听机器上所有网卡。家里有公网 IP 的千万别留空。

2. api-keys 填自己定的 Key（必改） ​

在配置文件中设置 api-keys 作为后续要填的 API Key

填一个你自己定的字符串，这就是后面在 Agent 里要填的 Key。想给不同工具发不同 Key，就多加几行。

⚠️ 只填一个 Key 的话，记得把剩下两个默认的 Key 注释掉，不要留着。另外建议写成 sk-xxxx 的格式，不强制，但很多客户端习惯按这个格式校验。

3. transient-error-cooldown-seconds 改成 2（踩坑后加的） ​

把 transient-error-cooldown-seconds 从 0 改成 2

改成 2。这一条是我踩坑之后加的，展开说一下。

配置文件的注释里写着，0 等于沿用老规矩：上游只要报一次 408 / 500 / 502 / 503，这个账号就静止 60 秒。而网络抖一下太常见了，抖一下账号就进冷却，这 60 秒内所有请求都拿不到可用凭证，客户端看到的是这个：

text
auth_unavailable: no auth available

重试 5 次全打在冷却期里，整轮任务直接挂。

改成 2 之后，账号只歇两秒，客户端的重试节奏正好能踩到冷却结束的那个时间点，第二次就过了。改完我再没碰到过整轮失败。

4. secret-key 设成你的管理密码 ​

找到 secret-key，设置一个管理密码：

在配置文件中设置 secret-key 作为管理后台登录密码

yaml
secret-key: "你的管理密码"

这个密码用来登录 CLIProxyAPI 的管理后台（下文简称 CPA），自己记好。

也可以直接在配置文件里填写模型、密钥及认证信息，但配置相对复杂，建议启动服务后通过 Web 管理后台操作。

第三步：启动服务（含后台静默运行技巧） ​

在 CLIProxyAPI 的目录下打开 PowerShell，执行：

powershell
cli-proxy-api.exe

在 CLIProxyAPI 目录下用 PowerShell 启动服务

直接运行的话，这个黑窗口需要一直开着，关掉服务就停止了。

💡 不想在任务栏留着黑窗口，可以在解压目录下新建一个 start-silent.vbs 文本文件，内容写入：

bat
CreateObject("WScript.Shell").Run "cli-proxy-api.exe", 0, False

以后双击这个 .vbs 文件，服务就在 Windows 后台静默常驻，不占任务栏，也不会被误关。要停止服务，在任务管理器里结束 cli-proxy-api.exe 进程。

第四步：进入管理后台 ​

服务启动成功后，在浏览器中访问：

text
http://127.0.0.1:8317/management.html

浏览器打开 CLIProxyAPI 管理后台登录页

登录 CLIProxyAPI 管理后台

输入前面设置的 secret-key，即可进入 CPA 管理后台。

第五步：配置网络代理 ​

本地网络如果连不上相关 AI 服务，用下面两种方式之一解决。

方法一：开启 TUN 模式。 打开本地代理软件的 TUN 模式，让 CPA 的请求自动走代理。这是最省事的一条。

方法二：在 CPA 里单独配代理。 进入「配置面板 → 网络设置」，填写本地代理地址：

在管理后台的网络设置中填写本地代理地址

text
http://127.0.0.1:7890

或者：

text
socks5://127.0.0.1:7890

具体端口以你本地代理软件的实际配置为准。

第六步：用 OAuth 导入 Codex 账号 ​

CPA 支持三种接入方式：

方式适合什么情况
AI 提供商填写官方 API Key
认证文件导入已有的认证文件
OAuth 登录通过浏览器授权账号，个人自用选这个

个人自用直接选 OAuth 登录。

在管理后台选择 Codex OAuth 开始登录

进入 CPA 管理后台，选择 Codex OAuth，开始登录：

Codex OAuth 浏览器授权登录流程

认证成功后，在「认证文件」里可以看到刚刚登录的账号已经启用：

认证文件中显示 Codex 账号已激活启用

需要管理多个账号的话，重复以上步骤继续添加就行。

第七步：用 CC Switch 接入 Claude Code ​

打开 CC Switch，新建一个 Claude Code 的供应商配置：

在 CC Switch 中填写 CLIProxyAPI 的 API Key 和请求地址

  • API Key：填第二步 api-keys 里设置的其中一个
  • 请求地址：http://127.0.0.1:8317

然后配置对应的模型。填 Codex 会员能调用的模型名，我这边填的是 gpt6luna：

在 CC Switch 中把模型名填写为 gpt6luna

在 CC Switch 中配置 Claude Code 要使用的模型

确认 CC Switch 中的模型与供应商配置

填完启用这个供应商，就可以启动 Claude Code 了。

进阶：接入 NextChat / Cherry Studio 等任意通用客户端 ​

CLIProxyAPI 是一个标准的本地 OpenAI 兼容 API 代理，Claude Code 只是其中一个客户端。任何支持自定义 OpenAI 接口和密钥的桌面客户端，比如 NextChat、Cherry Studio、Chatbox、Cursor、LibreChat，都能接上 Codex 会员算力：

配置项填写内容说明
接口地址 (Base URL)http://127.0.0.1:8317/v1大多数 OpenAI 兼容客户端均要求带上 /v1 路径
API Key (密钥)填在 config.yaml 设定的 Key如 sk-codex-local，与配置文件保持完全一致
模型名称 (Model)管理后台显示的实际模型名例如 gpt6luna，以你在后台认证文件里看到的为准

只要客户端支持自定义模型名称，在模型管理里添加并启用，就能把它当成常规 API 用，不用再按官方 token 计费。

验证接入是否成功与排错 ​

在 Claude Code 里随便发一句话，比如让它说明当前用的模型。能正常返回就说明通了。

如果没通，按常见报错对号入座排查：

现象 / 报错信息原因解决办法
连接失败 / ECONNREFUSED本地代理服务未运行检查 CPA 终端窗口是否意外关闭，或在任务管理器确认 cli-proxy-api.exe 是否在运行
401 Unauthorized / 认证失败API Key 校验不通过检查客户端填写的 API Key 是否与 config.yaml 中配置的 api-keys 完全一致
auth_unavailable: no auth available触发了上游网络抖动冷却保护必改：按第二步把配置里的 transient-error-cooldown-seconds 改为 2，重启服务后重试
Model not found / 找不到模型模型名填写有误前往管理后台「认证文件」查看当前账号绑定的实际模型名，切勿随意照抄别人教程里的名字
请求超时 / 卡住无返回本地网络连不上上游服务回到第五步，确认本地代理软件配置正确（如 127.0.0.1:7890）或尝试开启全局 TUN 模式

常见问题 FAQ ​

host 为什么一定要改成 127.0.0.1？
默认是空的，等于让服务监听机器上所有网卡。如果你家有公网 IP，或者处在公司内网，就等于把一个不用密码就能调的模型接口挂到了网上。改成 127.0.0.1 之后只有本机能访问，这是必须做的第一件事。
api-keys 只填一个可以吗？
可以，但要记得把配置文件里另外两个默认 Key 注释掉。留着的默认 Key 等于后门，谁都能拿来调你的账号。另外建议写成 sk- 开头的格式，虽然不强制，但很多客户端会按这个习惯校验。
transient-error-cooldown-seconds 为什么要从 0 改成 2？
默认值 0 按配置文件的注释走老规矩：上游只要报一次 408、500、502、503，这个账号就得停 60 秒。网络抖动很常见，抖一下账号就进冷却，这 60 秒内所有请求都拿不到可用凭证（报 auth_unavailable: no auth available），整轮任务直接失败。改成 2 秒之后，账号只歇两秒，客户端的重试节奏正好能踩到冷却结束的点上。
可以接多个 Codex 账号吗？
可以。在管理后台重复走一遍 OAuth 登录流程就能继续加，认证文件里会列出所有已启用的账号。哪个账号在冷却，请求会自动落到其他的上面。
接入 Claude Code 时模型名填什么？
以管理后台里显示的模型名为准。不同的 Codex 订阅档位可用的模型不一样，在认证文件或模型列表里看到什么就填什么，不要照抄别人教程里的名字——本文第七步填的是 gpt6luna，换一个账号可能就不是这个。

相关教程 ​

总结 ​

CLIProxyAPI 做的事，是把会员账号转成一把本机 API Key：会员账号 → 本机代理服务 → API Key → 客户端。

最容易漏的两件事：config.example.yaml 要记得改名为 config.yaml，host 一定要填 127.0.0.1。最容易踩的坑是冷却时间，默认的 0 会让账号一抖就停 60 秒，改成 2 就顺了。

相关阅读

先看教程