Skip to content
CC Switch WikiUnofficial Community Wiki

White flash when switching tabs, CC Switch

Quick fix

The issue may be related to a WebView2 153.x update. If it continues after upgrading to CC Switch v4.0, provide the version and reproduction steps.

Symptom

Section titled “Symptom”
Error output
When switching between client tabs (Claude Code / Claude Desktop / Codex / Gemini …) and when switching to the terminal view, the UI shows a noticeable **white flash** — a blank white frame appears for one frame before the new panel renders.

Cause

Section titled “Cause”

A brief white screen appears when switching client tabs, the terminal view, and the settings page. The reporter found that the flashing began on the same day WebView2 Runtime automatically upgraded to `153.0.4234.48`, and suspected a WebView2 redraw regression; this cause was not confirmed. Disabling GPU compositing did not help. A commenter mentioned that the flashing continued after updating to `v3.20.4`, so the report did not establish a single triggering version.

The maintainer said this issue is the same as #7448 and is being tracked there. CC Switch v4.0 made substantial changes to configuration switching and the UI, and some related issues no longer occur.

Fix

Section titled “Fix”

  1. Upgrade to CC Switch v4.0. If the issue persists, the maintainer recommends providing the current version and reproduction steps.

Affected Versions

Section titled “Affected Versions”
ToolCC Switch 界面
VersionCC Switch v3.20.3（报告环境）；WebView2 Runtime 153.0.4234.48（疑似相关，未确认）
PlatformsWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 1 real issues

FAQ

Section titled “FAQ”
Can setting `WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS` to disable GPU acceleration fix the white flash?
The reporter tried `--disable-gpu-compositing` and `--disable-gpu --disable-gpu-compositing --disable-software-rasterizer`; neither fixed the issue.
What should I do if flashing continues after upgrading to CC Switch v4.0?
The maintainer recommends reporting the issue again with the current version and reproduction steps.
Section titled “Related problems”
The Gemini CLI reading the project .env breaks cc-switchWrap the gemini command in PowerShell to load the ~/.gemini/.env environment variables by hand.2 issues merged[DISCUSS] Support for pi coding agentThis is a feature request merged into tracking issue #1855; the original post provides no verifiable solution.1 issues mergedSwitching providers resets claude settings.json - Claude CodeBefore switching, extract the current provider’s configuration in “General Configuration” and select “Write to General Configuration” for the new provider.11 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.