全部产品
Search

搜索本产品

    大模型服务平台百炼：Codex

    文档中心

    大模型服务平台百炼：Codex

    更新时间：Apr 30, 2026

    在 Codex 中配置与使用阿里云百炼 Token Plan 团队版。

    安装 Codex

    1. 安装或更新 Node.js（v18.0 或更高版本）。

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

      npm install -g @openai/codex

      执行以下命令验证安装。

      codex --version

    在 Codex 中配置 Token Plan 团队版

    1. 修改配置文件

      完整复制以下内容并粘贴到 Codex 配置文件~/.codex/config.toml中。model请选择支持的模型。

      说明

      文本模型（如 qwen3.6-plus、glm-5 等）可直接使用。图像生成模型需通过 Skill 接入，参见接入多模态生成模型。

      model_provider = "Model_Studio_Token_Plan"
model = "qwen3.6-plus"
[model_providers.Model_Studio_Token_Plan]
name = "Model_Studio_Token_Plan"
base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

    2. 配置环境变量

      将配置文件中的OPENAI_API_KEY环境变量设置为 Token Plan 团队版专属 API Key。

      macOS

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

        echo $SHELL

      2. 根据 Shell 类型设置环境变量，命令如下：

        Zsh

        # 将 YOUR_API_KEY 替换为 Token Plan 团队版 API Key
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc

        Bash

        # 将 YOUR_API_KEY 替换为 Token Plan 团队版 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 将 YOUR_API_KEY 替换为 Token Plan 团队版 API Key
setx OPENAI_API_KEY "YOUR_API_KEY"

      2. 打开一个新的 CMD 窗口，运行以下命令，检查环境变量是否生效。

        echo %OPENAI_API_KEY%

      PowerShell

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

        # 将 YOUR_API_KEY 替换为 Token Plan 团队版 API Key
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)

      2. 打开一个新的 PowerShell 窗口，运行以下命令，检查环境变量是否生效。

        echo $env:OPENAI_API_KEY

    使用 Codex

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

      codex

    2. 开始对话

      image

    常见问题

    报错 wire_api = chat is no longer supported 怎么办？

    原因：Codex 新版本使用 Responses API，不支持 wire_api = "chat" 配置。

    解决方案：将wire_api改为responses，并确认base_url配置正确：

    base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
wire_api = "responses"

    报错 unexpected status 401 Unauthorized 怎么办？

    原因：

    • 误用了其他套餐的 API Key（如 Coding Plan 或百炼按量计费的 Key）

    • Token Plan 团队版订阅过期

    • API Key 复制不完整、有空格或拼写错误

    解决方案：

    • 确认使用的是 Token Plan 团队版专属 API Key，Token Plan 团队版、Coding Plan 和百炼按量计费的 API Key 互不相通。

    • 前往Token Plan 团队版页面确认订阅是否过期。

    • 前往Token Plan 团队版页面重新复制 API Key，确保完整且无空格。

    • 如以上均正常仍报错，可在 Token Plan 团队版页面重置 API Key，重置后请使用新 API Key 进行配置。

    报错 unexpected status 404 Not Found 怎么办？

    原因：配置文件中的base_url填写错误。

    解决方案：确认base_url和wire_api配置正确：

    base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
wire_api = "responses"