Error 2503：Windows 11 上 CC Switch MSI 安装失败

Quick fix

以管理员身份打开命令提示符，运行 msiexec /i 并指定 MSI 文件路径。

Symptom

报错原文复制

Double-clicking the .msi installer immediately throws **Error 2503** (Windows Installer permission denied).

Cause

问题出现在 Windows 11 上双击 CC Switch 的 MSI 安装包时，安装程序报告权限被拒绝。维护者回复称，原因在客户端或提供方一侧，CC Switch 本身无法修复；该回复没有进一步说明具体权限机制。

其中一条评论建议以管理员身份打开命令提示符，再运行 `msiexec /i "C:\yourpath\CC-Switch-v3.16.5-Windows.msi"`。另有用户报告，下载并解压 Portable.zip 后 `cc-switch.exe` 可以正常启动。

Fix

1. 1

   在 Windows 搜索中输入 cmd，右键“命令提示符”并选择“以管理员身份运行”。

2. 2

   在管理员命令提示符中运行 `msiexec /i "C:\yourpath\CC-Switch-v3.16.5-Windows.msi"`，将路径替换为实际 MSI 文件路径；评论示例使用 v3.16.5 安装包。

3. 3

   也可使用 Portable.zip：解压到本地目录后启动 `cc-switch.exe`。Issue #4485 和 #4487 的用户报告此方式可正常启动。

Affected Versions

ToolClaude Code

Versionv3.16.3（CC Switch 版本）

PlatformsWindows

Source Issues

本页汇总自 3 个真实 issue

• #4485MSI installer fails with Error 2503 on Windows 11
• #4486MSI installer fails with Error 2503 on Windows 11
• #4487MSI installer fails with Error 2503 on Windows 11

FAQ

Windows 11 右键 MSI 文件时没有“以管理员身份运行”选项怎么办？

Issue 评论说明，MSI 文件默认不会在右键菜单中显示该选项；可以改为以管理员身份打开命令提示符，再运行 `msiexec /i "实际文件路径"`。

Portable 版本能否作为替代安装方式？

有用户报告，解压 Portable.zip 后 `cc-switch.exe` 可以正常启动。

相关问题

Symlink target not foundAppImage 安装失败，需手动修复 .DirIcon 符号链接为相对路径。2 issues merged`GLIBC_2.35' not foundv3.10.1–v3.16.1 未有已确认兼容版本；按维护者建议试用 v4，仍报错则附版本和复现步骤重新提交。3 issues mergeddoes not run on macOS versions other than先执行 `brew update` 后重试安装；若 cask 仍锁定 Monterey，需将 macOS 条件改为 `>= :monterey`。2 issues merged