在 Codex 中配置与使用阿里云百炼 Coding Plan。
适用范围
本文适用于支持 Chat/Completions API 的旧版本 Codex(如 0.80.0)。新版本 Codex 使用 Responses API,暂不支持接入 Coding Plan。
安装 Codex
安装或更新 Node.js(v18.0 或更高版本)。
在终端中执行以下命令安装 Codex。
说明Codex 最新版本不再支持 Chat/Completions API。如需使用 Coding Plan,请执行以下命令安装旧版 Codex。
npm install -g @openai/codex@0.80.0执行以下命令验证安装。
codex --version
在 Codex 中配置 Coding Plan
修改配置文件
完整复制以下内容并粘贴到 Codex 配置文件
~/.codex/config.toml中。model请选择支持的模型。说明Codex 最新版本不再支持 Chat/Completions API。如需使用 Coding Plan,请参考上文安装 Codex。
model_provider = "Model_Studio_Coding_Plan" model = "qwen3.6-plus" [model_providers.Model_Studio_Coding_Plan] name = "Model_Studio_Coding_Plan" base_url = "https://coding.dashscope.aliyuncs.com/v1" env_key = "OPENAI_API_KEY" wire_api = "chat"配置环境变量
将配置文件中的
OPENAI_API_KEY环境变量设置为 Coding Plan 专属 API Key。macOS
在终端中执行以下命令,查看默认 Shell 类型。
echo $SHELL根据 Shell 类型设置环境变量,命令如下:
Zsh
# 用您的Coding Plan API Key 替换 YOUR_API_KEY echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrcBash
# 用您的Coding Plan API Key 替换 YOUR_API_KEY echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile在终端中执行下列命令,使环境变量生效。
Zsh
source ~/.zshrcBash
source ~/.bash_profile
Windows
CMD
在CMD中运行以下命令,设置环境变量。
REM 用您的Coding Plan API Key 替换 YOUR_API_KEY setx OPENAI_API_KEY "YOUR_API_KEY"打开一个新的 CMD 窗口,运行以下命令,检查环境变量是否生效。
echo %OPENAI_API_KEY%
PowerShell
在PowerShell中运行以下命令,设置环境变量。
# 用套餐专属 API Key 替换 YOUR_API_KEY [Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)打开一个新的 PowerShell 窗口,运行以下命令,检查环境变量是否生效。
echo $env:OPENAI_API_KEY
使用 Codex
新建一个终端,执行以下命令进入 Codex。
codex选择跳过更新。

开始对话

常见问题
报错 wire_api = chat is no longer supported 怎么办?
原因:Codex 新版本使用 Responses API,不支持 wire_api = "chat" 配置,暂不支持接入 Coding Plan。
解决方案:请执行以下命令降级到旧版本:
npm install -g @openai/codex@0.80.0报错 unexpected status 401 Unauthorized 怎么办?
原因:
误用了百炼通用 API Key(sk-xxx)
Coding Plan 订阅过期
API Key 复制不完整、有空格或拼写错误
解决方案:
前往Coding Plan 页面确认订阅是否过期。
前往Coding Plan 页面重新复制 API Key,确保完整且无空格
如以上均正常仍报错,可在 Coding Plan 页面重置 API Key,重置后请使用新 API Key 进行配置
报错 unexpected status 404 Not Found: Unknown error, url: https://coding.dashscope.aliyuncs.com/v1/responses 怎么办
原因:配置文件中的wire_api被误设为responses,但 Codex 不支持通过 Responses API 接入 Coding Plan。
解决方案:将wire_api改为chat。
wire_api = "chat"