Skip to content
CC Switch WikiUnofficial Community Wiki

assertion failed: flush_paint_messages - cc-switch crash

Quick fix

Upgrade cc-switch to the latest version for the underlying GUI framework crash fix, or try closing proxy software and resetting the network.

Symptom

Section titled “Symptom”
Error output
assertion failed: flush_paint_messages(None, &subclass_input.event_loop_runner)

Cause

Section titled “Cause”

An assertion failure caused by an event loop handling anomaly in tao, the GUI framework underneath cc-switch, on Windows.

Per user reports, on Windows 11 this crash can trigger randomly when certain proxy software is enabled (v2ray, for example) or when the DPI changes. Maintainers confirmed the problem and merged a fix PR.

Fix

Section titled “Fix”

  1. Update cc-switch to the latest version. Maintainers confirmed the crash is fixed in the new version.

  2. If it still crashes after updating, close all proxy software and stop it starting automatically, run `netsh restart network` on the command line, then restart the machine.

  3. Once the machine has restarted and cc-switch works again, if you still need a proxy, try changing the proxy software network mode to avoid the conflict.

Affected Versions

Section titled “Affected Versions”
Toolcc-switch
Version3.10.2 - 3.11.1
PlatformsWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 3 real issues

FAQ

Section titled “FAQ”
I have to use a proxy and cannot leave it off. What can I do?
Resolve the crash first by turning the proxy off and restarting the machine. Once cc-switch opens normally, try changing the proxy software network mode — proxies offer several network-layer modes, and changing it usually avoids triggering the crash again.
Is there a version known not to have this problem? I want to roll back.
Maintainers stated plainly that the crash is fixed in the new version, so update to the latest rather than rolling back.
Section titled “Related problems”
zsh:1: command not found: claudeUpgrade cc-switch to v3.16.4 or newer, fixing PATH not loading when the terminal launches, or switch to the system default terminal for now.3 issues mergedNo such file or directory (os error 2)Change the model_catalog_json absolute path in config.toml to the relative cc-switch-model-catalog.json, or upgrade cc-switch.2 issues mergedFailed to initialize gtk backend cc-switchRunning cc-switch in a headless environment (a server or container) errors for lack of GTK. Use the cc-switch-cli command-line build instead.2 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.