CC-Switch 完全避坑指南｜新手必看

每次换 AI 供应商，要手动改配置文件？改错了 Claude Code 直接跑不起来？这篇文章把所有坑都整理出来了，照着做少走很多弯路。

🧩 它是什么？

CC-Switch 是一款完全开源免费的桌面工具，支持 Windows / macOS / Linux。

统一管理四大 AI 编程工具的配置：

• Claude Code
• Codex
• Gemini CLI
• OpenCode

切换供应商、API 密钥、模型——点一下，完成。GitHub 已有超过 14,500 Star，社区持续活跃。

💻 Windows 安装避坑

双击 .msi 报 Error 5 权限不足？

这不是 Bug，是 Windows 权限机制——MSI 文件右键没有"以管理员身份运行"选项。

正确做法：

1. Win 键搜索「命令提示符」→ 右键以管理员身份运行
2. 输入以下格式的命令：

text

msiexec /i "MSI文件完整路径" INSTALLDIR="目标安装路径"

想装到 D 盘、G 盘？把 INSTALLDIR 后面的路径改掉就行，非常灵活。

⚠️ 四个必须提前知道的坑

坑一：会完全覆盖你的配置文件

CC-Switch 每次切换供应商时整体替换配置文件，不是追加。原来的 Hooks、插件设置切换后全没了。

✅ 解决： 进入「通用配置」，把原来的配置内容粘贴进去保存，之后每次切换都会自动合并。

坑二：系统环境变量冲突

之前在 Windows 系统变量里写过 API 密钥？CC-Switch 启动后会弹出冲突提示。不处理的话，切换配置完全无效，Claude Code 还是读旧的值。

✅ 解决： 弹窗里全选 → 删除，让 CC-Switch 完全接管。

坑三：Skills 不会自动扫描

第一次打开不会自动导入原有 Skills，需要手动点「导入已有」选择原来的目录。

✅ 注意：只操作一次！ 导入两次同一目录，所有 Skills 都会重复，清理很麻烦。

坑四：符号链接创建失败

恢复备份或导入 Skills 时报「创建符号链接失败」？Windows 普通用户默认没有这个权限。

✅ 解决： 设置 → 系统 → 开发者选项 → 开启开发人员模式，重启 CC-Switch 即可，之后不需要每次手动提权。

🌟 最值得用的三个功能

① Skills 一套多用
在 CC-Switch 安装一个 Skill → Claude Code + Codex 自动同步，删除更新也同步，统一管理省心。

② 系统托盘一键切换
常驻托盘，右键菜单切换供应商，Claude Code 无需重启。

③ 国内供应商开箱即用
内置智谱 GLM、MiniMax 等预设，不需要 Anthropic 官方账号，填密钥直接用。

✅ 新手推荐配置流程

如果这篇内容对你有帮助，欢迎收藏备用。有问题欢迎评论区留言交流。

转自：https://mp.weixin.qq.com/s/2UPCmiTmKyUANlE617W_MA