Codex

更新时间:
复制为 MD 格式

在 Codex 中配置与使用阿里云百炼 Coding Plan。

适用范围

本文适用于支持 Chat/Completions API 的旧版本 Codex(如 0.80.0)。新版本 Codex 使用 Responses API,暂不支持接入 Coding Plan。

安装 Codex

  1. 安装或更新 Node.js(v18.0 或更高版本)。

  2. 在终端中执行以下命令安装 Codex。

    说明

    Codex 最新版本不再支持 Chat/Completions API。如需使用 Coding Plan,请执行以下命令安装旧版 Codex。

    npm install -g @openai/codex@0.80.0

    执行以下命令验证安装。

    codex --version

在 Codex 中配置 Coding Plan

  1. 修改配置文件

    完整复制以下内容并粘贴到 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"
  2. 配置环境变量

    将配置文件中的OPENAI_API_KEY环境变量设置为 Coding Plan 专属 API Key

    macOS

    1. 在终端中执行以下命令,查看默认 Shell 类型。

      echo $SHELL
    2. 根据 Shell 类型设置环境变量,命令如下:

      Zsh

      # 用您的Coding Plan API Key 替换 YOUR_API_KEY
      echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc

      Bash

      # 用您的Coding Plan API Key 替换 YOUR_API_KEY
      echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile
    3. 在终端中执行下列命令,使环境变量生效。

      Zsh

      source ~/.zshrc

      Bash

      source ~/.bash_profile

    Windows

    CMD

    1. CMD中运行以下命令,设置环境变量。

      REM 用您的Coding Plan API Key 替换 YOUR_API_KEY
      setx OPENAI_API_KEY "YOUR_API_KEY"
    2. 打开一个新的 CMD 窗口,运行以下命令,检查环境变量是否生效。

      echo %OPENAI_API_KEY%

    PowerShell

    1. PowerShell中运行以下命令,设置环境变量。

      # 用套餐专属 API Key 替换 YOUR_API_KEY
      [Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)
    2. 打开一个新的 PowerShell 窗口,运行以下命令,检查环境变量是否生效。

      echo $env:OPENAI_API_KEY

使用 Codex

  1. 新建一个终端,执行以下命令进入 Codex。

    codex

    选择跳过更新。

    image

  2. 开始对话

    image

常见问题

报错 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 复制不完整、有空格或拼写错误

解决方案

报错 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"