Skip to content
CC Switch WikiUnofficial Community Wiki

cc-switch crashes immediately after opening

Quick fix

No confirmed fix. Reinstalling does not help. Collect debug logs and wait for an official fix.

Symptom

Section titled “Symptom”
Error output
打开后就闪退
English translation

Crashes immediately after opening

Cause

Section titled “Cause”

Multiple users on Windows 11 report that cc-switch flashes or exits immediately after the main window appears, on both Windows 11 Pro 25H2 and Home. Reinstalling does not improve it. A user built a debug version for troubleshooting. The log shows startup proceeding normally: inserting default model pricing data, checking Claude/Codex/Gemini 等配置, registering the deep link, initializing `[GlobalProxy] Initialized: direct connection`, and finally printing `正常启动模式：主窗口已显示`, after which the process exits. This means the crash point is not captured by the current logs and may be in the main window/WebView or an uncaught exception. No clear root cause is known for this issue.

This is an open issue with no maintainer-confirmed solution. Do not confuse it with #6215, where deleting imported skills caused original directory files to be lost; that is a different failure.

Fix

Section titled “Fix”

  1. Do not repeatedly uninstall and reinstall. In #845, users reported that reinstalling still crashes immediately.

  2. To locate the issue, run the debug build: `D:\cc-switch\src-tauri\target\debug\cc-switch.exe`, and save the trailing log. If the log stops after `正常启动模式：主窗口已显示` and the process exits, the crash was not written to the current log.

  3. Reply to issue #845 with your system version (`winver`, e.g. Windows 11 Pro 25H2) and that log, then wait for the maintainer to investigate further.

Affected Versions

Section titled “Affected Versions”
Toolcc-switch
VersionUnknown
PlatformsWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 1 real issues

FAQ

Section titled “FAQ”
Does cc-switch also crash on Windows 11 Home?
Yes. In #845, users reported the same issue on both Pro 25H2 and Home.
Can uninstalling and reinstalling fix it?
Based on current feedback, reinstalling still crashes immediately and is not an effective fix.
Why does the debug log contain no error?
The log ends at `正常启动模式：主窗口已显示`, then the process exits. This crash is not recorded by the current logs. Maintainers need to add crash dumps or more logging.
Section titled “Related problems”
skills installed to the wrong path - cc-switchOlder cc-switch installs skills into ~/.claude/skills/skills, which Claude Code ignores. Upgrade, or move the contents up to ~/.claude/skills/.4 issues mergedshow 0 skills from cc-switchUpgrade cc-switch to v3.17.0 and re-toggle the skill state to fix Windows Hermes Desktop reading the LOCALAPPDATA path.1 issues mergedTest script: error, no result returnedMiniMax changed the balance query API response shape, breaking the old parser. Upgrade cc-switch to v3.16.2+, or use a custom template for now.5 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.