返回首页

CC Switch 配置教程

CC Switch 可以集中管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等开发工具的 API 供应商配置。配置好以后，在 CC Switch 里切换供应商，再重启对应终端即可生效。

适合谁同时使用多个 CLI 工具，想统一管理 API 地址、Key 和模型的人。
推荐方式优先使用统一供应商，一次配置同步到多个工具。
生效方式切换供应商后，重启正在运行的命令行会话。

一、下载安装

下载 CC Switch

打开 CC Switch 的 GitHub Releases 页面，下载适合自己系统的安装包。Windows 用户建议下载 .msi 安装包，后续更新会更方便。

打开下载页面

安装并启动

运行安装包完成安装。如果 Windows 出现 SmartScreen 提示，确认来源是 GitHub Releases 后，可以点“更多信息”，再点“仍要运行”。

二、开启插件接管

进入设置

首次打开 CC Switch 后，点击左上角的齿轮图标，进入全局设置页面。

打开应用接管开关

在“通用”选项里，开启你要使用的工具接管开关，例如“应用到 Claude Code 插件”“应用到 Codex 插件”等。只有开启后，CC Switch 切换供应商才会写入对应工具配置。

可选：开启开机自启

如果你经常使用这些 CLI 工具，可以顺手开启开机自启，避免每次手动启动。

三、添加统一供应商

推荐用“统一供应商”。这样同一个 API 地址和 Key 可以同时给 Claude Code、Codex、Gemini CLI 等工具使用，后续切换更省事。

点击添加供应商

回到主界面，点击右上角的加号，进入添加供应商窗口。

选择统一供应商

切到“统一供应商”标签，点击“添加统一供应商”。供应商类型可以选择 NewAPI 或自定义网关，按你的 API 服务类型来选。

填写 API 信息

名称自定义即可，例如 我的 API。
API 地址填写你的服务地址，例如 https://ai.wdcodex.xyz。
API Key填写你购买或后台生成的 Key。
模型填写要用的模型，例如 gpt-5.3-codex。

选择要同步的工具

往下找到应用列表，勾选需要同步配置的工具，例如 Claude Code、Codex、Gemini CLI、OpenCode 或 OpenClaw。

设置默认模型并保存

给不同工具设置默认模型，检查无误后点击添加或保存。

四、单独配置某个工具

如果你只想让某一个工具使用这个供应商，也可以不用统一供应商，直接进入对应工具标签单独添加。

  • Claude Code：进入 Claude 标签，添加供应商时选择兼容 OpenAI 的 API 格式，填入 API 地址、Key 和模型。
  • Codex：进入 Codex 标签，填写同样的 API 地址和 Key，然后选择或填写模型。
  • Gemini CLI：进入 Gemini 标签，使用第三方兼容 API 时，认证方式通常选择 API Key / Bearer Token。
  • OpenCode：进入 OpenCode 标签，保存供应商后点击卡片设为 Active。
  • OpenClaw：进入 OpenClaw 标签，根据需要调整 Env、Tools、AgentsDefaults 等配置。

五、常见注意点

  • 在 CC Switch 里切换供应商后，重启当前正在运行的终端或 CLI 会话。
  • 如果某个工具没有生效，先检查它对应的“应用接管”开关有没有打开。
  • API 地址不要乱加多余路径。统一供应商里通常填基础地址，具体是否带 /v1 取决于当前供应商类型和 CC Switch 页面提示。
  • 模型名要和你的 API 服务实际支持的模型一致，否则工具能启动但调用会报模型不存在。