settings.json被全量重写导致插件失效 - CC Switch

Quick fix

多数相关 issue 仍未解决；升级至v3.20.1+，该版本已修复切换配置时清空enabledPlugins等字段的Bug。

Symptom

报错原文复制

[Bug] 切换 Claude Code 配置时 settings.json 被全量重写，enabledPlugins / statusLine 等字段被清空或重置

Cause

在 cc-switch v3.19.x 及更早版本中，切换供应商配置时存在三个叠加的 Bug：Common Config 仅首次抽取不更新、切换流程不回写 Common Config、以及自动推断逻辑失效。这导致 cc-switch 采用“读取内部模板并整体覆盖”的策略写入 `~/.claude/settings.json`，而非增量合并。结果就是非供应商专属字段（如 `enabledPlugins`、`statusLine.command`）被清空或重置为默认值，造成用户自定义插件和状态栏脚本静默失效。

该问题已在后续版本中通过引入增量合并机制修复，确保只更新与供应商相关的 `env` 字段，保留其他用户配置。

Fix

1. 1

   将 cc-switch 升级至最新版本（v3.20.1 或更高），以获取包含此修复的版本。

Affected Versions

ToolClaude Code

Version未知

PlatformsmacOSWindows

Source Issues

本页汇总自 9 个真实 issue

• #2694代理模式开启之后，模型映射没有写到 settings.json 中
• #2705为何明明启用了某个大模型，但在中断输出相关环境变量却是空的？
• #2961Claud Code无法调用BASH命令
• #3486Failover 切换 provider 时未同步更新 API Base URL，导致 400 错误
• #3631[Bug] 切换 Claude Code 配置时 settings.json 被全量重写，enabledPlugins / statusLine 等字段被清空或重置
• #4228[Feature] 代理接管模式下不应向 Claude Code settings.json 写入 ANTHROPIC_*_MODEL 字段
• #4404Reasoning model responses produce hundreds of fragmented `content_block_start` events instead of 2 (one thinking + one text)
• #4707火山方舟 detect_provider 仅匹配 api/coding，遗漏了 Agent Plan 的 api/plan 路径
• #6922[claude][proxy] GET /v1/models 对 Claude 槽位返回 Codex 格式响应体（unexpected body / model list endpoint format mismatch）

FAQ

升级后我的旧配置会丢失吗？

不会。升级只是替换了二进制文件。由于之前的 Bug 已经导致部分配置丢失，建议升级后重新检查 `~/.claude/settings.json` 中的插件和状态栏配置是否完好，如有必要请手动恢复。

为什么之前开启路由模式没这个问题？

路由模式主要涉及 `ANTHROPIC_BASE_URL` 的指向和模型映射逻辑（见 #2694）。而本 Issue 的核心是 `settings.json` 文件的整体写入策略错误，无论是否开启路由，只要触发配置切换且版本低于修复版，都会发生字段被清空的覆盖行为。

相关问题

Your access token could not be refreshed升级 cc-switch 至 v3.17.0+，修复接管时写入 PROXY_MANAGED 占位符污染 OAuth 凭证或导致 401 的问题。5 issues mergedtemporarily unavailable, so auto mode cannot升级 cc-switch 至 v3.15.0+ 以修复模型映射与 thinking 转换，或在通用配置中手动覆盖默认模型环境变量以匹配第三方后端。5 issues mergedDeepSeek前缀缓存命中率骤降 - CC Switch修复升级至 cc-switch v3.16.3 以修复格式转换导致的缓存命中率计算错误。2 issues merged