很多开发者日常用 Codex CLI 做终端代码补全、代码解释、bug 修复，但默认依赖 OpenAI 模型，不仅访问不稳定、有网络限制，还存在代码数据外传的风险。
其实 Codex 支持自定义模型提供商，只需简单修改 config.toml 配置文件，就能无缝切换为阿里云通义千问代码模型。千问系列模型对中文场景、国内代码适配性更好，响应速度更快，完全适配日常开发编码、脚本生成、代码重构等场景。
今天分享一套零门槛、可直接复用的配置方案，3分钟搞定 Codex 接入通义千问，全程无复杂操作，新手也能一次成功✅
一、前置准备：环境与密钥配置
1. 安装 Codex CLI
如果还未安装 Codex，先通过 npm 全局安装官方客户端，确保终端可直接调用 codex 命令：
npm install -g @openai/codex安装完成后，执行以下命令验证是否安装成功：
codex --version输出版本号即代表环境就绪。
2. 获取阿里云百炼 API Key
Codex 调用千问模型，需要依托阿里云百炼平台 API 接口，步骤如下：
- 登录 阿里云百炼控制台（官方平台，安全可靠）；
- 进入「API 密钥管理」页面，点击创建 API Key；
- 复制生成的
sk-xxxx格式密钥（务必妥善保存，仅展示一次）； - 确认密钥已开通通义千问代码系列模型调用权限。
二、核心操作：修改 config.toml 配置文件
Codex 所有自定义模型、接口、参数配置，均依赖根目录下的 config.toml 文件，我们只需修改该文件即可完成模型替换。
1. 找到/创建配置文件
不同系统配置文件路径统一，操作命令如下：
# Mac / Linux
# 创建配置目录（不存在则新建）
mkdir -p ~/.codex
# 编辑配置文件
vim ~/.codex/config.toml# Windows（CMD/PowerShell）
notepad %USERPROFILE%\.codex\config.toml2. 完整千问模型配置（直接复制复用）
清空原有默认配置，粘贴以下完整 TOML 配置，适配通义千问代码专用模型，兼容 Codex 全部编码场景：
# 核心：指定自定义模型提供商
model_provider = "openai"
# 选用通义千问代码最优模型，可按需替换 qwen-coder-14b、qwen3.6-plus 等
model = "qwen-coder-7b-instruct"
# 阿里云百炼统一接口地址（固定无需修改）
base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"
# 你的百炼 API 密钥（替换为自己的 sk-xxx 密钥）
api_key = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# 模型通用参数（适配代码场景，优化生成效果）
temperature = 0.2 # 低随机性，代码更严谨稳定
max_tokens = 4096 # 最大生成长度，满足长代码、脚本生成
top_p = 0.95
frequency_penalty = 0.13. 关键配置说明（新手必看）
- model_provider：固定填 openai，因为千问兼容 OpenAI 接口格式，Codex 可直接适配；
- base_url：阿里云百炼兼容接口地址，固定不变，无需改动；
- model：支持千问全系代码模型，日常开发推荐
qwen-coder-7b-instruct，复杂场景可换 14B/32B 版本； - api_key：务必替换为自己的百炼密钥，密钥错误会直接调用失败。
三、验证配置：测试 Codex 千问调用效果
保存配置文件后，无需重启服务，直接在终端执行 Codex 命令测试，快速验证是否配置成功。
输入简单代码生成测试指令：
codex 写一个Python快速排序算法，附带详细注释如果终端快速输出规范、带注释的代码，即代表千问模型配置生效，后续所有 Codex 编码调用都会默认使用通义千问模型。
四、常见报错 & 排错方案
1. 调用报错 401 权限不足
原因：API 密钥错误、过期或未开通模型权限 解决方案：重新生成百炼 API Key，替换配置文件中的api_key，确认密钥已激活。
2. 404 接口地址错误
原因：base_url 填写错误 解决方案：严格使用文档中固定的百炼兼容接口，不要随意修改域名和路径。
3. 无响应、超时
原因：网络波动或模型参数超限 解决方案：检查网络，适当调低 max_tokens，重启终端重新调用。
五、切换千问模型的核心优势
- 国内极速响应：无需代理，接口访问稳定，延迟极低；
- 代码适配性强：千问代码模型针对中文注释、国内业务代码、主流框架深度优化；
- 数据更安全：代码数据不经过海外服务器，适配本地开发、私密项目；
- 成本更低：百炼平台免费额度充足，日常个人开发完全够用。
六、总结
Codex 接入通义千问的核心，就是通过config.toml 自定义模型接口、密钥和参数，摒弃默认 OpenAI 模型。整套配置简单高效，一次设置永久生效，完美解决 Codex 海外模型访问慢、不稳定、数据不安全的痛点。
如果你日常依赖 Codex 做终端编码、代码调试、脚本生成，强烈建议切换国产千问模型，开发体验直接拉满！
码字不易，亲测有效！有问题欢迎评论区交流～
