上游 HTTP 502 - CC Switch (Claude Code / Codex)

Quick fix

检查本地网络代理（如 Clash/ZeroTier）配置，确保其不干扰直连请求。

Symptom

报错原文复制

[FWD-003] Provider s-gpt-20x-local 请求失败: 上游 HTTP 502

Cause

当 CC Switch 尝试将请求直接转发至局域网内的上游服务（如 Sub2API）时，如果上游返回 HTTP 502 错误，通常并非 CC Switch 本身的代码缺陷，而是中间网络设备或代理软件拦截了流量。

根据已解决的案例，该问题常由本地网络管理工具（例如 Clash 或 ZeroTier）的配置引起。这些工具可能在处理特定端口、IP 或协议（如 SSE 流式响应）时出现兼容性问题，导致连接被重置或返回网关错误。有趣的是，通过一个额外的本地 Python 转发代理中转后请求可能恢复正常，这进一步暗示了原始链路中的网络层干扰而非应用层逻辑错误。

Fix

1. 1

   检查并调整本地网络代理软件（如 Clash, ZeroTier, V2Ray 等）的绕过规则或配置，确保对上游服务的 IP 和端口不进行错误的拦截或修改。

2. 2

   重启网络代理软件或重新加载配置，然后重试 CC Switch 中的请求。

Affected Versions

ToolCodex / Claude Code

Version3.16.1 - 3.16.5

PlatformsWindows

Source Issues

本页汇总自 2 个真实 issue

• #3887日志中 Provider 标识不一致：部分模块输出 UUID 而非名称
• #5097Codex 代理直连本地 Sub2API /v1/responses 返回 502，但经本地转发代理后正常

FAQ

为什么经过本地 Python 代理转发就能成功？

因为额外的代理可能改变了 HTTP 头部（如 Connection, Accept-Encoding）或缓冲了响应，从而规避了底层网络代理软件对原始直连流量的错误处理。

这是 CC Switch 的 Bug 吗？

在已知案例中，这通常不是 CC Switch 的代码 Bug，而是本地网络环境（如 Clash/ZeroTier）与上游服务之间的兼容性问题。CC Switch 在此场景下仅作为透明转发器。

相关问题

404 Not FoundDeepSeek 不支持 Responses API，请使用内置预设走 Chat Completions 路由；若因图片报错需修改模型目录移除 image 模态。5 issues mergedHTTP 401 Unauthorized - CC Switch Anthropic升级 cc-switch 至修复版，以支持 Anthropic 所需的 x-api-key 和 anthropic-version 请求头。2 issues mergedmissing field content HTTP 400 - Codex将 CC Switch 转换层中 content:null 替换为空字符串即可解决严格上游拒绝请求的问题。2 issues merged