Unexpected status 502 Bad Gateway:Codex
Quick fix
在 ~/.codex/.env 设置 NO_PROXY=127.0.0.1,localhost,::1,让 Codex 直连 CC Switch 本地端口。
Symptom
Section titled “Symptom”Unexpected status 502 Bad Gateway: Unknown error, url: http://127.0.0.1:15721/v1/responsesCodex 会读取系统代理或 `HTTP_PROXY`、`HTTPS_PROXY` 等环境变量。本应发往 CC Switch 本地 `/v1/responses` 端点的请求可能被 Clash 等代理软件接管;代理无法正确处理该本地请求,因而返回 502。多个用户确认,为 localhost 和 127.0.0.1 设置直连或 `NO_PROXY` 后恢复正常。
报告中的具体表现并不完全一致:关闭系统代理、改用 TUN 模式或调整 Clash 规则对部分用户有效,但也有用户表示 TUN 模式仍会报错,且规则模式与全局模式的结果存在差异。维护者还指出,502 也可能来自上游 provider 的透传,或 CC Switch 连接上游时发生连接、超时或 TLS 失败;如果本地直连设置无效,需要继续排查上游网络。
检查 `~/.codex/.env` 中是否设置了 `HTTP_PROXY` 或 `HTTPS_PROXY`;Windows 还应检查系统代理设置。
在 `~/.codex/.env` 中加入本地地址直连配置。下面的 `7890` 是 issue 中的代理端口;如果你的代理端口不同,应使用实际端口。
~/.codex/.env HTTP_PROXY=http://127.0.0.1:7890/HTTPS_PROXY=http://127.0.0.1:7890/NO_PROXY=127.0.0.1,localhost,::1重新使用 Codex 访问 CC Switch;多名用户确认创建或修改该 `.env` 文件后问题解决。
如果仍然报错,可临时关闭 Clash 系统代理或切换到 TUN 模式后重试;这些方法对部分 Windows 和 macOS 用户有效,但并非所有报告都有效。
若绕过本地代理后仍返回 502,继续检查上游 provider 是否返回 502,以及 CC Switch 到上游是否发生连接、超时或 TLS 错误。
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 7 个真实 issue
- #2662mac intel电脑codex接其他的api错误
- #3529使用3.16.1版本,按照教程使用codex配置deepseek,启动路由,启动codex提问,发生错误
- #3989使用DEEPSEEK报错unexpected status 502 Bad Gateway: Unknown error, url: http://127.0.0.1:15721/v1/responses
- #4686Unexpected status 502 Bad Gateway: Unknown error, url: http://127.0.0.1:15721/v1/responses
- #4773unexpected status 502 Bad Gateway: Unknown error, url: http://127.0.0.1:57321/v1/responses
- #4789[Bug] Windows 11 + Clash Verge 系统代理模式:Codex 经 cc-switch 转发 502;切到 TUN 模式/关代理后立即恢复(Claude Code 不受影响)
- #6544关于登录遇到的问题
- 最新版 CC Switch 接入 DeepSeek 并开启路由后仍返回这个错误,怎么解决?
- 优先在 `~/.codex/.env` 设置 `NO_PROXY=127.0.0.1,localhost,::1`。相关用户确认问题来自本地路由与 Clash 代理冲突,关闭 Clash 后也能恢复。
- 已经给 Clash 配置 localhost 和 127.0.0.1 直连,为什么还是不行?
- 线程中确有用户反馈直连规则无效。可改用 Codex 自身的 `~/.codex/.env` 设置 `NO_PROXY`,或临时关闭系统代理;若仍失败,则按维护者说明检查上游返回及连接、超时或 TLS 问题。
- 切换到 TUN 模式一定能解决吗?
- 不一定。主报告中切到 TUN 模式会立即恢复,但另有用户反馈设置 TUN 后仍然报错,因此更可靠的排查方向是确认 Codex 对 `127.0.0.1` 和 `localhost` 不走代理。
- 为什么 Claude Code 正常,只有 Codex 报错?
- 相关报告显示,同一份 CC Switch 配置和同一上游下,Claude Code 正常,而 Codex 桌面 App、VSCode 插件和 CLI 都会失败;线程将其归因于 Codex 读取系统代理或环境变量后,本地 `/v1/responses` 请求被代理接管。
这是一个非官方社区 wiki,与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。