为什么开启代理后官方模型超时或报 502？

本地代理为避免封号风险不支持官方供应商。官方登录方式的调用与 cc-switch 的代理接管无直接关系，建议关闭代理或改用第三方供应商。

怎么删除所有 Codex 的代理配置？

仅剩一个供应商时无法删除。可以先新建一个其他供应商，再删除当前供应商；如果不想使用，可添加一个空的官方供应商作为占位。

开启代理后切换供应商，配置文件为什么没变？

开启代理后代理会接管本地配置文件，配置文件中的请求地址和供应商可能没有参考意义，应以实际请求数据或用量面板为准。

主页面本地代理相关 UI 消失了怎么办？

从 v3.11.0 起，本地代理 UI 可能需要在本地代理设置中手动打开“在主页面显示本地代理开关”。故障转移开关显示问题在 v3.12.0 后有修复，建议升级到 v3.12.3 或更高版本验证。

WSL 下代理无效怎么办？

有用户通过重新关闭再打开代理解决。WSL 中配置非 127 地址仍有已知问题，若代理运行在 Windows 主机上，需要特别注意 WSL 网络地址限制。

故障转移开关为什么在未开启代理时也能显示或操作？

部分版本中首页故障转移开关与本地代理接管状态解耦，可能导致状态不一致。文档和后端多数逻辑仍将“代理已启动且应用已接管”作为前提，建议升级并确认版本修复。

cc-switch 本地代理常见问题：502 Bad Gateway、超时、无法删除配置、UI 消失、故障转移状态不一致

Quick fix

代理相关问题多由官方供应商不被支持、配置未生效或 UI 状态不同步引起；需按场景检查代理模式、供应商类型与接管状态。

Symptom

报错原文

unexpected status 502 Bad Gateway:

Cause

该聚类包含多个代理相关问题，主要机制包括：1) 本地代理为避免封号风险不支持官方供应商，开启代理后访问官方模型会超时或报错；2) 仅剩一个供应商时无法删除，是设计限制，需先添加其他供应商再删除；3) 代理开启后会接管本地配置文件，直接查看配置文件可能不反映实际请求目标；4) 故障转移开关在部分版本中与本地代理接管状态解耦，导致 UI 可操作但后端语义不一致；5) WSL 环境下代理可能需要重新关闭再打开才能生效。不同错误变体（超时、502、UI 消失、无法删除）对应不同根因，不能单一修复。

Fix

如果使用官方供应商（OAuth 登录方式），请关闭本地代理或改用第三方供应商；本地代理不支持官方供应商。
如果只剩一个供应商无法删除，请先添加一个官方供应商或第三方供应商，再删除原有供应商。
开启代理后切换供应商时，不要以本地配置文件内容判断是否切换成功；请以实际请求、用量面板或供应商后台数据为准。如未生效，可关闭代理后重新开启。
WSL 环境下代理无效时，尝试关闭代理后重新打开；如仍无效，确认 Windows 侧代理可用，并注意 WSL 非 127.0.0.1 地址存在已知问题。
如果主页面本地代理或故障转移开关消失，进入本地代理设置，打开在主页面显示本地代理开关；故障转移相关显示问题可升级到 v3.12.3 或更高版本验证。

Affected Versions

Tool未知

Version3.8.3 - 3.11.0

PlatformsWindowsmacOSLinux

Source Issues

本页汇总自 26 个真实 issue

FAQ

为什么开启代理后官方模型超时或报 502？: 本地代理为避免封号风险不支持官方供应商。官方登录方式的调用与 cc-switch 的代理接管无直接关系，建议关闭代理或改用第三方供应商。
怎么删除所有 Codex 的代理配置？: 仅剩一个供应商时无法删除。可以先新建一个其他供应商，再删除当前供应商；如果不想使用，可添加一个空的官方供应商作为占位。
开启代理后切换供应商，配置文件为什么没变？: 开启代理后代理会接管本地配置文件，配置文件中的请求地址和供应商可能没有参考意义，应以实际请求数据或用量面板为准。
主页面本地代理相关 UI 消失了怎么办？: 从 v3.11.0 起，本地代理 UI 可能需要在本地代理设置中手动打开“在主页面显示本地代理开关”。故障转移开关显示问题在 v3.12.0 后有修复，建议升级到 v3.12.3 或更高版本验证。
WSL 下代理无效怎么办？: 有用户通过重新关闭再打开代理解决。WSL 中配置非 127 地址仍有已知问题，若代理运行在 Windows 主机上，需要特别注意 WSL 网络地址限制。
故障转移开关为什么在未开启代理时也能显示或操作？: 部分版本中首页故障转移开关与本地代理接管状态解耦，可能导致状态不一致。文档和后端多数逻辑仍将“代理已启动且应用已接管”作为前提，建议升级并确认版本修复。