cc-switch installation, update, and startup issue collection
Quick fix
This issue cluster mixes installation, update, startup, and other failures. The available evidence cannot confirm a single fix for the whole page.
Symptom
Section titled “Symptom”无法正常升级，卸载掉重新安装报错Cannot upgrade normally; after uninstalling and reinstalling, an error occurs
This cluster contains multiple unrelated problems, such as Windows installation or uninstallation failures, macOS freezes after in-app updates, Skills installation failures, CLI detection anomalies, and routing or configuration issues. Their causes and fixes differ, so they cannot be merged into one failure topic. Some issues have key details only in screenshots that were not provided, or the original text was truncated, so error messages and fix steps cannot be completed from the available material.
We recommend troubleshooting by splitting the issue into a specific error or operation scenario: first confirm the app, OS, and version recorded in the corresponding issue, then refer to the maintainer's reply in that issue. The available material is insufficient to provide a universal fix for the entire cluster.
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”This page is distilled from 53 real issues
- #396安装anthropics官方的skills会出现嵌套文件夹而不被识别
- #661win版本 25H2 (OS 内部版本 26200.7462) 如果当前没有codex cli在运行，cc-switch会自己退出程序，无法做到后台常驻。
- #769[BUG] skill搜索结果展示重复
- #1269请问cc-switch支持新版Claude code的自适应思考功能了吗
- #1316Is there a package that runs on ARM-Macos platform?
- #1379转态检查弹窗不显示对应数据
- #2188我移动了.openclaw文件夹到其它盘
- #2295为什么直接使用cc-switch中的更新会失败？
- #2444[Bug] Codex 的 Subagent 会话会被错误纳入会话管理
- #2465"effortLevel": "high" 无论如何都不能保存为Max
- #2477安装skills报错
- #2480Windows Server 2022 Datacenter电脑无法使用CC Switch的应用
- #2720偶尔无法开机自启
- #2737cc-switch无法识别miniconda base环境中安装的codex
- #2748指定目录启动命令行报错
- #2756window10安装后cli不显示（空白）
- #2859claude路由启用失败
- #2976使用brew从3.14.1升级到3.15.0，提示“This software does not run on macOS versions other than Monterey”
- #2984使用CCSwitch在文本输入时，文本光标有时会退出导致输入失败
- #3158查询失败
- #3257Setup 出现错误
- #3434无法正确检测Claude code codex版本状态
- #3525如果有系统变量冲突，提示无法关闭
- #3547本地环境检查无法检测已安装的环境
- #3577windows10 1909版本 无法使用
- #3696打开路由切换第三方api出现We're currently experiencing high demand, which may cause temporary errors.
- #3714执行命令的时候报错: Workspace starting. The isolated Linux enviroment is booting in the background (usually 10-30 seconds) Try again shortly.
- #3787内存泄漏问题Memory leak issue
- #3788opencode会话管理的命令错误
- #3835部分newapi无法使用
- #3931章节标题错误
- #3983macos27无法正常使用
- #3998在软件内点击更新之后直接卡死
- #4032无法在centos7的虚拟机上安装cc-swtich
- #4034Multiple installations were incorrectly detected, resulting in a conflict report
- #4040找不到CODEX
- #4042安装skill报错“未找到技能”
- #4299mac耗电异常
- #4303Codex 在 Windows 下会显示多个 codex/codex.cmd/codex.ps1 入口，容易被误判为重复安装，但实际它们都指向同一套 npm 安装。
- #4331同时配了codex 及 claude desktop 打开codex的本地路由，claude desktop 就一起打开了无法单独关闭
- #4337不能安装使用claude的插件功能。Your organization hasn't provided plugins. Contact your organization administrator to add them.
- #4345About menu, codex is installed through the Microsoft Store, but CC Switch did not detect the local installation information
- #4695点记报错，之前的低版本是不报错的
- #4758本地环境检查时无法正确的识别到 Codex
- #4993BUG：会造成CODEX持续进行 API CAll，大量浪费TOKEN。
- #5070Win11 LSTC 版本无法运行或安装
- #5076安装skill(ui-ux-pro-max)失败
- #5122版本 26.623.101652 配合3.16.5无法使用
- #5715软件无法打开
- #5777[Bug] Hermes Prompt 模板默认文件名为 AGENTS.md，应为 SOUL.md
- #6161无法正常升级，卸载掉重新安装报错
- #6283Windows版安装程序写入了错误的注册表
- #6302[Bug] Tooltip and active dots are misaligned in usage trend charts spanning multiple years
(No FAQ yet)
Related problems
Section titled “Related problems”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.