Skip to content
CC Switch WikiUnofficial Community Wiki

cc-switch Installation: Main Interface Not Opening or No Response - CC Switch Fix

Quick fix

Use the CLI version or adjust Windows OS versions to resolve Tauri compatibility issues causing UI failure.

Symptom

Section titled “Symptom”
Error output
双击exe主界面没有打开，没有系统托盘icon
English translation

Double-clicking the exe file fails to open the main interface; no system tray icon appears.

Cause

Section titled “Cause”

This issue primarily affects the cc-switch v3.16.3 version on Windows platforms (including Win10 and Win11). Users report that after installation or execution, the main interface does not display and no system tray icon appears, although the process remains running in Task Manager. Analysis of Issue #1602 indicates this is usually caused by compatibility issues due to high OS version or environment requirements for Tauri 2. Some users resolved the problem by upgrading or rolling back their Windows system version (Issue #4376), but this is not a stable solution. Currently, the official recommendation for affected users is to use the CLI version as an alternative.

Fix

Section titled “Fix”

  1. Uninstall the current GUI version and switch to the CLI version. Visit https://github.com/SaladDay/cc-switch-cli to obtain and install the CLI version of cc-switch.

  2. If the GUI version is required, try adjusting the Windows OS version. Users reported resolving the issue by upgrading to Win11 or reverting from Win11 to Win10 (Issue #4376). Ensure Webview2 is updated to the latest version (e.g., 149.0.4022.69 or higher).

Affected Versions

Section titled “Affected Versions”
Toolcc-switch
Version3.16.3
PlatformsWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 4 real issues

FAQ

Section titled “FAQ”
Why is the process visible in Task Manager but no window appears?
This is a known Bug where rendering fails or window dimensions are abnormal (e.g., 0x0) under specific Windows environments with Tauri 2. Although the process runs, the UI is not correctly mounted to the visible screen area.
I am a Linux user encountering similar problems. What should I do?
Although this page focuses on Windows, Linux users (such as Kali) have reported program freezing when adding providers. It is recommended to prioritize using the CLI version to avoid GUI compatibility issues.
Do older versions have this issue too?
Yes, users have reported being unable to open the UI in older versions (Issue #4532 comment). This suggests the issue may persist across multiple versions, not just v3.16.3.
Section titled “Related problems”
codex 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 mergedError 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 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.