codex无法调用外部api的根本原因是工具不匹配:官方@openai/codex cli完全不支持第三方provider,必须改用wecode cli或codex desktop;同时需正确配置config.toml中的model_provider、[model_providers.xxx]块及wire_api,并通过环境变量注入api key,启动时强制指定--profile参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Codex无法调用外部API接口,通常不是模型没选对或网络不通这么简单——它卡在配置路径、工具版本、协议匹配三重关卡上,哪怕Base URL和API Key都正确,也可能因CLI不支持自定义provider而全程静默失败。
先确认你用的是哪个Codex工具
官方 @openai/codex CLI(npm全局安装版)【完全不支持第三方Provider】,它只认 OPENAI_API_KEY 和默认 https://api.openai.com/v1,你在 config.toml 里写的 model_provider = "xxx" 它根本不会读。
必须改用真正支持自定义中转站的工具:wecode CLI 或 Codex Desktop(App版)。
验证当前工具类型:运行 codex --version,若输出含 @openai/codex 字样,立即停用;改用 npx wecode 启动。
检查 config.toml 中 provider 配置是否完整
打开配置文件:
macOS/Linux 路径为 ~/.codex/config.toml,Windows 为 C:\Users\你的用户名\.codex\config.toml。
确保文件顶部有明确指定 provider 的全局配置:
model = "gpt-5.5"model_provider = "my_proxy"
在文件末尾添加完整 provider 块,注意字段名大小写和缩进不可省略:
[model_providers.my_proxy]name = "My Proxy API"base_url = "https://api.your-proxy-domain.com/v1"env_key = "MY_PROXY_API_KEY"wire_api = "chat"
⚠️ wire_api 必须填 chat 或 responses,不能留空或拼错;填 responses 时需确认中转站真实支持 /v1/responses 接口,否则请求直接 404。
把 API Key 放进系统环境变量(不是 config.toml!)
第一步:在终端(PowerShell/WSL/zsh)中临时设置并测试:
$env:MY_PROXY_API_KEY="sk-xxxxxx"(Windows PowerShell)export MY_PROXY_API_KEY="sk-xxxxxx"(macOS/Linux)
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
第二步:永久生效(避免重启后失效):
Windows:按 Win+S → 搜索“环境变量” → 编辑系统环境变量 → 系统变量中新建 → 变量名 MY_PROXY_API_KEY,变量值粘贴完整密钥(前后【不能有空格、换行、英文引号】)。
macOS/Linux:执行 echo 'export MY_PROXY_API_KEY="sk-xxxxxx"' >> ~/.zshrc && source ~/.zshrc。
第三步:验证是否写入成功:
Windows PowerShell 运行:echo $env:MY_PROXY_API_KEY;
macOS/Linux 运行:echo $MY_PROXY_API_KEY;
必须原样输出密钥,否则 Codex 启动时会报 missing api key。
启动时强制指定 profile(关键一步)
1. 在 config.toml 中定义一个 profile,例如:
[profiles.myapi]model_provider = "my_proxy"model = "gpt-5.5"
2. 启动命令必须带 --profile 参数:
npx wecode --profile myapi
3. 如果跳过这步,wecode 会默认加载内置 profile,完全忽略你配的 my_proxy。
启动后,在界面左下角查看当前 active provider 名称,确认显示为 my_proxy 而非 openai。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










