cc-switch快速配置#
安装cc-switch#
Linux用户:#
CC-Switch-v{版本号}-Linux.deb(Debian/Ubuntu)
CC-Switch-v{版本号}-Linux.rpm(Fedora/RHEL/openSUSE)
CC-Switch-v{版本号}-Linux.AppImage(通用)
CC-Switch-v{版本号}-Linux.flatpak(Flatpak)
macOS 用户:#
方式一:通过 Homebrew 安装#
方式二:手动下载#
从 Releases 页面下载 CC-Switch-v{版本号}-macOS.zip 解压使用。Windows 用户:#
从 Releases 页面下载最新版本的 CC-Switch-v{版本号}-Windows.msi 安装包或者 CC-Switch-v{版本号}-Windows-Portable.zip 绿色版。添加 Claude Code#
1.
点击右上角+号图标,添加新供应商:点击"添加供应商" → 选择"Claude 供应商" → 选择创建自定义配置。

2. 填写配置信息后,点击保存,并在主界面启用新创建的供应商。3.
打开模型广场,选择你要的模型,复制后贴入cc switch。

cc-switch配置好后,可以看到在Claude Code 配置目录的settings.json中看到如下配置信息:3.
最后打开终端(请务必关闭并重启终端,这是让新配置生效的关键一步),进入到项目目录,输入claude启动Claude Code。
若启动Claude Code后,仍然要求登录,可以在cc-switch中开启跳过 Claude Code 初次安装确认。点击"设置" → "通用" → "窗口行为" → "跳过 Claude Code 初次安装确认":

添加 Codex#
1.
切换到CODEX页签,点击右上角+号图标,添加新供应商:点击"添加供应商" → 选择"Codex 供应商" → 选择创建自定义配置。

2. 填写配置信息后,点击保存,并在主界面启用新创建的供应商。
这里api请求地址用 https://www.aiide.com/v1
3. 最后打开新的终端(请务必关闭并重启终端,这是让新配置生效的关键一步),进入到项目目录,输入codex启动Codex。 输入/status 查看添加 Gemini#
1.
点击右上角 + 号图标,添加新供应 商:点击“添加供应商”→ 选择“Gemini 供应商”→ 选择创建自定义配置。
2.
填写配置信息后,点击保存,并在主界面启用新创建的供应商。
供应商名称:自定义名称(如“My Gemini API”)
请 求地址:使用 https://www.aiide.com
⚠️ 注意:Base URL 末尾不要加斜杠,否则会导致 API 路径拼接出现双斜杠引发请求失败。
3.
点击获取模型列表,选择你要的模型(如 gemini-3.1-pro)点击保存即可。
cc-switch 配置好后,可以在 Gemini CLI 的配置目录中看到对应的配置信息。4.
最后打开终端(请务必关闭并重启终端,这是让新配置生效的关键一步),进入到项目目录,输入 gemini 启动 Gemini CLI。看到对话界面并能正常回复即表示配置完成。
添加 OpenCode#
1.
切换到 OpenCode 页签,点击右上角 + 号图标,添加新供应商:点击“添加供应商”→ 选择“OpenCode 供应商”→ 选择创建自定义配置。
2.
填写配置信息后,点击保存,并在主界面启用新创建的供应商。
供应商名称:自定义名称(如“My OpenCode API”)
请求地址:使用 https://www.aiide.com/v1
Base URL 末尾不要加斜杠,否则会导致 API 路径拼接出现双斜杠引发请求失败。
3.
点击获取模型列表,选择添加模型,支持添加多个,然后选择你要使用的模型。
4.
确保已安装 Node.js 18 及以上版本:node -v
全局安装 OpenCode:npm install -g opencode-ai

6. 最后打开终端(请务必关闭并重启终端,这是让新配 置生效的关键一步),进入到项目目录,输入 opencode 启动 OpenCode。
7. 连接模型服务:2.
在 Provider 列表的搜索框中输入刚刚填入的供应商(kk)进行搜索,选中并单击 Enter。

添加OpenClaw配置(小龙虾)#
1.
打开 CC Switch 客户端,在供应商管理界面,点击右上角 + 号图标, 选择自定义配置。

2.
填写配置信息后,点击保存,并在主界面启用新创建的供应商。供应商名称:自定义名称(如“My OpenClaw API”)
请求地址:使用 https://www.aiide.com/v1

3. 点击获取模型列表,选择添加模型,支持添加多个,然后选择你要使用的模型。高级选项中,你可以选择输入类型,如果模型支持图片理解可以勾选image。
4. 保存后点击添加并设为默认。

CC Switch 支持在不重启 Gateway 的情况下动态切换默认渠道
操作方式:在 CC Switch 的供应商列表中,直接点击目标供应商的「设为默认」按钮,切换立即生效,无需重启任何服务。
Modified at 2026-05-29 04:34:58