Skip to content
CC Switch WikiUnofficial Community Wiki

Auto-upgrade fails; reinstalling the new version still leaves the old one - CC Switch

Quick fix

Uninstall the old version completely, clear the leftovers, and reinstall — that resolves a failed auto-upgrade or a version that will not update.

Symptom

Section titled “Symptom”
Error output
mac安装3.15版本升级不成功，自动升级不行，删除了之后重新下载新版本，安装之后还是老版本
English translation

Installing version 3.15 on mac will not upgrade. Auto-upgrade does not work; I deleted it, downloaded the new version again, and after installing it is still the old version.

Cause

Section titled “Cause”

This usually happens because the old version's processes did not fully exit, or leftover config files stop the new version installing over the top. The cluster also holds several post-upgrade side effects: the local Codex already being the latest while CC Switch detects an older version (#5981); a newer version not supporting several official OpenAI providers (#5333); a key reverting after being saved (#4300); an external tool update overwriting prompts (#4684); and unified session history migration failing to decrypt encrypted_content (#4464). For the upgrade failure and version detection error, the core mechanism is local state cache or the database not refreshing with the new version.

Fix

Section titled “Fix”

  1. Quit CC Switch and every related background process completely.

  2. Delete and uninstall the old application and its leftover config thoroughly.

  3. Download the latest version from the official channel and install it.

Affected Versions

Section titled “Affected Versions”
ToolCC Switch
VersionUnknown
PlatformsmacOSLinuxWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 6 real issues

FAQ

Section titled “FAQ”
My local Codex is already the latest, so why does CC Switch detect an older version?
That is a cache or path detection error in the version check. A thorough uninstall and reinstall of CC Switch usually refreshes the detection state.
After upgrading, only the first of several official OpenAI providers shows. What now?
That is a database compatibility problem in the new version. Open ~/.cc-switch/cc-switch.db with a database tool, rename the id of the row with id = codex-official in the providers table to codex-official2, and restart.
Unified Codex session history after upgrading fails to decrypt encrypted_content. How do I recover?
Switching provider cannot decrypt ciphertext from the old account. Return to the original account and provider to continue, or use a community offline migration script.
Section titled “Related problems”
bash: cannot set terminal process group - cc-switchA known 3.18.0 bug when checking the local proxy environment on Linux. Downgrade below 3.18.0 and configure the proxy in the terminal by hand.5 issues mergedcodex cli failed - CC SwitchUpgrading cc-switch to v3.16.3 or newer fixes the local environment detection and the blocked upgrade path.2 issues mergedIs codex no longer supported now that it became ChatGPT? - cc-switchUpgrade to cc-switch v3.17.0, which supports provider switching after Codex merged into ChatGPT Desktop, so old config is not overwritten.5 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.