CC Switch 如何使用

它是什么

CC Switch 是一个面向 Claude Code、Codex、Gemini CLI 等工具的可视化配置和切换中心，重点解决“频繁改 JSON / TOML 配置、切换多个 Provider、管理 Skills 和 MCP 太麻烦”的问题。

适合谁

适合需要快速理解 CC Switch 的作用、并想知道如何开始操作的新用户，也适合经常在多个模型、多个 API 提供商和多个 CLI 工具之间来回切换的用户。

使用前准备

先确认你要管理的是 Claude Code、Codex、Gemini CLI 还是其他受支持工具
准备好至少一个可用的 API Key、Base URL 和模型名
如果你的电脑上以前手动配过环境变量或配置文件，先确认是否可能和 CC Switch 冲突

使用技巧

首次启动后，优先让 CC Switch 导入已有配置，这通常比完全手动重建更快。
添加第一个 Provider 时，能用内置预设就先用预设，只有特殊平台再手动填完整参数。
启用 Provider 之前，先用健康检查验证连通性，这样能提前发现 API Key、地址或代理问题。
如果你同时管理多个 CLI，建议先只启用一个最常用客户端，跑通后再接入其他工具。
经常切换模型时，可以把常用 Provider 命名得更直观，比如按“平台 + 模型 + 价格层级”命名，后期更不容易选错。
Skills、MCP 和 Session Manager 都值得单独利用起来，CC Switch 的价值不只是“切模型”，还包括集中管理这些开发辅助能力。

操作步骤

启动 CC Switch，选择你当前要管理的目标应用。
点击添加 Provider，优先从预设中选择匹配的平台。
填入 API Key、接口地址、模型名和协议格式。
先运行健康检查，再点击启用，让配置写入对应 CLI。
回到终端中启动目标工具，验证是否已经使用新的 Provider。
基础配置通过后，再继续使用 MCP、Skills、备份和会话管理等高级能力。

注意事项

不同 CLI 对“热切换”的支持程度不同；如果界面里切换了但实际请求没变，先尝试重启终端或对应 CLI。
如果你之前手动配置过环境变量，可能会覆盖 CC Switch 写入的配置，这是常见冲突来源。
本地代理、协议格式和目标 Provider 三者要匹配；配置对了地址但协议错了，依然会请求失败。
多 Provider 共存时，务必检查当前启用的是哪一个，很多“请求发错平台”的问题其实是启用状态搞混了。
在公共环境演示时，注意不要把真实密钥留在截图或录屏中。

常见问题

为什么我切换了 Provider，但终端结果没变？

常见原因是 CLI 没有重新读取新配置，或者本机旧环境变量仍在生效。先检查启用状态、环境变量，再决定是否重启终端。

它只是“切换模型”的工具吗？

不是。它还适合统一管理 MCP、Skills、Prompts、备份和多个 CLI 工具的配置。

相关资源