必须将 Codex 请求导向已购第三方 API 端点,先创建 ~/.codex 目录并新建 config.toml 与 auth.json;再在 config.toml 中设置 model="qwen2.5-72b"、model_provider="aliyun",配置 aliyun provider 的 base_url、env_key 和 requires_openai_auth=false;最后通过环境变量安全注入 DASHSCOPE_API_KEY 并重启验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想让 Codex 调用 DeepSeek、通义千问或 AutoDL 等第三方大模型,而不是被限制在 OpenAI 官方额度内,就必须绕过默认通道,把请求精准导向你已付费购买的 API 端点——这一步不做对,后续所有操作都发不出请求。
确认配置文件位置并创建必要目录
先找到 Codex 的配置根目录,不同系统路径不同,必须一步到位,否则改了文件也加载不到:
Windows 用户打开资源管理器,地址栏粘贴 C:\Users\你的用户名\.codex(需开启“显示隐藏文件”);
macOS 或 Linux 用户直接终端执行 ls ~/.codex,若提示 no such file,则运行 mkdir -p ~/.codex 创建目录。
【注意:.codex 是隐藏文件夹,Windows 资源管理器默认不显示,必须手动勾选“隐藏的项目”才看得见】
进入该目录后,检查是否存在 config.toml 和 auth.json。任一缺失,就用文本编辑器新建空文件,保存为对应名称——文件名拼错一个字母(比如写成 config.toml.txt)会导致整个配置失效。
写入核心配置:config.toml
用 VS Code、Notepad++ 或系统自带编辑器打开 config.toml,按顺序填入以下内容:
第一步:设置全局模型与 provider 名称
在文件最顶部写入:
model = "qwen2.5-72b"
model_provider = "aliyun"
第二步:定义 provider 具体参数
在文件末尾另起两行,添加:
[model_providers.aliyun]
name = "阿里云百炼"
base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"
env_key = "DASHSCOPE_API_KEY"
wire_api = "responses"
【base_url 必须以 /v1 结尾,少一个斜杠或写成 /v1/ 都会返回 404】
第三步:关闭官方认证强制校验
在同一段 [model_providers.aliyun] 下追加一行:
requires_openai_auth = false
这句不加,Codex 会在启动时强行弹出登录窗口,哪怕你只打算本地调用第三方模型。
安全注入 API Key:通过环境变量
方法一:临时生效(适合调试)
Windows 命令提示符中执行:set DASHSCOPE_API_KEY=sk-xxxxxxxxxxxxxxxx
macOS/Linux 终端执行:export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxxxx"
⚠️ 关闭终端即失效,重启 Codex 前必须重输。
方法二:永久生效(推荐)
Windows:右键“此电脑”→属性→高级系统设置→环境变量→系统变量→新建→变量名填 DASHSCOPE_API_KEY,变量值粘贴你的密钥;
macOS:编辑 ~/.zshrc,末尾加一行 export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxxxx",再执行 source ~/.zshrc;
Linux(Ubuntu/Debian):同 macOS,但可能需改 ~/.bashrc。
【绝对禁止在 config.toml 里明文写 sk-xxx!一旦误传 GitHub 或共享屏幕,密钥立刻泄露】
验证是否连通
保存所有文件,彻底关闭 Codex 桌面客户端(任务管理器里确认 codex.exe 进程已结束);
重新启动 Codex,新建对话,输入一句简单指令如 “输出 hello world”;
观察左下角状态栏:若显示 “Using qwen2.5-72b via 阿里云百炼”,且响应内容来自通义千问而非 GPT,则配置成功。


















