codex连不上第三方api的根本原因是协议不匹配:codex原生只支持/v1/responses接口,而agnes等第三方仅提供/v1/chat/completions接口,需通过cc-switch等翻译层转换,并改用wecode cli或codex desktop工具,正确配置config.toml、环境变量及清理auth.json残留。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Codex 连不上第三方 API,不是 Key 填错了,而是协议对不上——Codex 原生只认 OpenAI 的 /v1/responses 接口,而 Agnes、PackyCode、Fenno 等绝大多数第三方服务商只提供 /v1/chat/completions 接口,两者结构不兼容,就像英语母语者对着只会说中文的翻译员张嘴说话,再准的 Key 也传不出去。
先确认你用的是哪个 Codex 工具
官方 @openai/codex CLI(npm 全局安装版)【完全不支持第三方 Provider】,它压根不读 config.toml 里的 model_provider 配置,只硬编码走 https://api.openai.com/v1。运行 codex --version,如果输出含 @openai/codex 字样,请立刻停用。
必须改用真正支持自定义中转站的工具:npx wecode 或 Codex Desktop(App 版)。
检查 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!)
方法一(Windows PowerShell):
$env:MY_PROXY_API_KEY="sk-xxxxxx"
方法二(macOS/Linux):
export MY_PROXY_API_KEY="sk-xxxxxx"
⚠️环境变量值前后【不能有空格、换行、英文引号】,否则 Key 会被截断或解析失败。
ChatGPT Atlas(macOS)可在浏览网页时提供即时回复、内容总结与任务辅助。它支持智能建议、信息整理及多场景交互,同时配备可控隐私设置,让用户在使用过程中更加安全安心。针对 macOS 平台优化后,带来流畅自然的浏览体验,适用于办公、学习、创作及日常信息查询等多种场景。
永久生效操作(避免重启终端后失效):
Windows:按 Win+S → 搜索“环境变量” → 编辑系统环境变量 → 系统变量中新建 → 变量名 MY_PROXY_API_KEY,变量值粘贴完整密钥。
macOS/Linux:执行 echo 'export MY_PROXY_API_KEY="sk-xxxxxx"' >> ~/.zshrc && source ~/.zshrc。
彻底清理残留认证信息
如果你之前登录过 ChatGPT 官方账号,~/.codex/auth.json 文件里很可能还存着旧 Token,导致 Codex 误判为官方模式。
删除该文件:
rm -rf ~/.codex/auth.json(macOS/Linux)Remove-Item -Recurse -Force "$env:USERPROFILE\.codex\auth.json"(PowerShell)
这一步不做,Codex 会优先走官方 auth 流程,哪怕你已经配好了第三方 provider,也会静默跳过。
验证代理端口是否就绪(国内用户必做)
Codex 不读系统代理设置,只认明确指定的 HTTP 代理地址。若你在国内网络环境下使用,必须确认本地代理工具(如 Clash、Stash)已监听可访问端口。
在 PowerShell 中执行:netstat -ano | findstr :7897。
若输出中含 TCP 127.0.0.1:7897 且状态为 LISTENING,说明端口已就绪;若无任何输出,需回到代理工具设置中开启「允许来自局域网的连接」并确认 HTTP 代理端口设为 7897。
这一步跳过会导致后续所有配置无效——Codex 会持续超时,因为根本连不到代理入口。
启动时强制指定 profile 参数
使用 wecode 启动时,必须显式指定 profile,否则默认加载 default,可能忽略你刚配好的 provider:
npx wecode --profile my_proxy
其中 my_proxy 必须与 config.toml 中 model_provider = "my_proxy" 的值完全一致,包括大小写和下划线。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










