Codex 通义千问 Qwen 配置教程
Codex 通义千问 Qwen 配置教程
Section titled “Codex 通义千问 Qwen 配置教程”这一篇带你把 Codex 连接到阿里云百炼上的通义千问/Qwen 模型。
它和 DeepSeek 那篇最大的区别是：阿里云百炼会涉及 地域。北京、弗吉尼亚、新加坡的 OpenAI 兼容 Base URL 不一样，API Key 也可能和地域有关。
所以本篇的核心不是“复制一段配置”，而是先确认你自己的百炼地域和模型，再让 Codex 安全写配置。
前置教程：Codex + DeepSeek 配置
如果你还没有跟着一个服务商教程完整跑过“官方参数 -> 环境变量 -> 配置草稿 -> 只读验收”的流程，建议先完成前置教程，再回到本篇。
依据来源：OpenAI Codex 官方手册中的 Custom model providers、
config.toml、环境变量认证说明；阿里云百炼官方文档《OpenAI Chat接口兼容》。
跟着本篇做完后，你应该能做到：
- 分清阿里云账号、百炼控制台、API Key、模型服务开通之间的关系。
- 从阿里云百炼官方文档确认 OpenAI 兼容 Base URL。
- 根据你的地域选择正确地址。
- 从模型列表确认当前可用的 Qwen 模型名。
- 把百炼 API Key 放到 Windows 环境变量
DASHSCOPE_API_KEY。 - 让 Codex 生成 Qwen 配置草稿。
- 写入配置后用只读项目分析验收。
- 配置失败时按地域、Key、模型权限逐项排查。
本篇不做什么
Section titled “本篇不做什么”本篇不做这些事：
- 不讲 DashScope SDK 的完整开发教程。
- 不让你把真实 API Key 发给 Codex。
- 不把北京地域地址默认套到所有用户身上。
- 不直接调用所有 Qwen 模型做横向评测。
- 不在配置没验收前让 Codex 修改业务代码。
本篇只做一件事：
让 Codex 通过阿里云百炼 OpenAI 兼容接口调用 Qwen，并完成一次只读验证。第 1 步：打开阿里云百炼官方文档
Section titled “第 1 步：打开阿里云百炼官方文档”打开这篇官方文档：
https://help.aliyun.com/zh/model-studio/compatibility-of-openai-with-dashscope你要确认 4 件事：
| 要确认的信息 | 官方文档示例 | 你要记下什么 |
|---|---|---|
| 是否支持 OpenAI 兼容接口 | 文档说明千问模型支持 OpenAI 兼容接口 | 确认可以走 OpenAI 兼容路径 |
| 北京地域 Base URL | https://dashscope.aliyuncs.com/compatible-mode/v1 | 如果你用北京地域，就记这个 |
| API Key 环境变量 | DASHSCOPE_API_KEY | 本篇使用这个变量名 |
| 示例模型名 | qwen-plus | 本篇先用 qwen-plus |
第 2 步：先确认你的地域
Section titled “第 2 步：先确认你的地域”这是 Qwen 配置最容易错的地方。
阿里云百炼官方文档给出的 OpenAI SDK Base URL 示例包括：
| 地域 | Base URL |
|---|---|
| 北京 | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| 弗吉尼亚 | https://dashscope-us.aliyuncs.com/compatible-mode/v1 |
| 新加坡 | https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 |
如果你不确定自己用哪个地域，先不要继续。
你可以这样判断：
- 进入阿里云百炼控制台。
- 看当前工作空间或模型服务所在地域。
- 看你创建 API Key 的页面是否有地域提示。
- 看官方文档是否要求某些地域使用不同 Key。
本篇后续默认使用北京地域：
https://dashscope.aliyuncs.com/compatible-mode/v1如果你不是北京地域，请把后续提示词里的 Base URL 换成你自己的地域地址。
第 3 步：确认模型名
Section titled “第 3 步：确认模型名”本篇使用官方文档示例模型：
qwen-plus但你不要只靠本篇记忆模型名。
原因：
- Qwen 模型列表会更新。
- 不同地域可用模型可能不同。
- 有些三方直供模型需要额外开通。
- 有些模型不支持 OpenAI 兼容协议，例如官方文档提示 Qwen-Audio 不支持 OpenAI 兼容协议。
你要在阿里云百炼模型列表里确认：
qwen-plus当前是否可用。- 你的账号是否有权限调用。
- 你的地域是否支持。
- 是否需要先开通模型服务。
第 4 步：准备 API Key
Section titled “第 4 步：准备 API Key”进入阿里云百炼控制台，找到 API Key 管理入口。
你要做：
- 登录阿里云账号。
- 进入百炼控制台。
- 确认已经开通百炼模型服务。
- 创建或复制 API Key。
- 保存到安全位置。
注意：阿里云账号能登录，不代表 API 一定能调用。
你还要确认：
- 账号是否完成必要实名认证或开通流程。
- 百炼服务是否开通。
- 你选择的模型是否开通。
- 账号是否有额度或余额。
- API Key 是否属于当前地域或工作空间。
第 5 步：设置 Windows 环境变量
Section titled “第 5 步：设置 Windows 环境变量”本篇使用官方文档示例环境变量名：
DASHSCOPE_API_KEY方法 A：用 Windows 图形界面设置
Section titled “方法 A：用 Windows 图形界面设置”适合新手。
操作步骤：
- 按
Win键。 - 搜索
环境变量。 - 打开“编辑系统环境变量”。
- 点击“环境变量”。
- 在“用户变量”区域点击“新建”。
- 变量名填写：
DASHSCOPE_API_KEY- 变量值填写你的真实百炼 API Key。
- 点击确定。
- 关闭所有设置窗口。
- 关闭当前 PowerShell。
- 重新打开一个新的 PowerShell。
方法 B：用 PowerShell 设置
Section titled “方法 B：用 PowerShell 设置”适合熟悉 PowerShell 的用户。
打开 PowerShell，运行：
setx DASHSCOPE_API_KEY "你的真实百炼 API Key"注意：
- 引号里替换成你的真实 Key。
- 执行后关闭当前 PowerShell。
- 重新打开 PowerShell 才能读到新变量。
第 6 步：验证环境变量能读取
Section titled “第 6 步：验证环境变量能读取”重新打开 PowerShell 后运行：
$env:DASHSCOPE_API_KEY如果能看到一串 Key，说明环境变量能读到。
截图时一定要遮住输出。
如果没有输出，先不要继续配置 Codex。
按顺序检查：
- 变量名是不是
DASHSCOPE_API_KEY。 - 设置后有没有重开 PowerShell。
- API Key 有没有复制完整。
- 你是不是在另一个 Windows 用户里启动了 Codex。
第 7 步：让 Codex 生成配置草稿
Section titled “第 7 步：让 Codex 生成配置草稿”打开 Codex。
先不要让它直接写文件。
如果你使用北京地域，把下面这段复制给 Codex：
我准备把 Codex 连接到阿里云百炼的通义千问/Qwen OpenAI 兼容接口。
我已经从阿里云百炼官方文档确认：- 地域：北京- base_url：https://dashscope.aliyuncs.com/compatible-mode/v1- model：qwen-plus- API Key 环境变量名：DASHSCOPE_API_KEY
要求：1. 先不要修改任何文件。2. 不要让我把真实 API Key 发给你。3. 请根据当前 Codex 官方配置方式，给出 config.toml 配置草稿。4. provider_id 使用 dashscope。5. 配置里只能写环境变量名，不能写真实 API Key。6. 请解释每一行配置是什么意思。7. 请特别说明是否需要 wire_api 字段；如果你不确定，请写“不确定”，不要编。8. 请提醒我如果不是北京地域，base_url 应该按官方文档替换。你希望 Codex 给出的草稿大概像这样：
model = "qwen-plus"model_provider = "dashscope"
[model_providers.dashscope]name = "Alibaba Cloud Model Studio / Qwen"base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"env_key = "DASHSCOPE_API_KEY"重点检查：
model是qwen-plus或你从官方模型列表确认的模型名。model_provider是dashscope。[model_providers.dashscope]和model_provider对得上。base_url和你的地域一致。env_key是DASHSCOPE_API_KEY，不是你的真实 Key。- 没有乱加看不懂的字段。
关于 wire_api 的说明
Section titled “关于 wire_api 的说明”阿里云百炼官方文档说明千问模型支持 OpenAI 兼容接口，示例是 Chat Completions。
OpenAI Codex 官方手册说明自定义 provider 涉及 Base URL、wire API、认证和可选请求头；当前手册示例里的 wire_api 注释为 responses，并标注这是支持值。
所以本篇继续采用保守做法：
不要自己随便加 wire_api。先让 Codex 根据当前版本解释是否需要。最终用只读任务验收能不能跑通。如果 Codex 要加 wire_api = "chat"，你要追问：
请说明你添加 wire_api = "chat" 的依据来自哪里。当前 Codex 官方手册是否支持这个值？如果没有明确依据，请不要添加。第 8 步：让 Codex 写入配置
Section titled “第 8 步：让 Codex 写入配置”确认配置草稿没问题后，再发：
我确认 Qwen 配置草稿可以继续。
请把 dashscope provider 写入 Codex 用户级配置文件。
要求：1. 修改前先告诉我目标配置文件路径。2. 只修改 Codex 配置文件。3. 不要写入真实 API Key。4. 只写入 env_key = "DASHSCOPE_API_KEY"。5. 如果配置文件不存在，请先说明将创建哪个文件。6. 修改后展示 diff。7. 用中文解释每一处变化。8. 不要修改业务项目文件。Windows 上 Codex 用户级配置一般位于：
C:\Users\你的用户名\.codex\config.toml也可以理解成：
~\.codex\config.toml如果你设置过 CODEX_HOME，让 Codex 先解释实际路径。
第 9 步：重启 Codex
Section titled “第 9 步：重启 Codex”配置文件和环境变量改完后，建议重新启动。
操作顺序：
- 退出当前 Codex。
- 关闭当前 PowerShell。
- 重新打开 PowerShell。
- 进入练习项目目录。
- 重新启动 Codex。
这样可以确保新环境变量和新配置都被读取。
第 10 步：做最小对话验证
Section titled “第 10 步：做最小对话验证”进入 Codex 后，先发：
请只用一句中文回复：Qwen 配置验证开始。如果能正常回复，说明模型调用链路有机会是通的。
如果这里失败，不要继续项目操作，先看错误信息。
第 11 步：做只读项目验证
Section titled “第 11 步：做只读项目验证”最小对话能回复后，再做项目只读验证。
复制这段给 Codex：
请只读分析当前项目，不要修改任何文件，不要创建文件，不要删除文件。
请按下面格式输出：
## 1. 响应状态- 你是否能正常响应：- 如果你能判断，本次使用的模型/provider 是什么：- 如果不能判断，请写“不能判断”：
## 2. 当前项目- 当前目录：- 是否像项目根目录：- 判断依据：
## 3. 只读检查- 你查看了哪些文件或目录：- 有没有运行只读命令：- 有没有修改文件：
## 4. 地域与配置提醒- 当前配置使用的 Base URL 是否是北京地域：- 如果我实际使用其他地域，应该检查什么：
## 5. 下一步建议- 如果配置正常，下一篇应该做什么：- 如果配置异常，先查哪 3 件事：你希望看到：
- Codex 能正常输出。
- 它能读到当前项目路径。
- 它没有修改文件。
- 它能提醒地域和 Base URL 关系。
- 它能说明不确定的地方。
第 12 步：确认没有改业务文件
Section titled “第 12 步：确认没有改业务文件”继续让 Codex 检查：
请检查当前 Git 状态，确认这次 Qwen 配置验证有没有修改业务项目文件。
要求：1. 只运行只读检查。2. 不要修改任何文件。3. 如果工作区噪音较多，请列出变化文件，并说明这些变化是否和本次配置有关。如果工作区干净，本篇验收更稳。
如果有变化，先截图，再让 Codex 解释 diff，先不要提交。
问题 1：API Key 无效或 401
Section titled “问题 1：API Key 无效或 401”优先检查：
DASHSCOPE_API_KEY是否存在。- Key 是否复制完整。
- Key 是否属于当前阿里云账号或百炼工作空间。
- 服务是否已经开通。
- 账号是否有额度或余额。
可以问 Codex：
Codex 提示 DASHSCOPE_API_KEY 相关错误。请只读检查当前环境是否能读取这个环境变量。不要显示完整 Key，只告诉我是否存在，以及长度是否大于 0。问题 2：Base URL 错误
Section titled “问题 2：Base URL 错误”重点检查地域。
如果你是北京地域，本篇示例地址是：
https://dashscope.aliyuncs.com/compatible-mode/v1如果你是弗吉尼亚地域，地址不同。
如果你是新加坡地域，地址里还需要 {WorkspaceId}。
不要把新加坡旧域名继续拿来用。阿里云官方文档提示，新加坡地域旧版域名即将下线，应迁移到工作空间 ID 相关地址。
问题 3：模型不存在
Section titled “问题 3：模型不存在”优先检查：
qwen-plus当前是否在你的地域可用。- 模型服务是否开通。
- 账号是否有权限。
- 是否使用了不支持 OpenAI 兼容协议的模型。
可以问 Codex：
阿里云百炼返回模型不存在或无权限。请不要修改配置，先列出我应该去百炼控制台和官方模型列表确认的 5 个位置。问题 4：能聊天，但代码任务效果不稳定
Section titled “问题 4：能聊天，但代码任务效果不稳定”这不一定是配置错误。
可能原因：
- 当前模型不适合复杂代码代理任务。
- 项目太大。
- 提示词太模糊。
- 上下文太长。
- Codex 权限范围不够。
先用只读项目分析和单文件小改动验证，不要一上来重构。
本篇验收结果
Section titled “本篇验收结果”做到这里，如果满足下面 8 条，就说明 Qwen 配置教程完成：
- 你从阿里云百炼官方文档确认了 OpenAI 兼容接口。
- 你确认了自己的地域。
- 你选择了正确 Base URL。
- 你确认了
qwen-plus或其他 Qwen 模型当前可用。 - 你把 API Key 放进了
DASHSCOPE_API_KEY环境变量。 - Codex 配置文件没有出现真实 API Key。
- Codex 能正常回复一句中文验证消息。
- Codex 能完成一次只读项目分析，并确认没有意外业务文件变化。
下一篇学什么
Section titled “下一篇学什么”下一篇看：第一次让 Codex 阅读项目。
如果你想继续补齐国内模型系列，下一篇服务商教程可以写：Codex + Kimi 配置。
- OpenAI Codex 官方手册：
https://developers.openai.com/codex/codex-manual.md - 阿里云百炼 OpenAI Chat 接口兼容文档：
https://help.aliyun.com/zh/model-studio/compatibility-of-openai-with-dashscope