国产模型接入教程
Codex · 模型接入

选择模型供应商

下方展示当前供应商的完整配置,切换后查看对应方案。

配置实操 / macOS · Linux · Windows

Codex 接入通义千问

配置百炼 Responses 接口,分清按量 API、Coding Plan 和 Token Plan。

6 个步骤约 9 分钟文档核对 2026-10-29
开始第一步
接入配置示意Responses API
Codex通义千问
MODEL
qwen3.7-max(按量示例)
BASE URL
https://YOUR_WORKSPACE_ID.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
AUTH
百炼对应地域、业务空间和方案的 Key
已安装客户端 模型权限与额度 原配置已备份

配置速查

接口与凭据必须对应同一方案
方案北京地区 Base URL认证
按量https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1对应地域/空间 Key
Coding Planhttps://coding.dashscope.aliyuncs.com/v1套餐专属 Key
Token Planhttps://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1个人或团队专属 Key
01

确认版本、方案和模型权限

运行 codex --version,未安装可执行 npm install -g @openai/codex。备份用户级 ~/.codex/config.toml。本文示例是北京地区按量接入;qwen3.7-max 来自百炼 Codex 文档,先确认账号可调用且模型支持 Responses。

按官方文档核对,未使用付费 Key 做端到端实测。先在测试项目运行,再核对供应商控制台用量;聊天成功不代表工具调用和全部联网功能都可用。

02

macOS / Linux:设置 API Key

本文用 BAILIAN_API_KEY 隔离其他供应商凭据,并由配置中的 env_key 引用,这是可自定义的环境变量名。Windows 用户跳到下一步,之后从设置了变量的终端启动 Codex。

Bash / zsh
export BAILIAN_API_KEY="YOUR_BAILIAN_API_KEY"
03

Windows:设置 API Key

Windows 用户使用这段 PowerShell 配置;macOS / Linux 用户跳过本步。变量只对当前终端及其子进程生效。

PowerShell
$env:BAILIAN_API_KEY="YOUR_BAILIAN_API_KEY"
04

合并用户级 TOML 配置

替换 YOUR_WORKSPACE_ID。model 与 model_provider 必须放在 TOML 顶层,即各 [表名] 之前;不要重复创建同名 provider。使用套餐时地址、Key、模型需要一起匹配,不是只换一个 Key。

~/.codex/config.toml
model = "qwen3.7-max"
model_provider = "bailian"
web_search = "disabled"

[model_providers.bailian]
name = "Bailian"
base_url = "https://YOUR_WORKSPACE_ID.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"
env_key = "BAILIAN_API_KEY"
wire_api = "responses"
05

模型菜单与协议排错

需要 /model 中的模型切换时,按百炼官方教程创建 ~/.codex/model-catalog.local.json,复制所用方案的完整元数据,并在 TOML 顶层添加 model_catalog_json = "~/.codex/model-catalog.local.json"。模型目录不会开通账号权限。

旧教程中的 wire_api = "chat" 不适用于此路径。若报 unknown configuration field wire_api,记录版本并按百炼 FAQ 处理;仅删字段不能证明服务支持 Responses。流式断流时检查 response.completed 和工具调用兼容性。

06

验证与恢复

在测试目录运行 codex,用 /status 核对模型与供应商,再检查下面任务的文件引用和平台用量。恢复时还原 config.toml 备份并清理新增环境变量,重启客户端。

第一次项目任务
请只读当前项目:说明启动命令、入口文件和测试命令,每条结论引用实际文件路径;找不到就写未找到。不要修改文件,也不要安装依赖。
TROUBLESHOOTING

卡在哪一步?按错误定位。

401 / 403

凭据、套餐或模型权限不匹配

检查 Key 来源、地域和套餐;检查当前进程是否读取了旧认证。

404

地址或 API 协议不匹配

使用本文对应协议的 Base URL,不手工追加请求路径。

429

额度或调用频率限制

到供应商控制台核对余额、套餐与限流,降低并发后重试。

工具调用失败

文件权限、客户端版本或模型兼容性问题

先确认工作目录,验证一次只读文件任务,再增加其他能力。

完成前,确认这四项

  • 客户端版本可用,原配置已备份
  • 接口地址、Key 和模型属于同一产品方案
  • 只读任务引用了真实文件,并已核对调用用量
  • 没有提交真实 Key,能够还原原配置

官方参考来源

配置依据以下资料整理,验证任务与排查顺序为本站编辑建议。模型和客户端更新后,请重新核对接口与支持范围。

01https://help.aliyun.com/zh/model-studio/codex02https://help.aliyun.com/en/model-studio/base-url03https://learn.chatgpt.com/docs/enterprise/gateway-compatibility04https://learn.chatgpt.com/docs/config-file/config-reference
查看其他工具的接入方式