Claude Code shows a white screen
Quick fix
cc-switch may not start on older systems. On Windows, update to 24H2; on macOS, try the maintainer-recommended CC Switch CLI.
Symptom
Section titled “Symptom”显示为【白色屏幕】，杀死后重开依旧。Shows a white screen; reopening after killing it still results in the same issue.
In Issue #1953, the maintainer explained that the macOS white screen is due to Tauri2 requiring a newer system version and suggested trying CC Switch CLI. The original post did not provide a verifiable GUI fix or specific system-version requirement.
Issue #2118 is the Windows variant: the 3.13.0 installer and portable versions, and the 3.10.2 installer version, could not start. The reporter later confirmed that updating the system to 24H2 resolved the issue. Both reports point to startup compatibility on older system versions, but do not provide a single minimum system version or complete root cause.
On Windows, update the system to 24H2; the reporter in Issue #2118 confirmed it worked after the update.
On macOS, if the GUI continues to show a white screen, try the maintainer-recommended CC Switch CLI; the original post does not yet provide a verifiable GUI solution.
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”This page is distilled from 2 real issues
- Is there a solution?
- The Windows reporter confirmed it worked after updating the system to 24H2; in the macOS report, the maintainer suggested trying CC Switch CLI.
Related problems
Section titled “Related problems”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.