CC Switch 是什么
CC Switch 是一款跨平台桌面配置管理应用，用统一界面保存并一键切换 Codex、Claude Code 等受管应用的供应商配置。普通直连模式下，选中的配置写入客户端后会持续生效；配置不变时可以直接使用客户端，不必每次打开 CC Switch。
它主要解决什么问题
多个客户端和 API 供应商各有不同配置文件，手动修改既费时间，也容易把旧地址、旧 Key 或其他客户端字段混进来。
小贺 API 用户：控制台支持从 Key 右侧直接“导入到 CCS”，导入后确认目标配置并启用即可，不需要再手动逐项填写。
一次切换到底做了什么
官方切换说明显示，点击“启用”后，CC Switch 会更新目标应用的配置文件，并把该供应商标记为“当前启用”。
- 1在 CC Switch 选择配置找到目标应用下准备使用的供应商。
- 2点击“启用”CC Switch 更新目标客户端的实时配置文件。
- 3让客户端重新读取Codex 完全退出后重开；Claude Code 通常即时生效。
- 4直接使用客户端配置保持不变时无需再次打开 CC Switch。
以 Codex 为例，CC Switch 会更新 ~/.codex/auth.json，并在需要时更新 ~/.codex/config.toml。这些文件属于 Codex 自己的配置来源，因此写入完成后不会因为关闭 CC Switch 就自动失效。
配置好以后需要一直打开吗
普通直连配置：不需要
- 启用后配置已经写入目标客户端文件
- 配置不变时直接使用 Codex 或 Claude Code
- 关闭 CC Switch 不会删除当前配置
- 下次需要换配置时再打开即可
本地代理模式：需要运行
- 应用接管后，请求会经过本地代理地址
- 请求日志、用量统计和故障转移依赖代理
- API 格式转换也需要代理服务在线
- 停止代理时，CC Switch 会恢复原始配置
绝大多数只想快捷配置和切换的用户：使用普通直连模式即可。配置启用并验证成功后，可以关闭 CC Switch；平时直接打开 Codex 工作。
什么时候再打开 CC Switch
配置好以后需要一直打开 CC Switch 吗？
普通直连模式不需要。启用配置后，CC Switch 已把内容写入目标客户端的配置文件；配置不变时可以关闭它，直接使用 Codex 或 Claude Code。
什么时候必须让 CC Switch 保持运行？
使用本地代理、应用接管、请求日志、格式转换或故障转移等运行时功能时，需要保持 CC Switch 的代理服务运行。
不用 CC Switch 可以吗？
可以手动编辑客户端配置文件或环境变量，但 CC Switch 的价值就是把保存、导入和切换变成可视化操作，减少反复手改。
普通用户最简单的使用方法
第一次完成导入和验证后，把 CC Switch 当成“需要换配置时才打开的设置工具”即可。
- 1导入或添加配置从支持深链接的控制台一键导入，或在 CC Switch 中保存供应商配置，用可视化操作代替手动编辑客户端配置文件。
- 2启用需要使用的配置在对应应用下点击“启用”，CC Switch 会把选中的内容写入 Codex、Claude Code 等目标客户端的实时配置文件。
- 3让客户端读取新配置Claude Code 通常即时生效；Codex 切换后需要完全退出旧会话并重新打开，再用最小请求验证。
- 4平时直接使用客户端配置不变时直接打开 Codex 或 Claude Code 工作；只有更换、编辑或管理配置时，才需要再次打开 CC Switch。
官方依据：CC Switch 官方网站、软件介绍、切换供应商和代理服务。本文据此区分普通直连与需要常驻的代理模式。