⑥ CC Switch 502 Bad Gateway：关闭路由模式解决方法
CC Switch 开启路由模式后，Codex 或 Claude 可能频繁出现以下错误：
unexpected status 502 Bad Gateway: Unknown error,url: http://127.0.0.1:15721/v1/responses如果已经确认以下配置均正确：
- API 密钥有效且填写无误
- 接口地址填写正确
- 当前站点及模型可以正常使用
那么该报错通常不是密钥或接口地址导致的，而是 CC Switch 的本地路由服务出现异常。错误中的 127.0.0.1:15721 是本地路由地址；当路由服务未能正常转发请求时，就可能返回 502 Bad Gateway。
请关闭 CC Switch 的路由模式，改用文件写入模式。
- 打开 CC Switch。
- 找到顶部工具栏中的路由模式开关，如下图红框所示。
- 关闭该开关，切换为文件写入模式。
- 在 CC Switch 中重新选择需要使用的站点。
- 完全退出并重新启动 Codex 或 Claude，使其重新读取配置文件。
两种模式的区别
Section titled “两种模式的区别”| 模式 | 优点 | 注意事项 |
|---|---|---|
| 路由模式 | 可以动态切换站点，通常无需重启客户端 | 本地路由服务异常时，可能频繁出现 502 Bad Gateway |
| 文件写入模式 | 绕过本地路由服务，配置更直接、稳定 | 切换站点后必须重启 Codex 或 Claude |
仍然报错怎么办？
Section titled “仍然报错怎么办？”如果关闭路由模式并重启客户端后仍然报错，请再次检查 API 密钥、接口地址、模型名称和站点可用状态。此时错误请求地址应当不再是 http://127.0.0.1:15721；如果仍然出现该本地地址，请确认路由模式已经成功关闭，并再次完全退出客户端后重新打开。