显示为【白色屏幕】 Claude Code

Quick fix

旧系统上 cc-switch 可能无法启动；Windows 可更新至 24H2，macOS 可尝试维护者建议的 CC Switch CLI。

Symptom

报错原文复制

显示为【白色屏幕】，杀死后重开依旧。

Cause

Issue #1953 中，维护者说明 macOS 白屏是因 Tauri2 对系统版本要求较高，并建议尝试 CC Switch CLI。原帖未给出可验证的图形界面修复方案或具体系统版本要求。

Issue #2118 是 Windows 变体：3.13.0 的安装版和便携版，以及 3.10.2 安装版均无法启动。报告者随后确认，将系统更新至 24H2 后可以使用。两份报告均指向较旧系统版本的启动兼容性，但未提供统一的最低系统版本或完整根因。

Fix

1. 1

   在 Windows 上，将系统版本更新至 24H2；Issue #2118 的报告者确认更新后可以使用。

2. 2

   在 macOS 上，如图形界面持续白屏，可尝试维护者建议的 CC Switch CLI；原帖尚未提供可验证的图形界面解法。

Affected Versions

ToolClaude Code

Version3.10.2 - 3.13.0（报告出现问题的版本范围，非确认修复范围）

PlatformsWindowsmacOS

Source Issues

本页汇总自 2 个真实 issue

• #1953catalina (intel mbp 2019) 可安装，但打开为白屏
• #2118win11专业版，版本号23H2，打不开cc-switch，安装版和免安装版都试过，都打不开

FAQ

有没有解决方案？

Windows 报告者确认更新系统至 24H2 后可以使用；macOS 报告中维护者建议尝试 CC Switch CLI。

相关问题

ASProxy64.dll 访问违规导致闪退在 Astrill 的 Help → Hard excluded apps 中添加 cc-switch.exe，然后重新登录 Astrill。2 issues mergedeither event handler is re-entrantWindows 上出现该崩溃时，企业安全软件冲突场景可尝试设置 WebView2 参数；原帖未提供通用已验证修复。5 issues merged打开后就闪退：CC Switch Windows 启动闪退在最新版复现时，提供 CC Switch、Windows 和 WebView2 版本，以及最新日志和事件查看器错误信息以便定位。1 issues merged