Skip to content
CC Switch WikiUnofficial Community Wiki

Main Window Never Appears; CC Switch Fails to Start on Windows

Quick fix

Check Windows updates and WebView2 arguments first; the issues do not confirm a general fix for all cases.

Symptom

Section titled “Symptom”
Error output
进入界面停留2-3秒自动退出
English translation

The interface appears for 2–3 seconds, then the application exits automatically.

Cause

Section titled “Cause”

These issues describe the main window not appearing after launch on Windows, or briefly appearing before the application crashes. The crash report in #5186 points to event loop re-entry in tao 0.34.6, but the maintainer said the problem may be on the client or provider side and cannot be fundamentally fixed by CC Switch. Comments also mention that Windows update KB5081263 may affect the event loop, and that setting WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS to disable conflicting modules resolved the problem for one user. These cases have not been confirmed as a shared cause of all crashes.

#5414 only reports an automatic exit 2–3 seconds after entering the interface. A comment points to another issue but does not explain its specific cause or provide reproducible fix steps. Therefore, it is not possible to confirm that it shares the same root cause as the main window not appearing.

Fix

Section titled “Fix”

  1. Check whether Windows update KB5081263, mentioned in the comments, is installed. The issue does not provide confirmed steps for uninstalling or rolling back the update.

  2. You can try setting the WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS environment variable to --disable-extensions --disable-plugins --no-sandbox. One user reported that this resolved the problem, but other users have not confirmed it.

  3. If the application still crashes, record the CC Switch version, Windows version, and reproduction steps, and include the crash report. The maintainer requested this information for further investigation.

Affected Versions

Section titled “Affected Versions”
ToolCC Switch 主窗口
Version3.16.4、3.16.5、3.17.0（报告版本；另有评论提及 3.12.3 和 3.18.0）
PlatformsWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 2 real issues

FAQ

Section titled “FAQ”
Can setting WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS fix the problem?
One user reported that setting it to --disable-extensions --disable-plugins --no-sandbox resolved the problem. The issue does not confirm that this method works for all crashes.
Was this problem caused by Windows update KB5081263?
A comment says the update broke the event loop in tao 0.34.6, but the issue does not establish it as the shared cause of all cases where the main window fails to appear or the application crashes.
Section titled “Related problems”
EGL_BAD_PARAMETER: CC Switch White Screen on LinuxFor affected Linux AppImage environments, preload the host libwayland-client first. If the white screen remains, try the .deb package.8 issues mergedCannot start normally: window unresponsive, system requires force quitUpdate CC Switch to 4.0 or the latest version and retry. If it persists, provide the full version, steps, logs, and screenshots.1 issues mergedSwitching providers resets claude settings.json - Claude CodeBefore switching, extract the current provider’s configuration in “General Configuration” and select “Write to General Configuration” for the new provider.11 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.