Skip to content
CC Switch WikiUnofficial Community Wiki

Error 2503: CC Switch MSI Installation Fails on Windows 11

Quick fix

Open Command Prompt as an administrator and run msiexec /i with the MSI file path.

Symptom

Section titled “Symptom”
Error output
Double-clicking the .msi installer immediately throws **Error 2503** (Windows Installer permission denied).

Cause

Section titled “Cause”

On Windows 11, double-clicking the CC Switch MSI installer reports that permission was denied. A maintainer replied that the cause was on the client or provider side and could not be fixed by cc-switch; the reply did not explain the specific permission mechanism.

One comment suggested opening Command Prompt as an administrator and running `msiexec /i "C:\yourpath\CC-Switch-v3.16.5-Windows.msi"`. Another user reported that `cc-switch.exe` started normally after downloading and extracting Portable.zip.

Fix

Section titled “Fix”

  1. Type cmd in Windows Search, right-click “Command Prompt,” and select “Run as administrator.”

  2. In the elevated Command Prompt, run `msiexec /i "C:\yourpath\CC-Switch-v3.16.5-Windows.msi"`, replacing the path with the actual MSI file path; the comment's example uses the v3.16.5 installer.

  3. You can also use Portable.zip: extract it to a local directory and launch `cc-switch.exe`. Users in Issue #4485 and #4487 reported that it started normally this way.

Affected Versions

Section titled “Affected Versions”
ToolClaude Code
Versionv3.16.3（CC Switch 版本）
PlatformsWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 3 real issues

FAQ

Section titled “FAQ”
What if “Run as administrator” is not available when I right-click the MSI file on Windows 11?
An issue comment explains that MSI files do not show this option in the context menu by default. Instead, open Command Prompt as an administrator and run `msiexec /i "实际文件路径"`.
Can the Portable version be used as an alternative installation method?
A user reported that `cc-switch.exe` started normally after extracting Portable.zip.
Section titled “Related problems”
Symlink target not found: .DirIcon broken symlink causes - CC SwitchAppImage install fails due to broken .DirIcon symlink. Fix by converting it to a relative path.2 issues merged`GLIBC_2.35' not foundNo confirmed compatible release exists from v3.10.1–v3.16.1. Try v4; if it still fails, report the version and reproduction steps.3 issues mergeddoes not run on macOS versions other than Monterey: CC Switch installation failureRun `brew update` and retry. If the cask is still locked to Monterey, change the macOS condition to `>= :monterey`.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.