选择模型供应商
下方展示当前供应商的完整配置,切换后查看对应方案。
- 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 Plan | https://coding.dashscope.aliyuncs.com/v1 | 套餐专属 Key |
| Token Plan | https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 | 个人或团队专属 Key |
确认版本、方案和模型权限
运行 codex --version,未安装可执行 npm install -g @openai/codex。备份用户级 ~/.codex/config.toml。本文示例是北京地区按量接入;qwen3.7-max 来自百炼 Codex 文档,先确认账号可调用且模型支持 Responses。
按官方文档核对,未使用付费 Key 做端到端实测。先在测试项目运行,再核对供应商控制台用量;聊天成功不代表工具调用和全部联网功能都可用。
macOS / Linux:设置 API Key
本文用 BAILIAN_API_KEY 隔离其他供应商凭据,并由配置中的 env_key 引用,这是可自定义的环境变量名。Windows 用户跳到下一步,之后从设置了变量的终端启动 Codex。
export BAILIAN_API_KEY="YOUR_BAILIAN_API_KEY"Windows:设置 API Key
Windows 用户使用这段 PowerShell 配置;macOS / Linux 用户跳过本步。变量只对当前终端及其子进程生效。
$env:BAILIAN_API_KEY="YOUR_BAILIAN_API_KEY"合并用户级 TOML 配置
替换 YOUR_WORKSPACE_ID。model 与 model_provider 必须放在 TOML 顶层,即各 [表名] 之前;不要重复创建同名 provider。使用套餐时地址、Key、模型需要一起匹配,不是只换一个 Key。
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"模型菜单与协议排错
需要 /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 和工具调用兼容性。
验证与恢复
在测试目录运行 codex,用 /status 核对模型与供应商,再检查下面任务的文件引用和平台用量。恢复时还原 config.toml 备份并清理新增环境变量,重启客户端。
请只读当前项目:说明启动命令、入口文件和测试命令,每条结论引用实际文件路径;找不到就写未找到。不要修改文件,也不要安装依赖。卡在哪一步?按错误定位。
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