跳转到内容
CC Switch WikiUnofficial Community Wiki

502 Bad Gateway - CC Switch

Quick fix

Codex/Claude Desktop 报 502 多因 CLI proxy 冲突或 app-server 架构绕过代理，删掉 proxy 配置或降级版本可修复。

Symptom

Section titled “Symptom”
报错原文
unexpected status 502 Bad Gateway: Unknown error, url: http://127.0.0.1:15721/v1/responses

Cause

Section titled “Cause”

该 502 错误在 cc-switch 中有几种不同的触发机制，取决于使用的工具和版本。

对于 Codex，存在两种情况。其一是 Codex v0.137.0-alpha.4 采用了 app-server 架构，CLI/GUI 通过 WebSocket 连接到进程内的 app-server，再由 app-server 直接连接外网 API，完全绕过了 config.toml 中配置的 base_url。这导致 cc-switch 的代理（127.0.0.1:15721）无法接管请求，路由面板显示 0 请求、0 连接。其二是 cc-switch 从 3.17.0 升级到 3.20.0 后引入了回归问题，相同的配置在 3.17.0 中正常，但在 3.20.0 中 cc-switch 本地代理处理上游请求时失败并返回 502。

对于 Claude Desktop 的 Code 模式，问题出在 Claude Code CLI 的 JSON 配置与 Desktop 的 Code 模式存在关联。如果用户在 CLI 的 JSON 配置中添加了 VPN proxy 地址（如 127.0.0.1:7890），即使 Desktop 配置了 cc-switch 的路由地址（127.0.0.1:15721），Code 模式也会因为 proxy 冲突而无法连接到 cc-switch，从而抛出 502 错误。此外，Claude Code 和 Desktop 在 2.1.220 版本之后引入了回归，导致不再支持 DeepSeek 等第三方供应商。

Fix

Section titled “Fix”

  1. 针对 Claude Desktop Code 模式报 502：打开 cc-switch 中 Claude Code CLI 的 JSON 配置文件，删除其中关于 proxy 的行（如 "proxy": "http://127.0.0.1:7890"）。注意：删除后 CLI 将无法直接连接国外模型，需按需切换配置。

  2. 针对 Claude Code/Desktop 2.1.220 后的回归问题：将 Claude Code 或 Claude Desktop 回退到 2.1.220 或更早的版本。

  3. 针对 cc-switch 3.20.0 导致 Codex 报 502 的回归问题：卸载 cc-switch 3.20.0，重新安装 3.17.0。

  4. 针对 Codex v0.137.0-alpha.4 app-server 架构绕过代理的问题：降级 Codex 到 0.80.0（最后一个支持 wire_api = "chat" 的版本），或使用外部协议转换代理（如 yangfei4913438/codex-deepseek 或 router-for-me/CLIProxyAPI）。

Affected Versions

Section titled “Affected Versions”
ToolClaude Code / Codex
Versioncc-switch 3.16.1 - 3.20.0, Codex v0.137.0-alpha.4, Claude Code/Desktop 2.1.220+
PlatformsWindows

Source Issues

Section titled “Source Issues”

本页汇总自 4 个真实 issue

FAQ

Section titled “FAQ”
为什么 cc-switch 的路由面板显示 0 请求、0 连接，但 Codex 仍然报 502？
因为 Codex v0.137.0-alpha.4 采用了 app-server 架构，请求不再经过 config.toml 中配置的 base_url，而是由 app-server 直接连接外网 API，导致 cc-switch 的代理完全被绕过。
为什么在 Claude Desktop 的 Code 模式下报 502，但 cowork 模式正常？
Claude Desktop 的 Code 模式与 Claude Code CLI 的配置存在关联。如果 CLI 的 JSON 配置中包含了 VPN proxy 地址，会导致 Code 模式无法正确连接到 cc-switch 的路由地址。删除 CLI 配置中的 proxy 行即可解决。
相同的 Codex 配置在 cc-switch 3.17.0 中正常，为什么在 3.20.0 中报 502？
这是 cc-switch 3.20.0 引入的回归问题。卸载 3.20.0 并重新安装 3.17.0 可以恢复正常。
Claude Code/Desktop 更新后无法使用 DeepSeek，报 502 怎么办？
Claude Code 和 Desktop 在 2.1.220 之后引入了回归，不再支持 DeepSeek 等第三方供应商。需要将 Claude Code 或 Desktop 回退到 2.1.220 或更早的版本。

相关问题

Section titled “相关问题”
unexpected status 404 Not Found升级 cc-switch 到 v3.16.4+，并在 Codex 供应商表单把上游格式显式设为 Chat Completions。4 issues merged第三方模型仍自称 based on GPT-5 - Codex将 `baseInstructions` 覆盖逻辑从 `if profile != ProxyChat` 块移出，使其对 ProxyChat 生效；当前即使配置了 `baseInstructions` 也不会注入。1 issues merged<!-- Failed to upload "image.png" -->截图上传失败不影响问题本身，请直接用文字描述报错信息。10 issues merged

这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。