3.15.0 在 WSLg 下启动会卡死：CC Switch
Quick fix
回退到 3.14.1 可恢复正常启动；也可在最新版复现并提交 WSL、图形环境和启动输出信息。
Symptom
Section titled “Symptom”3.15.0 在 WSLg 下启动会卡死该问题出现在 Windows 的 WSL2 Ubuntu 环境中：启动 CC Switch 3.15.0 后界面卡死，WSL 会话也可能变得不稳定，需执行 `wsl --shutdown` 后重新进入才能恢复。反馈者回退到 3.14.1 后恢复正常。Issue 没有提供日志或图形环境信息，因此无法确定具体原因。
维护者提到 4.0.x 修复过 WSL 环境下的一些启动问题，但没有说明具体修复版本或是否解决了本 issue 的问题；建议在最新版复现并补充 WSL 发行版与版本、webview/图形相关信息及终端启动输出。
如果使用 3.15.0 时遇到该问题，可回退到 3.14.1；反馈者确认该版本能正常启动。
也可从官方 Releases 获取最新版并重新尝试；若仍卡死，请提交 WSL 发行版与版本、webview/图形相关信息和终端启动输出。
Affected Versions
Section titled “Affected Versions”ToolCC Switch
Version3.15.0（受影响版本；4.0.x 修复过部分 WSL 启动问题，具体版本未知）
PlatformsLinux
Source Issues
Section titled “Source Issues”本页汇总自 1 个真实 issue
（暂无 FAQ）
either event handler is re-entrantWindows 上出现该崩溃时，企业安全软件冲突场景可尝试设置 WebView2 参数；原帖未提供通用已验证修复。每次点击都会先弹出系统文件夹选择器 cc-switch修改 src/App.tsx 移除 handleOpenTerminal 中的 pickDirectory() 调用，即可解决点击打开终端时强制弹出文件夹选择器的问题。Bash(...) Waiting... Claude Code降级 Claude Code 至 v2.1.104 或 v2.0.64（需管理员权限），或切换至阿里云百炼等兼容 provider，因 Nvidia 模型无法正确解析 tool use 格式。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。