unexpected status 502 Bad Gateway Codex

Quick fix

在代理软件中将 127.0.0.1 设为直连，或在 Codex 环境变量中配置 NO_PROXY 以绕过本地代理拦截。

Symptom

报错原文复制

unexpected status 502 Bad Gateway: Unknown error, url: http://127.0.0.1:15721/v1/responses

Cause

cc-switch 本身不会主动返回 502。该错误是因为本地代理软件（如 Clash、Clash Verge）拦截了发往 127.0.0.1 的请求，或 Codex 的 reqwest 库读取了系统代理环境变量，导致请求被劫持到代理软件。代理软件无法识别 /v1/responses 路径，从而返回 502 Bad Gateway。部分情况下也可能表现为 WebSocket 升级失败并提示 stream disconnected before completion。

Fix

1. 1

   在代理软件（如 Clash）的配置文件中，将本地地址强制设置为直连模式，并确保规则放在最前面。

   Clash 配置文件

   rules:
     - DOMAIN-SUFFIX,localhost,DIRECT
     - IP-CIDR,127.0.0.0/8,DIRECT,no-resolve

2. 2

   或者在 Codex 的环境变量文件中添加 NO_PROXY，使 Codex 访问本地 cc-switch 时绕过代理直连。

   ~/.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. 3

   如果使用 Clash Verge 等软件，可尝试关闭“系统代理”模式，改用 TUN 模式接管流量。

Affected Versions

ToolCodex

Version未知

PlatformsWindowsmacOS

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关于登录遇到的问题

FAQ

为什么 Claude Code 正常，只有 Codex 报 502 错误？

Codex 的 Rust CLI 使用的 reqwest 库会读取系统代理环境变量，导致请求被劫持到代理软件；而 Claude Code 不受此系统代理环境变量影响，因此能正常直连 cc-switch。

修改了 Clash 规则后还是不行怎么办？

请确保 localhost 和 127.0.0.0/8 的 DIRECT 规则放在规则列表的最前面（最高优先级），或者尝试直接关闭系统代理、切换到 TUN 模式。

相关问题

<!-- Failed to upload "image.png" -->截图上传失败不影响问题本身，请直接用文字描述报错信息。10 issues mergedcontent[].thinking must be passed back升级 cc-switch 到 v3.16.0 或更高版本；临时可回退 Claude Code 到 2.1.150 或关闭 thinking。11 issues merged到claude 里面提示 401 - Claude Code开启 cc-switch 的本地代理功能以转换 API 格式，并确保 `ANTHROPIC_BASE_URL` 环境变量正确注入到 Claude Code 进程中。3 issues merged