跳503、连接不上或超时 - Codex 本地路由

Quick fix

升级到 CC Switch 4.0 或最新版后重新开启本地路由或“保留官方登录”；若仍复现，请提交版本、日志和截图。

Symptom

报错原文复制

开启应用增强功能后我原本的api无法连接上，跳503，但在主界面还是显示正常，随后关闭此功能后立即可以使用了。

Cause

在 Windows 上，CC Switch 3.16.1 的 Codex“切换第三方时保留官方登录”功能可能导致原有 API 无法连接并返回 503；关闭该功能后可立即恢复。维护者说明，4.0 已重写相关处理：第三方密钥统一写入 config.toml 的 [model_providers.custom] 表，官方登录保留在 auth.json，登录相关开关根据 auth.json 中是否实际存在登录自动设置，不再沿用旧模板。

CC Switch 3.16.3 还有一个相近但未获得完整复现信息的变体：Claude Code 或 Codex 开启本地路由后经常连接不上、超时或延时高。该 issue 因缺少进一步复现信息而关闭，维护者只建议升级后重试，因此现有记录不能确认两种现象具有完全相同的根因，也不能确认升级一定解决。

Fix

1. 1

   将 CC Switch 升级到 4.0 或最新版。

2. 2

   在设置中重新开启本地路由或 Codex 的“保留官方登录”功能，然后再次测试连接。

3. 3

   如果升级后仍然出现 503、连接不上、超时或延时高，请补充 CC Switch 版本、Codex 版本、系统、完整复现步骤，以及报错截图或 cc-switch.log。

Affected Versions

ToolCodex

Version受影响报告版本：3.16.1 - 3.16.3；4.0 已重构相关功能，但 issue 未确认修复结果

PlatformsWindows

Source Issues

本页汇总自 2 个真实 issue

• #3715Codex 应用增强-切换第三方时保留官方登录的功能有bug
• #4621凡是需要开启路由的接入经常是超时或延时高

FAQ

（暂无 FAQ）

相关问题

报.codex下的cc-switch.db出错，然后启动cc-switch失败关闭程序，手动清理 cc-switch.db 中 base_url 为空的残留记录，或直接删除该数据库文件后重启。1 issues mergedeither event handler is re-entrantWindows 上出现该崩溃时，企业安全软件冲突场景可尝试设置 WebView2 参数；原帖未提供通用已验证修复。5 issues merged模型列表为空，Codex 无法选择 DeepSeek 模型升级到 CC Switch 4.0 后重新应用 DeepSeek 预设；Codex 桌面端的模型列表显示也受其自身版本支持情况影响。5 issues merged