Skip to content
CC Switch WikiUnofficial Community Wiki

Frozen after clicking update - cc-switch

Quick fix

Force quit and reopen the app, or update by hand to v3.16.3 or newer for the update deadlock fix.

Symptom

Section titled “Symptom”
Error output
界面卡住任何地方都无法点击
English translation

The interface is frozen and nothing can be clicked anywhere

Cause

Section titled “Cause”

In older versions, the cc-switch update download, install, and restart flow relied on the WebView executing JS. Once the application bundle was replaced, the old WebView could not continue running and the interface froze. A window state plugin lock during the restart also caused a deadlock. Fixed in v3.16.3, which added install_update_and_restart to move the whole flow to the backend. Separately, the Claude Code upgrade failing under winget on Windows (#4212) and the garbled Windows interface (#4328) mentioned in the cluster are independent problems still unfixed.

Fix

Section titled “Fix”

  1. Force quit the frozen cc-switch process, then reopen the app and check whether it updated to the latest version automatically.

  2. If it did not update after reopening, download and install v3.16.3 or newer by hand (v3.16.4 is the latest).

Affected Versions

Section titled “Affected Versions”
Toolcc-switch
Version< 3.16.3 (已在 v3.16.3 修复)
PlatformsmacOS

Source Issues

Section titled “Source Issues”

This page is distilled from 3 real issues

FAQ

Section titled “FAQ”
Could the update get a progress bar, and a prompt to restart when it finishes?
The update flow was moved to the backend in v3.16.3 to resolve the freeze; the UI suggestions about a progress bar and restart prompt have been recorded.
cc-switch fails to upgrade a winget-managed Claude Code and cannot see it. How do I resolve that?
cc-switch support for a winget-installed Claude Code has problems (#4212) with no official fix. Use winget commands by hand to upgrade for now.
The interface is garbled after downloading the latest version on Windows. What now?
That problem (#4328) has no officially confirmed fix and remains an outstanding bug.
Section titled “Related problems”
codex cli failed - CC SwitchUpgrading cc-switch to v3.16.3 or newer fixes the local environment detection and the blocked upgrade path.2 issues mergedCannot query usage for an official subscription in the Codex UI - CodexEnable local route mapping so specific models are counted. Third-party APIs need their own query script; Claude official and Free accounts are unsupported.8 issues mergederror code is 2503 or icon turns white after upgradeRemove Icon="ProductIcon" from per-user-main.wxs to fix install errors and missing icons. Existing users must unpin and repin.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.