跳转到内容

cc-switch 配置不生效 / 切换后未应用 - Claude Code / Codex

Quick fix

先确认目标应用实际读取的配置路径与 cc-switch 写入路径一致,再检查路由/插件开关、重复键和版本兼容性。

报错原文
切换对 Claude Code for VS Code 不生效 。
最新版的Claude Code for VS Code 使用GUI启动了,不再通过命令行启动,配置env好像不生效了。

该集群包含多种“配置不生效”场景,根因并不相同:

1. cc-switch 写入的配置路径与目标应用实际读取路径不一致。例如 Hermes 在 Windows 上读取 %LOCALAPPDATA%\hermes,而旧版 cc-switch 写入 ~/.hermes;WSL 与 Windows 不共用同一份 Claude Code 配置;新版 Claude Desktop 可能不再从原有 Claude-3p/configLibrary 路径读取配置。 2. cc-switch 在切换或路由模式下会重写目标配置文件,导致用户手动添加的字段被覆盖或丢失,例如 hooks、coworkEgressAllowedHosts、cc-switch-model-catalog.json 中的 supported_reasoning_levels 等。 3. 目标应用或上游格式更新后,cc-switch 生成的字段不再被识别。例如 Claude Desktop 更新后 1M 上下文声明失效,需要把 claude-opus-4-8 回退为 claude-opus-4-6;Codex 模型目录缺少推理强度声明时会退化为 none/high。 4. 配置本身存在冲突或功能开关未启用,例如重复键导致保存失败,Claude Code for VS Code 需要勾选“应用到Claude插件”,Codex 特殊 TOML 字段如 startup_timeout_sec 旧版本无法通过 UI 正确写入。

  1. 确认目标应用实际读取的配置文件路径。若使用 WSL,请在 cc-switch 的 设置 > 高级 > 配置文件目录 中改为 WSL 内的配置路径;Windows 与 WSL 不共用同一份配置。

  2. 如果是 Claude Code for VS Code 不生效,请在 cc-switch 设置中勾选“应用到Claude插件”,然后重启 VS Code / Claude 插件。

  3. 如果保存或切换时提示重复键,先清理供应商/模型映射中的重复键名,再重新保存。

  4. 如果 Claude Desktop 更新后 1M 上下文不生效,可临时修改 cc-switch 数据库中的 claudeDesktopModelRoutes,将 claude-opus-4-8 改为 claude-opus-4-6,然后重启 Claude Desktop。

    .cc-switch/cc-switch.db
    # 在 claudeDesktopModelRoutes 字段中:
    # 将 claude-opus-4-8 改为 claude-opus-4-6
  5. 如果是 Hermes 在 Windows 上不生效,请升级 cc-switch 到 v3.16.5 或更新版本;该版本会按 HERMES_HOME > 平台默认路径解析配置目录。

  6. 如果 Codex 思考强度只剩 none/high,添加第三方 Codex 供应商时不要手动添加映射模型,让 cc-switch 使用默认全部模型配置;如需 supported_reasoning_levels,请注意切换供应商可能覆盖该文件。

  7. 如果你手动修改了 Claude Code 配置(例如 hooks),避免在路由模式下直接切换回非路由模式;当前路由模式切换到非路由模式可能导致手动修改丢失。建议先备份配置文件。

ToolClaude Code / Codex
Version3.15.0 - 3.20.0
PlatformsWindowsmacOSLinux

本页汇总自 28 个真实 issue

为什么 cc-switch 切换后 Claude Code for VS Code 不生效?
请先在 cc-switch 设置中勾选“应用到Claude插件”。如果仍不生效,确认 VS Code 使用的是 cc-switch 写入的环境变量/配置路径,并重启 VS Code。
为什么我手动加的 hooks、通用配置或 coworkEgressAllowedHosts 会被覆盖?
cc-switch 在切换供应商或路由模式时会重写目标配置文件。当前部分字段不会被保留,建议在切换前备份配置,或等待 cc-switch 支持合并用户自定义字段。
Claude Desktop 更新后 1M 上下文配置不生效怎么办?
临时方案是修改 .cc-switch/cc-switch.db 中 claudeDesktopModelRoutes,把 claude-opus-4-8 改成 claude-opus-4-6,然后重启 Claude Desktop。
WSL 里的 Claude Code 配置为什么不更新?
Windows 和 WSL 不共用同一个配置文件。需要在 cc-switch 的 设置 > 高级 > 配置文件目录 中指向 WSL 内的配置路径。
Codex 的 startup_timeout_sec 为什么无法通过 cc-switch 设置?
旧版本中 Codex 配置文件格式特殊,部分自定义字段无法通过 UI 正确写入。维护者表示需要较大重构,临时方案是不使用 cc-switch 管理该 MCP 字段,或手动编辑 Codex 配置。
Codex 思考强度只剩 none 和 high 是什么原因?
cc-switch 生成的模型目录可能没有声明 low/medium/high/xhigh 等推理强度。添加第三方 Codex 供应商时不要手动添加映射模型,让 cc-switch 使用默认全部配置;手动修改 cc-switch-model-catalog.json 可能在切换供应商后被覆盖。
如何完全删除 cc-switch?
删除 cc-switch 应用本身,并手动清理相关配置目录,例如 ~/.cc-switch 和 ~/.codex。会话记录通常保存在 ~/.codex 中,与 cc-switch 本身无关。

这是一个非官方社区 wiki,与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。