跳转到内容

Unexpected status 502 Bad Gateway:Codex

Quick fix

在 ~/.codex/.env 设置 NO_PROXY=127.0.0.1,localhost,::1,让 Codex 直连 CC Switch 本地端口。

报错原文
Unexpected status 502 Bad Gateway: Unknown error, url: http://127.0.0.1:15721/v1/responses

Codex 会读取系统代理或 `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 失败;如果本地直连设置无效,需要继续排查上游网络。

  1. 检查 `~/.codex/.env` 中是否设置了 `HTTP_PROXY` 或 `HTTPS_PROXY`;Windows 还应检查系统代理设置。

  2. 在 `~/.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
  3. 重新使用 Codex 访问 CC Switch;多名用户确认创建或修改该 `.env` 文件后问题解决。

  4. 如果仍然报错,可临时关闭 Clash 系统代理或切换到 TUN 模式后重试;这些方法对部分 Windows 和 macOS 用户有效,但并非所有报告都有效。

  5. 若绕过本地代理后仍返回 502,继续检查上游 provider 是否返回 502,以及 CC Switch 到上游是否发生连接、超时或 TLS 错误。

ToolCodex
Version受影响报告:CC Switch 3.14.1 - 3.16.4
PlatformsWindowsmacOS
最新版 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。本站不分发任何软件。