Opening cc on Windows 11 gives a process but no window - cc-switch

Quick fix

On Windows 11, try Windows 7 compatibility in the exe properties. If that fails, use cc-switch-cli to bypass the Tauri 2 GUI white screen.

Symptom

Error outputCopy

我windows11打开cc，为什么只有进程没有界面

English translation

I open cc on Windows 11 — why is there only a process and no window?

Cause

The cc-switch GUI is built on Tauri 2, and on stripped-down or older Windows environments, some Linux distributions (AppImage especially), and macOS 11.x, it often shows a white window, no styling, or a process with no window at all. Maintainers have repeatedly attributed this to Tauri 2 demanding a recent OS and suggested the CLI build. But on Fedora users found a source build runs fine while only the AppImage goes white, so some argue it is an AppImage packaging problem; maintainers later looked into packaging and shipped rpm/Flatpak packages in v3.9.0.

By platform: on Windows 11 you see a process and no window after launch — one user solved it with Windows 7 compatibility in the properties, while another reported no effect, and a third found it opened after removing some x64 C++ runtimes and broke again after reinstalling them. On Linux, the AppImage reports EGL_BAD_PARAMETER or simply goes white, reported on both Fedora 42 and 43. On macOS 11.x the main window is entirely white or unstyled, the missing styling being tied to tailwind v4 requiring Safari 16.4 / macOS 11.7.4 or newer.

Fix

1. 1

   Windows: right-click cc-switch.exe → Properties → Compatibility → tick "Run this program in compatibility mode for: Windows 7". This comes from user reports and does not work on every machine.

2. 2

   Linux AppImage white screen: upgrade to v3.9.0+ and use the rpm or Flatpak package instead; running a source build is also reported to work.

3. 3

   macOS white screen on an older system: try updating macOS to 11.7.4 / Safari 16.4 or newer first. If you cannot update, use the CLI build.

4. 4

   A stopgap available on every platform: use cc-switch-cli. On macOS run brew install cc-switch-cli; for other platforms see https://github.com/SaladDay/cc-switch-cli.

Affected Versions

Toolcc-switch

VersionUnknown

PlatformsWindowsmacOSLinux

Source Issues

This page is distilled from 6 real issues

• #212界面启动起来没有延时 macos 11.7
• #285黑苹果打开界面异常，麻烦帮忙看看呢，万分感谢
• #321能不能直接提供一个rpm的包？
• #519WSL下AppImage包无法运行，但源码编译可以
• #1447macos11.7 软件主界面全白，试过好多个版本都是
• #1458我windows11打开cc，为什么只有进程没有界面

FAQ

Windows 7 compatibility mode did not help on Windows. What else can I try?

Users report compatibility mode having no effect. Maintainers suggest the CLI build (cc-switch-cli) to bypass Tauri 2 GUI compatibility entirely.

The Fedora AppImage goes white while a source build works. Is that Tauri 2 or packaging?

Both explanations coexist: maintainers initially blamed Tauri 2 compatibility on certain distributions, while users pointed out a source build works and the AppImage packaging is at fault. v3.9.0 added rpm/Flatpak packages — try those first.

macOS 11.7 shows a white screen or no styling. What now?

tailwind v4 needs macOS 11.7.4 / Safari 16.4 or newer. Below that, update the system or use the CLI build.

How do I install the CLI build?

On macOS run brew install cc-switch-cli; for other platforms see https://github.com/SaladDay/cc-switch-cli.

Related problems

cc-switch white screen / black screen / crash / no window on launchWork out whether it is corrupt window state, a WebView2/OS compatibility problem, or security software. Handle per symptom; use the CLI build if needed.14 issues mergedcc-switch local proxy: 502 Bad Gateway, timeouts, cannot delete a providerUsually caused by unsupported official providers, config not applying, or UI state drift. Check proxy mode, provider type, and takeover state.26 issues mergedEvery click first pops up the system folder picker - cc-switchEdit src/App.tsx to remove the pickDirectory() call in handleOpenTerminal, so opening a terminal stops forcing a folder picker.3 issues merged