Codex 客户端 - OpenAI 桌面与 IDE 编程助手

适用范围

本教程适用于 Codex 桌面客户端、Codex IDE 插件，以及读取本机 ~/.codex 配置目录的 Codex 客户端。配置完成后，Codex 会通过 cnAPI 中转调用模型。

使用前准备

1. 已注册并登录 cnAPI。
2. 账户有可用余额。
3. 已在 cnAPI 控制台创建 API Key。
4. 本机已安装 Codex 客户端或相关 IDE 插件。

配置原理

Codex 客户端会读取本机用户目录下的 Codex 配置：

cnAPI 的 Codex 中转配置需要使用：

一键配置

Windows

打开 PowerShell，执行：

一键配置 Codex 客户端

本站公开教程使用简易配置脚本，只写入 Codex 的 cnAPI Provider 配置，不安装代理， 也不修改 Windows 系统代理。

curl.exe --ssl-no-revoke -fsSL https://cnapi.vip/helper/codex-client-setup.ps1 -o "$env:TEMP\codex-client-setup.ps1"
PowerShell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\codex-client-setup.ps1"

按提示输入：

1. API 基础地址：直接回车使用默认 https://cnapi.vip。
2. API Key：粘贴你在 cnAPI 控制台创建的密钥。

脚本会自动写入：

%USERPROFILE%\.codex\config.toml

脚本会把 cnAPI Key 写入当前 Provider 的 experimental_bearer_token，不会再依赖 auth.json.OPENAI_API_KEY 继承鉴权，避免新版 Codex 出现 API_KEY_REQUIRED / 401 Unauthorized。

macOS / Linux

打开终端，执行：

一键配置 Codex 客户端

bash <(curl -fsSL https://cnapi.vip/helper/codex-client-setup.sh)

按提示输入：

1. API 基础地址：直接回车使用默认 https://cnapi.vip。
2. API Key：粘贴你在 cnAPI 控制台创建的密钥。

脚本会自动写入：

~/.codex/config.toml

macOS / Linux 简易脚本同样使用 Provider 专属 experimental_bearer_token，不会把 cnAPI Key 写入 auth.json。

手动配置

如果不想使用一键脚本，也可以手动创建配置文件。

config.toml

在 ~/.codex/config.toml 写入：

model = "gpt-5.6-sol"
model_provider = "cnAPI"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.cnAPI]
name = "cnAPI"
base_url = "https://cnapi.vip/v1"
wire_api = "responses"
supports_websockets = false
experimental_bearer_token = "sk-你的cnAPI密钥"

auth.json

新版配置不建议把 cnAPI Key 写入 auth.json。auth.json 应只作为 OpenAI 官方账号登录缓存保留；模型请求的 cnAPI Key 应放在 config.toml 当前 Provider 的 experimental_bearer_token 中。

启动客户端

配置完成后，重新打开 Codex 客户端或重启 IDE。

如果客户端已经在运行，请完全退出后重新启动，确保它重新读取 ~/.codex/config.toml 和 ~/.codex/auth.json。

验证是否走 cnAPI

1. 在 Codex 客户端中发起一次简单任务。
2. 打开 cnAPI 控制台。
3. 进入使用日志，查看是否出现对应请求记录。

如果使用日志里有请求记录，说明 Codex 客户端已经通过 cnAPI 中转。

常见问题

客户端仍然走官方账号

请确认客户端是否支持读取本机 ~/.codex 配置。部分官方云端 Codex 入口只使用 ChatGPT 账号登录，不能填写第三方 API 地址，这类入口无法通过 cnAPI 中转。

提示认证失败

检查 config.toml 当前 [model_providers.cnAPI] 或当前 Provider 中的 experimental_bearer_token 是否完整，密钥前后不要有空格或换行。

如果 ChatGPT / Codex 升级后出现 API_KEY_REQUIRED 或 401 Unauthorized，请重新运行 上方简易配置脚本，确保当前 Provider 已重新写入 experimental_bearer_token。

提示模型不可用

确认 cnAPI 控制台中该账户可以使用 gpt-5.6-sol。如果你的账户使用其他 Codex 兼容模型，请同步修改 config.toml 中的 model。

修改后没有生效

完全退出 Codex 客户端或 IDE 后重新打开。必要时删除旧的官方登录缓存，再重新运行一键配置脚本。