Skip to content
CC Switch WikiUnofficial Community Wiki

After enabling app enhancements my original api cannot connect and returns 503 - Codex

Quick fix

Turn app enhancements, or keep-official-login, off in cc-switch to resolve the 503 and the timeouts.

Symptom

Section titled “Symptom”
Error output
开启应用增强功能后我原本的api无法连接上，跳503
English translation

After enabling app enhancements my original api cannot connect and returns 503

Cause

Section titled “Cause”

With 应用增强 (app enhancements) — particularly 保留官方登录 (keep the official login) — or local routing enabled in cc-switch, the program intercepts and modifies Claude Code and Codex network requests. That local routing mechanism conflicts with a third-party relay API, so requests cannot be forwarded properly, producing 503 errors, high latency, or timeouts. In some cases the request payload is modified wrongly, producing JSON validation errors such as Invalid schema.

Fix

Section titled “Fix”

  1. Open the cc-switch main screen, find 应用增强 (app enhancements) and turn it off (or untick 保留官方登录, keep the official login), returning to pure API mode.

  2. If frequent timeouts or high latency come from enabling local routing, try turning local routing off, or restart the machine and run only cc-switch and the target app.

Affected Versions

Section titled “Affected Versions”
ToolClaude Code / Codex
Version3.16.1 - 3.19.2
PlatformsWindowsmacOS

Source Issues

Section titled “Source Issues”

This page is distilled from 4 real issues

FAQ

Section titled “FAQ”
Why does a relay API stop working once keep-official-login is on?
Because keeping the official login takes over API requests to maintain official authentication, which conflicts with a third-party relay address. Turning it off and returning to pure API mode resolves it.
What causes Invalid schema for function 'list_available_plugins_to_install': {} is not of type 'array'?
App enhancements modified the function call JSON structure wrongly while intercepting the request. Turning app enhancements off restores normal behaviour.
Section titled “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 mergedcodex cli failed - CC SwitchUpgrading cc-switch to v3.16.3 or newer fixes the local environment detection and the blocked upgrade path.2 issues mergedcc-switch config not applied / not picked up after switching - Claude CodeConfirm the app actually reads the config path cc-switch writes to, then check routing and plugin toggles, duplicate keys, and version compatibility.28 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.