CodeX桌面版报错踩坑解决教程

CodeX桌面版 使用第三方 API 代理 401 报错踩坑解决教程

一、问题描述

使用第三方代理时，CodeX桌面版始终报错 401 invalid_api_key，请求并未走配置的代理地址，而是直接打到了官方 api.openai.com，导致代理完全失效。

二、错误根源：配置文件写法不被CodeX识别

如果代理地址写在config.toml的顶层字段，那么CodeX桌面版是不识别顶层的base_url配置的，它只会读取model_providers分段里的配置，导致代理地址完全不生效，直接请求 OpenAI 官方接口，最终报 401 错误。

# ❌ 这种顶层base_url写法，只对命令行codex生效，桌面版不识别
base_url = "https://api.xxx.com"
model = "gpt-5.4"

三、解决过程

只需要修改 .../.codex/config.toml 这一个文件。

关键修改点：

1. 新增model_provider字段，指定使用哪个自定义 provider
2. 新增[model_providers.aiproxy]分段，定义你的代理服务配置
3. 把base_url放到该分段下

model = "gpt-5.4"
model_provider = "aiproxy"  # 指定使用自定义的aiproxy provider

# 定义自定义的第三方代理服务
[model_providers.aiproxy]
name = "AIPRoxy"
base_url = "https://api.xxx.com"  # 代理地址
wire_api = "responses"  # 指定走OpenAI的responses API

记得删除env_key配置，恢复从auth.json读取 Key，env_key = "OPENAI_API_KEY"会导致 CodeX 强制从系统环境变量读取 API Key，而不是从你已配置好的auth.json读取。