Codex - 千问 AI 平台

Codex 是 OpenAI 推出的终端 AI 编程助手。可通过 Token Plan 个人版、Token Plan 团队版或按量计费接入千问 AI 平台。

安装 Codex

安装或更新 Node.js（v18.0 或更高版本）。
在终端中执行以下命令安装 Codex。

npm install -g @openai/codex

执行以下命令验证安装。

codex --version

配置接入凭证

接入需要编辑配置文件 ~/.codex/config.toml 并配置环境变量 OPENAI_API_KEY。根据所选计费方案替换对应值，千问 AI 平台提供以下计费方案：

配置模型元数据

使用自定义模型（如 qwen3.8-max-preview）时，需要配置模型元数据文件，使 Codex 正确识别模型的上下文窗口、推理深度等参数。

新建文件 ~/.codex/model-catalog.local.json，写入以下内容：

{
  "models": [
    {
      "slug": "qwen3.8-max-preview",
      "display_name": "qwen3.8-max-preview",
      "description": "DashScope model: qwen3.8-max-preview",
      "default_reasoning_level": "xhigh",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 983616,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": ["text", "image"]
    }
  ]
}

在 ~/.codex/config.toml 中添加以下配置，指向元数据文件：

model_catalog_json = "~/.codex/model-catalog.local.json"

Token Plan 个人版

model 请选择支持的模型，可用模型包括 qwen3.8-max-preview、qwen3.7-max、qwen3.7-plus、qwen3.6-flash、glm-5.2、deepseek-v4-pro。将 OPENAI_API_KEY 环境变量设置为 Token Plan 个人版专属 API Key。

Responses API（qwen3.8-max-preview、qwen3.7-max、qwen3.7-plus、qwen3.6-plus、qwen3.6-flash）

qwen3.8-max-preview、qwen3.7-max、qwen3.7-plus、qwen3.6-plus 和 qwen3.6-flash 支持 Responses API，可使用最新版 Codex。

model_provider = "Model_Studio_Token_Plan_Personal"
model = "qwen3.8-max-preview"
[model_providers.Model_Studio_Token_Plan_Personal]
name = "Model_Studio_Token_Plan_Personal"
base_url = "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

Chat/Completions API（其他模型）

其他模型需通过 Chat/Completions API 接入，需安装旧版本 Codex，如 0.80.0：

npm install -g @openai/codex@0.80.0

model_provider = "Model_Studio_Token_Plan_Personal"
model = "glm-5"
[model_providers.Model_Studio_Token_Plan_Personal]
name = "Model_Studio_Token_Plan_Personal"
base_url = "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

配置环境变量

将 OPENAI_API_KEY 环境变量设置为 Token Plan 个人版专属 API Key。

macOS
Windows

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

echo $SHELL

根据 Shell 类型设置环境变量：

zsh
bash

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

在终端中执行下列命令，使环境变量生效。

zsh
bash

source ~/.zshrc

CMD
PowerShell

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

REM 将 YOUR_API_KEY 替换为 Token Plan 个人版 API Key
setx OPENAI_API_KEY "YOUR_API_KEY"

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

echo %OPENAI_API_KEY%

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

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

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

echo $env:OPENAI_API_KEY

qwen3.8-max-preview 思考模式说明：

thinking：始终开启，不支持关闭。
temperature：思考模式下默认值为 0.6；传入值小于 0.6 时自动调整为 0.6。
reasoning_effort：控制推理深度，可选 xhigh、high、low，默认 xhigh。

Token Plan 团队版

model 请选择支持的模型。将 OPENAI_API_KEY 环境变量设置为 Token Plan 团队版专属 API Key。

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

Responses API（qwen3.8-max-preview、qwen3.7-max、qwen3.7-plus、qwen3.6-plus、qwen3.6-flash）

qwen3.8-max-preview、qwen3.7-max、qwen3.7-plus、qwen3.6-plus 和 qwen3.6-flash 支持 Responses API，可使用最新版 Codex。

model_provider = "Model_Studio_Token_Plan"
model = "qwen3.8-max-preview"
[model_providers.Model_Studio_Token_Plan]
name = "Model_Studio_Token_Plan"
base_url = "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

Chat/Completions API（其他模型）

其他模型需通过 Chat/Completions API 接入，需安装旧版本 Codex，如 0.80.0：

model_provider = "Model_Studio_Token_Plan"
model = "glm-5"
[model_providers.Model_Studio_Token_Plan]
name = "Model_Studio_Token_Plan"
base_url = "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

配置环境变量

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

macOS
Windows

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

echo $SHELL

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

zsh
bash

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

在终端中执行下列命令，使环境变量生效。

zsh
bash

source ~/.zshrc

CMD
PowerShell

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

REM 将 YOUR_API_KEY 替换为 Token Plan 团队版 API Key
setx OPENAI_API_KEY "YOUR_API_KEY"

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

echo %OPENAI_API_KEY%

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

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

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

echo $env:OPENAI_API_KEY

qwen3.8-max-preview 思考模式说明：

thinking：始终开启，不支持关闭。
temperature：思考模式下默认值为 0.6；传入值小于 0.6 时自动调整为 0.6。
reasoning_effort：控制推理深度，可选 xhigh、high、low，默认 xhigh。

接入图像生成模型

通过 Codex 的 Skill 机制，可以调用 Token Plan 团队版的图像生成模型（qwen-image-2.0、wan2.7-image 等）。

步骤一：创建 Skill

创建文件 ~/.codex/skills/token-plan-image/SKILL.md，完整复制以下内容并粘贴。

---
name: "token-plan-image"
description: "Generate images from text descriptions using Token Plan's image generation API (qwen-image-2.0, wan2.7-image, etc.). Activate when the user asks to draw, generate, or create an image."
---

# Token Plan Image Generation

Generate images from text prompts via the Token Plan API.

## When to use

Activate this skill when the user requests image generation.

## Pipeline

1. Extract parameters from the user's request: prompt, model (default: qwen-image-2.0), size (default: 1024*1024).
2. Call the API with curl:

```bash
curl -s -X POST "https://token-plan.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_NAME","input":{"messages":[{"role":"user","content":[{"text":"PROMPT_TEXT"}]}]},"parameters":{"size":"IMAGE_SIZE"}}'
```

3. Extract the image URL from the response JSON (located at output.choices[].message.content[].image).
4. Download the image with curl and report the saved file path to the user.

## Important

Do NOT attempt to view or read the generated image file. The model does not support image input and will error. Only report the file path.

步骤二：使用

在 Codex 中描述图像需求，Codex 会自动调用 token-plan-image Skill 生成图片。

使用 Codex

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

codex

开始对话。

配置按量计费

将 OPENAI_API_KEY 环境变量设置为千问 AI 平台 API Key。可用模型请参考支持的模型。

配置项	说明
Base URL	`https://dashscope.aliyuncs.com/compatible-mode/v1`
API Key	千问 AI 平台 API Key（格式为 `sk-xxxxx`），设为 `OPENAI_API_KEY` 环境变量
可用模型	支持的模型

按量计费支持 Responses API 和 Chat/Completions API 两种接入方式，请根据使用的模型选择：

Responses API

适用于支持 OpenAI Responses API 的模型（如 qwen3.7-max、qwen3.7-plus、qwen3.6-plus、qwen3.6-flash），可使用最新版 Codex。

model_provider = "Model_Studio"
model = "qwen3.7-max"
[model_providers.Model_Studio]
name = "Model_Studio"
base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

Chat/Completions API

适用于仅支持 Chat/Completions API 的模型，需安装 Codex 0.80.0：

model_provider = "Model_Studio"
model = "qwen3.6-plus"
[model_providers.Model_Studio]
name = "Model_Studio"
base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

配置环境变量

macOS
Windows

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

echo $SHELL

根据 Shell 类型设置环境变量：

Zsh
Bash

# 将 YOUR_API_KEY 替换为千问 AI 平台 API Key
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc

执行以下命令使环境变量生效。

Zsh
Bash

source ~/.zshrc

CMD
PowerShell

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

REM 将 YOUR_API_KEY 替换为千问 AI 平台 API Key
setx OPENAI_API_KEY "YOUR_API_KEY"

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

echo %OPENAI_API_KEY%

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

# 将 YOUR_API_KEY 替换为千问 AI 平台 API Key
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)

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

echo $env:OPENAI_API_KEY

常见问题

第三方工具提示"不支持国内模型"或"检查被拒 / Bad request (400)"怎么办？

原因：部分第三方管理工具（如 CC-Switch）在切换供应商时会发起"健康检查/连接测试"探测请求，该探测请求的格式与 Codex 实际调用的请求格式不同，千问 AI 平台网关可能因此返回 400 Bad request 并提示"检查被拒"，工具据此显示"不支持国内模型"。此提示仅代表健康检查探测未通过，并不代表千问 AI 平台不支持国内模型，也不影响 Codex 的实际使用。

千问 AI 平台支持通过 Codex 使用 qwen3.7-max、qwen3.7-plus、qwen3.6-plus、qwen3.6-flash、glm-5 等国内模型，配置方式详见上文配置接入凭证。

解决方案：建议参照上文配置说明，直接在 ~/.codex/config.toml 中完成配置，无需依赖第三方工具的健康检查结果；配置完成后参照使用 Codex启动 Codex，若能正常进入对话界面即表示可正常使用国内模型。

报错 wire_api 配置问题怎么办？

原因：Codex 新版本不再支持 wire_api = "chat" 配置。根据版本不同，可能出现以下报错：

wire_api = "chat" is no longer supported
unknown configuration field wire_api

解决方案：

报错 wire_api = "chat" is no longer supported：将配置文件中的 wire_api 改为 responses，并确认 base_url 配置正确。详见上文配置接入凭证中对应方案的配置示例。
报错 unknown configuration field wire_api：从配置文件 ~/.codex/config.toml 的对应 provider 节中删除 wire_api 字段。

报错 unexpected status 401 Unauthorized 怎么办？

原因：

误用了其他方案的 API Key（Token Plan 个人版、Token Plan 团队版和按量计费的 API Key 互不相通）
订阅过期
API Key 复制不完整、有空格或拼写错误

解决方案：

确认使用的是所选方案的专属 API Key。
前往对应方案的管理页面确认订阅是否过期。
重新复制 API Key，确保完整且无空格。
如以上均正常仍报错，可在对应方案的管理页面重置 API Key，重置后请使用新 API Key 进行配置。

报错 unexpected status 404 Not Found 怎么办？

原因：配置文件中的 base_url 或 wire_api 填写错误。 解决方案：确认 base_url 和 wire_api 与所选方案的配置一致。参见上文配置接入凭证中对应方案的配置示例。

报错 stream disconnected before completion: stream closed before response.completed 怎么办？

原因：Codex 与服务端的流式连接在响应完成前断开。常见于以下场景：

对话线程过长，Codex 触发上下文压缩时请求失败
网络不稳定，SSE 或 WebSocket 连接中途断开
服务端过载或触发限流，提前终止连接

解决方案：

开启新的对话线程，避免单个线程积累过多上下文。
检查网络连接是否稳定，关闭 VPN 或代理后重试。
等待一段时间后重试，Codex 内置了自动重试机制，多数情况下重试可恢复。

​安装 Codex

​配置接入凭证

​配置模型元数据

​Token Plan 个人版

​Responses API（qwen3.8-max-preview、qwen3.7-max、qwen3.7-plus、qwen3.6-plus、qwen3.6-flash）

​Chat/Completions API（其他模型）

​配置环境变量

​Token Plan 团队版

​Responses API（qwen3.8-max-preview、qwen3.7-max、qwen3.7-plus、qwen3.6-plus、qwen3.6-flash）

​Chat/Completions API（其他模型）

​配置环境变量

​接入图像生成模型

​步骤一：创建 Skill

​步骤二：使用

​使用 Codex

​配置按量计费

​Responses API

​Chat/Completions API

​配置环境变量

​常见问题

​第三方工具提示"不支持国内模型"或"检查被拒 / Bad request (400)"怎么办？

​报错 wire_api 配置问题怎么办？

​报错 unexpected status 401 Unauthorized 怎么办？

​报错 unexpected status 404 Not Found 怎么办？

​报错 stream disconnected before completion: stream closed before response.completed 怎么办？

安装 Codex

配置接入凭证

配置模型元数据

Token Plan 个人版

Responses API（qwen3.8-max-preview、qwen3.7-max、qwen3.7-plus、qwen3.6-plus、qwen3.6-flash）

Chat/Completions API（其他模型）

配置环境变量

Token Plan 团队版

Responses API（qwen3.8-max-preview、qwen3.7-max、qwen3.7-plus、qwen3.6-plus、qwen3.6-flash）

Chat/Completions API（其他模型）

配置环境变量

接入图像生成模型

步骤一：创建 Skill

步骤二：使用

使用 Codex

配置按量计费

Responses API

Chat/Completions API

配置环境变量

常见问题

第三方工具提示"不支持国内模型"或"检查被拒 / Bad request (400)"怎么办？

报错 wire_api 配置问题怎么办？

报错 unexpected status 401 Unauthorized 怎么办？

报错 unexpected status 404 Not Found 怎么办？

报错 stream disconnected before completion: stream closed before response.completed 怎么办？