Codex 可通过 QwenCloud Token Plan 的 Responses 兼容端点调用正式型号 qwen4-max;为此配置 Token Plan 专属 API Key,并通过只读 smoke 命令验证连通性。
适合的任务:在 Codex CLI 中使用 QwenCloud Token Plan 的 Qwen4-Max 编码和推理
不适合的任务:使用按量计费方案或其他套餐的 API Key;不同方案的 Key 不通用
适用的模型版本:qwen4-max;不使用 qwen4-max-preview
适用的客户端、Agent 或 API:Codex CLI、QwenCloud Token Plan Responses API
推荐的推理档位和参数:默认 reasoning_effort=high、thinking_budget=131072;复杂任务可考虑 xhigh,以 Codex 可选档位为准
在 ~/.codex/config.toml(Windows:%USERPROFILE%\.codex\config.toml)中加入:
model_provider = "Token_Plan"
model = "qwen4-max"
[model_providers.Token_Plan]
name = "Token_Plan"
base_url = "https://token-plan.maas.qwencloudapi.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"官方 Quick Start 的初始 model 值是 auto。这里直接指定官方模型目录中列出的 qwen4-max,便于固定使用此模型;也可按官方步骤配置模型目录后,用 codex -m qwen4-max 切换。未配置模型元数据时,Codex 可能提示 metadata 未找到,但官方说明这不影响 config.toml 中指定的模型调用。
安全设置 Token Plan 个人版 API Key 到环境变量,不要把真实 Key 写进配置文件、仓库或命令历史:
read -s OPENAI_API_KEY
export OPENAI_API_KEY在不含敏感项目文件的目录中运行只读 smoke test:
cd /tmp
codex exec --sandbox read-only -m qwen4-max "只回复 OK;不要调用工具或访问文件。"QwenCloud 官方验证示例是 codex exec "Hello"。上面的命令是在其基础上显式指定模型并增加 --sandbox read-only,以限制本地命令执行权限;这是安全适配,不是 QwenCloud 文档原样命令。此命令会发起一次模型请求,需先在对应 Token Plan 中创建或查看个人版 API Key。
| 配置项 | 值 |
|---|---|
| 套餐 | Token Plan 个人版 |
| Base URL | https://token-plan.maas.qwencloudapi.com/compatible-mode/v1 |
| API 协议 | Responses(wire_api = "responses") |
| API Key 环境变量 | OPENAI_API_KEY |
| 模型 ID | qwen4-max |
| 上下文窗口 | 1,000,000 tokens |
| 最大输出 | 非思考模式 131,072 tokens;思考与最终回答合计 262,144 tokens |
在 QwenCloud Token Plan 个人版页面创建或查看 API Key。
将该 Key 安全设置为 OPENAI_API_KEY,写入上述 Codex 配置。
在 /tmp 执行只读 smoke test;得到 OK 表示基础请求成功。不要将 Token Plan Key 用于按量计费端点。
官方 Codex 页的 Quick Start 给出 Token_Plan provider、Token Plan base URL、OPENAI_API_KEY、wire_api = "responses",并以 codex exec "Hello" 验证。
同页模型目录列出正式型号 qwen4-max、默认推理档位 high、支持 low / high / xhigh,以及 1,000,000-token 上下文窗口;预览型号另列为 qwen4-max-preview。
页面说明 Qwen4-Max 默认 thinking_budget=131072,非思考模式最大输出 131,072 tokens,思考与最终回答合计最多 262,144 tokens。
官方 FAQ 指出 Token Plan 个人版、团队版和按量计费的 API Key 不可互换;Codex 0.94.0 及之后版本不再支持 wire_api = "chat"。
本配置只适用于 QwenCloud Token Plan 个人版。团队版需使用团队分配的 Key;按量计费需改用该方案自己的配置和 Key。
正式型号为 qwen4-max。预览型号 qwen4-max-preview 及其专属元数据未纳入本文配置。
配置与 smoke 命令适用于 Codex CLI。若 Codex 版本报 wire_api 未知字段,按官方 FAQ 删除该字段;若报 wire_api = "chat" 不支持,则确认配置使用 responses。
smoke test 使用只读沙箱,但仍会向云端发送提示词并消耗套餐额度;本文未使用真实 Key 执行请求。
于 2026-11-17 通过 Tabbit 已安装 CLI 打开并核对 QwenCloud 官方 Codex 文档。配置字段、端点、环境变量和模型元数据取自页面;已用本机 codex exec --help 确认 --sandbox read-only 参数可用。未配置或调用真实 API Key,未执行在线 smoke test。
Qwen4-Max