CC Switch 配置教程

通过 CC Switch 集中管理 Claude Code、Codex、Gemini、OpenCode、OpenClaw 等工具的 API 供应商配置，支持动态切换默认渠道，无需重启 Gateway。

安装 CC Switch

参考官方文档：https://github.com/farion1231/cc-switch/blob/main/README_ZH.md

系统	安装方式
Linux	下载 `.deb` / `.rpm` / `.AppImage` / `.flatpak` 包
macOS	`brew tap farion1231/ccswitch && brew install --cask cc-switch`
Windows	下载 `.msi` 安装包或 `.zip` 绿色版

[!TIP]
更新：brew upgrade --cask cc-switch

添加 Claude Code

第 1 步：添加供应商

点击右上角 + 图标 → 添加供应商 → 选择 Claude 供应商 → 创建自定义配置。

第 2 步：填写配置

配置项	值
供应商名称	自定义名称（如 `My Claude API`）
API Key	你的 cerouter-AI 密钥
请求地址	`https://cerouter.com`

⚠️ 注意： 请求地址末尾不要加斜杠，否则可能引发双斜杠路径问题。

第 3 步：选择模型

打开模型广场，选中目标模型，复制并粘贴到 CC Switch 中。

第 4 步：验证配置

配置完成后，检查 ~/.claude/settings.json 中是否包含正确的配置信息。

第 5 步：启动 Claude Code

打开新终端（务必重启终端以使配置生效），进入项目目录运行：

⚠️ 若仍要求登录： 在 CC Switch 中开启 跳过 Claude Code 初次安装确认。路径：设置 → 通用 → 窗口行为 → 跳过 Claude Code 初次安装确认。

添加 Codex

第 1 步：添加供应商

切换到 CODEX 页签 → 点击右上角 + 图标 → 添加供应商 → 选择 Codex 供应商 → 创建自定义配置。

第 2 步：填写配置

配置项	值
供应商名称	自定义名称（如 `My Codex API`）
API Key	你的 cerouter-AI 密钥
请求地址	`https://cerouter.com/v1`

第 3 步：选择模型

点击获取模型列表，选择所需模型并保存。

第 4 步：启动 Codex

打开新终端，进入项目目录运行：

输入 /status 查看状态。

添加 Gemini

第 1 步：添加供应商

点击右上角 + 图标 → 添加供应商 → 选择 Gemini 供应商 → 创建自定义配置。

第 2 步：填写配置

配置项	值
供应商名称	自定义名称（如 `My Gemini API`）
API Key	你的 cerouter-AI 密钥
请求地址	`https://cerouter.com`

⚠️ 注意： Base URL 末尾不要加斜杠。

第 3 步：选择模型

点击获取模型列表，选择目标模型（如 gemini-2.5-pro）并保存。

第 4 步：启动 Gemini CLI

打开新终端，进入项目目录运行：

看到对话界面并正常回复即表示配置完成。

添加 OpenCode

第 1 步：添加供应商

切换到 OpenCode 页签 → 点击右上角 + 图标 → 添加供应商 → 选择 OpenCode 供应商 → 创建自定义配置。

第 2 步：填写配置

配置项	值
供应商名称	自定义名称（如 `My OpenCode API`）
API Key	你的 cerouter-AI 密钥
请求地址	`https://cerouter.com/v1`

⚠️ 注意： Base URL 末尾不要加斜杠。

第 3 步：选择模型

点击获取模型列表，选择所需模型（支持添加多个）。高级选项中可选择输入类型，支持图片理解的模型可勾选 Image。

第 4 步：安装 OpenCode CLI（若未安装）

第 5 步：连接模型服务

输入框输入 /connect 并回车

在 Provider 列表搜索框中输入供应商名称（如 cerouter），选中后回车

粘贴 API Key，回车

在模型列表中选择所需模型，回车

第 6 步：启动 OpenCode

打开新终端，进入项目目录运行：

添加 OpenClaw

第 1 步：添加供应商

点击右上角 + 图标 → 添加供应商 → 选择 OpenClaw 供应商 → 创建自定义配置。

第 2 步：填写配置

配置项	值
供应商名称	自定义名称（如 `My OpenClaw API`）
API Key	你的 cerouter-AI 密钥
请求地址	`https://cerouter.com/v1`

第 3 步：选择模型

点击获取模型列表，选择所需模型（支持添加多个）。高级选项中可选择输入类型，支持图片理解的模型可勾选 Image。

第 4 步：设为默认

保存后点击添加并 设为默认。

通用说明

动态切换默认渠道

CC Switch 支持在不重启 Gateway 的情况下动态切换默认渠道：

在供应商列表中，直接点击目标供应商的 「设为默认」 按钮，切换立即生效，无需重启任何服务。

重启终端的重要性

⚠️ 务必关闭并重启终端，这是让新配置生效的关键一步。未重启终端可能导致工具仍使用旧配置或要求重新登录。

目录#

安装 CC Switch#

添加 Claude Code#

第 1 步：添加供应商#

第 2 步：填写配置#

第 3 步：选择模型#

第 4 步：验证配置#

第 5 步：启动 Claude Code#

添加 Codex#

第 1 步：添加供应商#

第 2 步：填写配置#

第 3 步：选择模型#

第 4 步：启动 Codex#

添加 Gemini#

第 1 步：添加供应商#

第 2 步：填写配置#

第 3 步：选择模型#

第 4 步：启动 Gemini CLI#

添加 OpenCode#

第 1 步：添加供应商#

第 2 步：填写配置#

第 3 步：选择模型#

第 4 步：安装 OpenCode CLI（若未安装）#

第 5 步：连接模型服务#

第 6 步：启动 OpenCode#

添加 OpenClaw#

第 1 步：添加供应商#

第 2 步：填写配置#

第 3 步：选择模型#

第 4 步：设为默认#

通用说明#

动态切换默认渠道#

重启终端的重要性#

目录

安装 CC Switch

添加 Claude Code

第 1 步：添加供应商

第 2 步：填写配置

第 3 步：选择模型

第 4 步：验证配置

第 5 步：启动 Claude Code

添加 Codex

第 1 步：添加供应商

第 2 步：填写配置

第 3 步：选择模型

第 4 步：启动 Codex

添加 Gemini

第 1 步：添加供应商

第 2 步：填写配置

第 3 步：选择模型

第 4 步：启动 Gemini CLI

添加 OpenCode

第 1 步：添加供应商

第 2 步：填写配置

第 3 步：选择模型

第 4 步：安装 OpenCode CLI（若未安装）

第 5 步：连接模型服务

第 6 步：启动 OpenCode

添加 OpenClaw

第 1 步：添加供应商

第 2 步：填写配置

第 3 步：选择模型

第 4 步：设为默认

通用说明

动态切换默认渠道

重启终端的重要性