cc-switch 安装、更新及启动问题合集
Quick fix
该 issue 集群混合了安装、更新、启动和其他故障，无法从现有证据确认一个适用于全页的修复方案。
Symptom
Section titled “Symptom”无法正常升级，卸载掉重新安装报错该集群包含多个互不相关的问题，例如 Windows 安装或卸载失败、macOS 应用内更新后卡死、Skills 安装失败、CLI 检测异常，以及路由和配置问题。它们的原因和解决方式不同，无法合并为同一个故障主题。部分 issue 的关键细节只在未提供的截图中，或原文被截断，因此也无法据此补全错误信息或修复步骤。
请按具体错误或操作场景拆分排查：先确认对应 issue 中记载的应用、系统和版本，再参考该 issue 的维护者回复。现有材料不足以提供适用于整个集群的通用修复。
Affected Versions
Section titled “Affected Versions”Tool未知
Version未知
PlatformsWindowsmacOSLinux
Source Issues
Section titled “Source Issues”本页汇总自 53 个真实 issue
- #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
（暂无 FAQ）
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。