Codex CLI 接入阿里云百炼免费额度：config.toml 自定义 model_providers 教程（含硅基流动方案）

准备

• Node.js（百炼文档要求 v18.0+，SiliconFlow 文档建议 20 LTS+）
• 阿里云百炼 API Key（获取与配置 API Key）
• 百炼业务空间 ID（Workspace ID），用来拼按量计费的 Base URL

步骤

1. 01

   安装 Codex CLI

   用 npm 全局安装，codex --version 有输出即成功。Windows 用户建议在 WSL2 里安装。

   bash复制

   npm install -g @openai/codex
   codex --version

2. 02

   先弄清楚：为什么有的平台接不上

   Codex 官方文档说明，自定义 model provider 定义了 Codex 如何连接模型（base_url、wire_api、鉴权方式）。SiliconFlow 文档指出 Codex 从 v0.80.0 起采用 Responses API；百炼文档也说明新版 Codex 已不再支持 wire_api = "chat"。

   所以选平台时先确认：它是否提供 OpenAI Responses API 兼容接口。百炼按量计费下支持 Responses API 的模型（文档示例为 qwen3.7-max）可以直接用最新版 Codex。

3. 03

   把百炼 API Key 写进环境变量

   Codex 通过 env_key 指定从哪个环境变量读 Key。按百炼文档设置 OPENAI_API_KEY（macOS zsh 示例，bash 用户写进 ~/.bash_profile）：

   bash复制

   echo 'export OPENAI_API_KEY="你的百炼API Key"' >> ~/.zshrc
   source ~/.zshrc

4. 04

   编辑 ~/.codex/config.toml（Responses API）

   按百炼文档的按量计费配置写入下面内容，把 {WorkspaceId} 换成你的业务空间 ID。北京地域地址为 https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1，新人免费额度只适用于北京地域。

   注意：Codex 官方文档说明自定义 provider 不能使用保留 ID openai、ollama、lmstudio，而且 model_provider / model_providers 只能写在用户级 ~/.codex/config.toml，写在项目里的 .codex/config.toml 会被忽略。

   toml复制

   model_provider = "Model_Studio"
   model = "qwen3.7-max"
   
   [model_providers.Model_Studio]
   name = "Model_Studio"
   base_url = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"
   env_key = "OPENAI_API_KEY"
   wire_api = "responses"

5. 05

   （可选）配置模型目录，方便 /model 切换

   百炼文档提供了 ~/.codex/model-catalog.local.json 的模型元数据写法，并在 config.toml 中加一行指向它。配好后可用 codex -m 模型ID 指定模型，或在 TUI 里输入 /model 切换。只用一个模型时可以跳过这一步。

   toml复制

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

6. 06

   验证

   新开一个终端，执行 codex，能正常进入对话界面并回复就说明配置成功。

7. 07

   硅基流动（SiliconFlow）用户：用 CC Switch 做协议转换

   SiliconFlow 文档说明它目前提供的是 Chat Completions 接口，和 Codex 的 Responses API 不兼容，官方方案是用 CC Switch 作为本地路由层：

   • 打开 CC Switch → 设置 → 路由，打开路由总开关，并在路由启用中打开 Codex；
   • 在顶部应用切换器选中 Codex，点右上角加号，预设 选 SiliconFlow；
   • 粘贴 SiliconFlow API Key，在 模型映射 里按需修改模型，保存；
   • 终端执行 codex，model 一栏显示所调用的模型名，对话能正常回复即成功。

   CC Switch 是社区开源工具，不归平台审核维护，安装前请自行评估。

注意事项

• wire_api = "chat" 报错：百炼 FAQ 说明，报 wire_api = "chat" is no longer supported 时改为 responses；报 unknown configuration field wire_api 时删掉这个字段。只支持 Chat Completions 的模型，百炼文档的方案是安装旧版 @openai/codex@0.80.0。
• 401 / 404：401 多半是 Key 用错了方案（按量计费、Coding Plan、Token Plan 的 Key 互不相通）；404 是 base_url 或 wire_api 写错。
• 健康检查失败不代表不能用：百炼文档说明 CC Switch 等工具切换供应商时的连接测试可能返回 400，不影响 Codex 实际调用。
• 只想把内置 OpenAI provider 指向代理时，Codex 文档建议用 openai_base_url，不要新建 [model_providers.openai]。

常见问题

相关优惠

• 新人 · 阿里云百炼新人免费额度每个模型 100 万 Tokens（70+ 模型，总额超 7000 万），90 天有效

信息来源

• Codex · Advanced Configuration（Custom model providers）developers.openai.com/codex/config-advanced
• 阿里云百炼 · Codexhelp.aliyun.com/zh/model-studio/codex
• SiliconFlow · Codexdocs.siliconflow.cn/cn/usercases/use-siliconcloud-in-codex
• 阿里云百炼 · Cherry Studio（新人免费额度地域说明）help.aliyun.com/zh/model-studio/cherry-studio

最后核实日期：2026-10-09 · 政策可能随时调整，请以官方页面为准