503, Connection Failure, or Timeout - Codex Local Routing

Quick fix

Upgrade to CC Switch 4.0 or the latest version, then re-enable local routing or “Keep Official Login.” If it persists, submit versions, logs, and screenshots.

Symptom

Error outputCopy

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

English translation

After enabling the app enhancement feature, my existing api could no longer connect and returned 503, although the main screen still showed a normal status. It worked immediately after I disabled the feature.

Cause

On Windows, the Codex “Keep Official Login When Switching to a Third Party” feature in CC Switch 3.16.1 may prevent the existing API from connecting and return 503. Disabling the feature restores connectivity immediately. The maintainer stated that the relevant handling was rewritten in 4.0: third-party keys are written to the [model_providers.custom] table in config.toml, the official login remains in auth.json, and login-related switches are set automatically based on whether auth.json contains an actual login instead of using the old template.

CC Switch 3.16.3 has a similar variant without complete reproduction details: after enabling local routing for Claude Code or Codex, connections frequently fail, time out, or have high latency. The issue was closed due to insufficient reproduction information, and the maintainer only recommended upgrading and retrying. The existing records therefore cannot confirm that both symptoms have exactly the same root cause or that upgrading will necessarily resolve them.

Fix

1. 1

   Upgrade CC Switch to 4.0 or the latest version.

2. 2

   In Settings, re-enable local routing or the Codex “Keep Official Login” feature, then test the connection again.

3. 3

   If 503 errors, connection failures, timeouts, or high latency persist after upgrading, provide the CC Switch version, Codex version, operating system, complete reproduction steps, and an error screenshot or cc-switch.log.

Affected Versions

ToolCodex

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

PlatformsWindows

Source Issues

This page is distilled from 2 real issues

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

FAQ

(No FAQ yet)

Related problems

Error in .codex cc-switch.db causes cc-switch startup failureClose cc-switch, clean records with empty base_url in cc-switch.db, or delete the database file and restart.1 issues mergedeither event handler is re-entrantOn Windows, try WebView2 parameters if enterprise security software conflicts; the reports provide no generally verified fix.5 issues mergedModel list is empty; Codex cannot select the DeepSeek modelUpgrade to CC Switch 4.0 and reapply the DeepSeek preset; model list display in the Codex desktop app also depends on its version support.5 issues merged