Skip to content
CC Switch WikiUnofficial Community Wiki

3.15.0 hangs on startup under WSLg: CC Switch

Quick fix

Rolling back to 3.14.1 restores normal startup; alternatively, reproduce on the latest version and submit WSL, graphics environment, and startup output details.

Symptom

Section titled “Symptom”
Error output
3.15.0 在 WSLg 下启动会卡死
English translation

3.15.0 hangs on startup under WSLg

Cause

Section titled “Cause”

The issue occurred in a Windows WSL2 Ubuntu environment: after starting CC Switch 3.15.0, the UI froze, and the WSL session could also become unstable. Running `wsl --shutdown` and re-entering the session was required to recover. The reporter confirmed that rolling back to 3.14.1 restored normal operation. The issue provided no logs or graphics environment details, so the specific cause cannot be determined.

The maintainer mentioned that 4.0.x fixed some startup issues in WSL environments, but did not specify the exact fix version or whether it resolved this issue. They recommended reproducing the issue on the latest version and providing the WSL distribution and version, webview and graphics details, and terminal startup output.

Fix

Section titled “Fix”

  1. If you encounter this issue on 3.15.0, roll back to 3.14.1; the reporter confirmed that this version starts normally.

  2. Alternatively, get the latest version from the official Releases and try again. If it still hangs, submit the WSL distribution and version, webview and graphics details, and terminal startup output.

Affected Versions

Section titled “Affected Versions”
ToolCC Switch
Version3.15.0（受影响版本；4.0.x 修复过部分 WSL 启动问题，具体版本未知）
PlatformsLinux

Source Issues

Section titled “Source Issues”

This page is distilled from 1 real issues

FAQ

Section titled “FAQ”

(No FAQ yet)

Section titled “Related problems”
either event handler is re-entrantOn Windows, try WebView2 parameters if enterprise security software conflicts; the reports provide no generally verified fix.5 issues mergedSystem folder picker opens on every click cc-switchRemove the pickDirectory() call from handleOpenTerminal in src/App.tsx to stop the folder picker from opening whenever you click to open a terminal.4 issues mergedBash(...) Waiting... Claude CodeDowngrade Claude Code to v2.1.104 or v2.0.64 (admin required), or switch to a compatible provider such as Alibaba Cloud Bailian.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.