Codex

配置模型元数据

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

1. 新建文件 ~/.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"],
         "shell_type": "default",
         "visibility": "list",
         "supported_in_api": true,
         "priority": 1,
         "base_instructions": "",
         "support_verbosity": false,
         "supports_reasoning_summaries": false,
         "experimental_supported_tools": [],
         "truncation_policy": {
           "mode": "bytes",
           "limit": 10000
         }
       }
     ]
   }

2. 在 ~/.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。

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"

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"

Token Plan 团队版

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

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"

npm install -g @openai/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"

Coding Plan

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

npm install -g @openai/codex@0.80.0

model_provider = "Model_Studio_Coding_Plan"
model = "qwen3.7-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环境变量设置为百炼 API Key。可用模型参见支持的模型。

根据地域设置base_url，API Key 须与所选地域对应：

• 华北2（北京）：https://dashscope.aliyuncs.com/compatible-mode/v1

• 新加坡：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1，请将WorkspaceId替换为真实的获取Workspace ID

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

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"

npm install -g @openai/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"

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

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

说明：百炼支持通过 Codex 使用 qwen3.7-max、qwen3.7-plus、qwen3.6-plus、qwen3.6-flash、glm-5 等中国内地模型，配置方式详见上文配置接入凭证。

解决方案：建议参照上文配置接入凭证，直接在~/.codex/config.toml中完成配置，无需依赖第三方工具的健康检查结果；配置完成后参照验证配置启动 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 团队版、Coding 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 内置了自动重试机制，多数情况下重试可恢复。