切换供应商后配置不生效/丢失 - cc-switch
Quick fix
升级 cc-switch 到 v3.16.2+（v3.18.0 修复 nvm 路径识别），如遇覆盖问题将自定义配置写入"通用配置"避免被清空，Linux 保存失败需 v3.11.1+。
Symptom
Section titled “Symptom”切换路由状态失败{{detail}}该问题群涉及 cc-switch 在不同版本和平台下的配置写入缺陷：v3.15.0-v3.16.1 期间，路由切换失败时错误提示显示 {{detail}} 占位符而非具体原因（#3727）；Windows 下存在 localhost 与 127.0.0.1 绑定不一致导致的路由状态切换失败（#3727）。v3.16.0-v3.16.3 使用 nvm 管理的 Node.js 环境无法被 GUI 识别（PATH 过瘦），导致无法升级 Codex/Claude Code 或提示 env: node: No such file or directory（#4448, #3584）。此外，旧版本切换供应商时会整份重写配置文件，导致自定义插件配置、MCP 设置或通用配置丢失（#1459, #946, #2999），该问题在 v4.0.0 改为仅替换关键字段后解决。Linux 下曾存在单个 provider 编辑保存失败的 bug（#1179），Codex 桌面端存在升级后供应商配置全部失效的个案（#4948）。
升级到最新版本：路由切换失败显示 {{detail}} 占位符及 nvm 识别问题已在 v3.16.2 和 v3.18.0 修复
若使用 nvm 管理 Node.js 且升级报错 env: node: No such file or directory，临时方案：在终端手动执行 npm i -g @openai/codex@latest 或创建软链接到系统路径
Linux 下单个 provider 编辑保存失败：升级到 v3.11.1 或更高版本
防止切换供应商时自定义配置（如 MCP、插件）被覆盖：将通用配置写入"通用配置"区域而非单个供应商配置，或升级到 v4.0.0（该版本改为仅替换地址/密钥/模型等关键字段）
~/.claude/settings.json 或 Codex 对应配置文件 // 在 cc-switch 的"通用配置"中填入自定义设置，而非依赖单个供应商配置Codex 桌面端升级后配置全部丢失：尝试回退到 v3.16.4 或重新在 cc-switch 中配置并确保写入"通用配置"
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 28 个真实 issue
- #797自定义配置是mac的icloud,有问题,无法看到打开的日志. 空格问题吧
- #921codex的api请求地址重视丢失
- #946mcp配置格式问题
- #1179linux 版本下对单个 provider 配置编辑保存失败
- #1430复制命令行启动specific provider的terminal 出错
- #1459cc switch切换供应商，覆盖了claude code的原配置文件，现在官方的插件marketplace已经不显示了，有啥方法能够复原吗？
- #1993OMO改名了，配置还是旧的插件名
- #2125claude code 切换不同供应商后，原来下载的 plugin 无法被激活
- #2161mcp名称不能自己设置
- #2615codex切换配置a到b,会导致a的会话无法使用报错
- #2664codex mac端应用，使用ccs切换到custom配置的API后，无法使用插件
- #2999编辑通用配置，怎么就自动保存了？ 我都没点保存！！！！！
- #3037保存配置的时候有几率卡死（无响应）
- #3063oh-my-openagent无法通过json编辑保存
- #3135切换claude 配置的时候，如果其他的agent的配置文件出错，则会切换失败
- #3181设置-路由配置路由启动 Claude 提示切换路由状态失败:{(detail)}
- #3395本地环境检查误报
- #3584软件检测不到nvm安装的node路径
- #37273.16.1 Windows版本提示“切换路由状态失败”，Mac版本正常
- #3769无法切换api
- #4145claude desktop无法识别网关
- #4448在cc-switch内更新codex和claude code版本的时候报错
- #4754如何在 Configure third-party inference 中退出 Organization-managed 配置
- #4906ockpit-tools问题
- #4948升级到版本v3.16.5后之前配置的可用服务商在使用codex桌面端时全部都不能用了，删掉重新配置同样无法使用，天塌了
- #5436[Bug] 无法创建两个及以上的OpenAI官方渠道的供应商配置
- #5612Codex"+"不见了， 无法添加API
- #6543CC switch关闭后codex设置丢失。
- 切换供应商后 Claude Code 的插件/ marketplace 消失了怎么办？
- 检查 cc-switch 的"通用配置"中是否有备份，或查看安装后导入的 default 供应商。v4.0.0 后切换不再整份覆盖配置，可减少此类问题。
- 为什么提示"切换路由状态失败"但不显示具体原因？
- 这是 v3.16.1 及之前版本的 bug，错误提示中的 {{detail}} 占位符未被正确替换。升级到 v3.16.2 或更新版本后，错误提示会显示具体的后端错误详情。
- 使用 nvm 安装的 Node，cc-switch 检测不到或无法升级 Codex 怎么办？
- 这是 v3.16.x 的已知问题（GUI 环境 PATH 过瘦）。临时解决方案：在终端执行 npm i -g @openai/codex@latest 手动升级，或创建 node 的软链接到 /usr/local/bin。该问题已在 v3.18.0 修复。
- Linux 下编辑单个 provider 配置保存后无效？
- 这是 v3.11.0 及之前版本的 bug，请升级到 v3.11.1 或更高版本。
- Codex 升级后所有供应商配置失效？
- 有用户报告 v3.16.5 升级后出现此问题。建议先回退版本，或在 cc-switch 中将配置写入"通用配置"区域以避免被重置。
- 如何避免 cc-switch 覆盖我的自定义 MCP 配置？
- 在旧版本中，切换供应商会整份重写配置。请将自定义 MCP 配置写入"通用配置"（对所有供应商生效），而非单个供应商配置；或升级到 v4.0.0，该版本改为仅替换关键字段，保留其他自定义设置。
- 编辑通用配置时为什么自动保存了？
- v4.0.0 之前的通用配置编辑弹窗会在特定操作下自动保存。该编辑方式已在 v4.0.0 移除，改为切换时仅替换关键字段，其余设置保留在原配置文件中。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。