本文摘要多编码 CLI 手工切换供应商易改坏环境变量导致 Key 失效。cc-switch 将切换写入各 CLI 原生配置隔离落在文件层。已启动的进程不热重载多代理并行启动场景不适用本方案。一、问题与结论同一台机器上装了 Claude Code、Codex、OpenCode仓库描述里还列着 OpenClaw、Grok Build、Hermes Agent——标题中的5 个是社区对日常活跃代理的约数源仓库当前写的是 6 个这个差异本身就说明被管理对象在持续增长。切换模型供应商时要在~/.claude/settings.json、~/.codex/config.toml、~/.opencode/opencode.json之间来回改ANTHROPIC_API_KEY、OPENAI_API_KEY和 base URL改错一处就是 401或者把上一个代理的配置覆盖掉。本文要验证的结论是cc-switch 这类桌面应用把切换动作写入各 CLI 的原生配置文件隔离落在文件系统层GUI 中的当前状态与文件内容应当一致但已经跑起来的 CLI 进程不会自动重读配置进程层不在隔离范围内。也就是说统一管理没有减少状态份数只是把写入口集中到一处排查哪个 Key 真正生效时仍要回到文件层。二、排查与选择依据先记录环境否则 diff 结果无法复现项记录方式操作系统sw_vers本文写作环境macOS 14.6.1Apple SiliconClaude Codeclaude --version版本号未验证以实际运行输出为准Codexcodex --version同上OpenCodeopencode --version同上cc-switch桌面端版本以仓库 Releases 页为准未验证选择依据只有一条你要确认的是切换是否穿透到文件系统。因此排查动作固定为备份 → 切换 → diff任何不落盘的证据都不算数。另外注意 cc-switch 版本与被管理 CLI 版本是两层依赖升级前者不会升级后者。替代方案与取舍方案选择条件代价与边界手动 dotfiles 脚本代理 ≤ 2配置变更频率低零额外状态切换发生在 shell 层不存在 GUI 与文件层不一致的问题但每个路径与格式要各记一份环境变量 direnv各 CLI 支持同粒度变量覆盖最轻量、按目录自动加载不支持变量覆盖的代理无效进程启动后仍需重启容器/沙箱隔离配置可能互相污染、需严格隔离隔离最彻底镜像维护成本高代理的终端交互受容器限制什么时候不该用本文方案代理少于两个时手动管理更直接需要两个终端同时跑不同供应商时单活动档案模型最容易出现状态串扰该判断未验证。三、关键原理隔离可以发生在三层必须分开看GUI 层cc-switch 内部的 profile 索引只有打开应用才可见。文件系统层~/.claude/、~/.codex/、~/.opencode/下的原生配置脱离应用也生效。进程层已启动的 CLI 是否重读配置。多数 CLI 在启动时读取一次切换后不重读。三层的关系决定了更乱的真实来源出问题时排查链从直接看配置文件变成先看 GUI 状态 → 再看文件 diff → 再看进程启动时间链路变长而状态份数没减。四、可运行示例环境macOS 14.6.1Claude Code / Codex / OpenCode 各一个实例cc-switch 桌面端已安装。在 cc-switch 中导入供应商 A 的配置档案GUI 操作后执行# 1. 备份三个 CLI 的原生配置cp~/.claude/settings.json ~/.claude/settings.json.bakcp~/.codex/config.toml ~/.codex/config.toml.bakcp~/.opencode/opencode.json ~/.opencode/opencode.json.bak# 2. 记录切换前的 provider 字段grep-nANTHROPIC_API_KEY\|ANTHROPIC_BASE_URL~/.claude/settings.jsongrep-nmodel_provider\|base_url~/.codex/config.toml# 3. 在 cc-switch 桌面端切换到供应商 B然后回到终端比对diff~/.claude/settings.json.bak ~/.claude/settings.jsongrep-nbase_url~/.opencode/opencode.json# 4. 进程层验证先开着一个 claude 会话再切到供应商 C不重启会话直接发一条消息预期输出diff显示ANTHROPIC_API_KEY与ANTHROPIC_BASE_URL行被替换说明隔离穿透到了文件系统层若diff无任何输出说明切换只停在 GUI 层底层未落盘。实际输出未验证——请在你的机器上运行第 2、3 步并贴出diff结果本文不代填数据。常见失败切换后 Claude Code 报AuthenticationError原因是进程仍持有启动时读入的旧 Key进程层不热加载基于配置加载机制的推断未验证修复方法是退出 CLI 重新启动再用第 2 步的grep确认文件层已是新值。五、验证结果与边界验证点方法状态切换是否写入~/.claude/settings.json切换前后diff未验证多代理并行时是否互相覆盖两个终端各跑一个 CLI 后 diff未验证卸载 cc-switch 后配置处于什么状态测试机卸载后cat三份配置未验证GUI 显示状态与文件内容是否一致同一时刻比对界面与grep未验证边界结论GUI 与文件不一致时以文件层为准需要严格隔离配置污染时改用容器方案退出或卸载管理工具前先备份否则无法预判残留状态。参考资料farion1231/cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent
