CC Switch 安装与配置教程

工具概述

CC Switch 是一款跨平台桌面工具，专为 AI 编程助手（如 Claude Code、Codex、Gemini CLI）设计，可一键管理多个 API 供应商配置，实现模型服务的快速切换，无需手动改文件或重启服务

核心功能

一键切换供应商：在 Claude、Codex、Gemini 等 AI 编程工具间快速切换，无需反复修改配置文件

多分组独立管理：Claude、Codex、Gemini 的配置互不干扰，支持分组独立管理

MCP 统一管理：一次配置可让多个工具共用 Skills 扩展能力

系统托盘常驻：右键菜单即可切换模型，无需打开主窗口

多终端支持：Windows、macOS、Linux 全平台可用，支持 WSL 环境自动同步配置

自定义配置：支持编辑配置文件进行高级调整

支持系统

Windows 10+、macOS 12+、Linux（Ubuntu / Debian / Fedora）

一、下载与安装

1. 获取安装包

GitHub 项目地址：https://github.com/farion1231/cc-switch

打开项目页面后，找到右侧的 Releases，点击进入

2. 选择对应版本

下拉找到 Assets 软件安装包列表，选择适合你电脑系统的版本

3. 安装

点击对应安装包后，浏览器会弹出下载提示，依照提示安装 CC Switch 即可

二、配置 MoYunAPI

1. 添加配置

在顶部导航栏中选择需要配接 API 的软件，然后点击右上角 + 号添加配置

2. 选择配置方式

可以选择以下两种方式之一：

左侧 · 单独配置：为选中的软件（如 Claude）单独配置供应商。

右侧 · 统一配置：为所有工具统一配置同一供应商

💡 以下以单独配置 Claude 为例进行演示

选择 自定义配置，然后下滑填写 API 相关信息

3. 填写 API 信息

配置项	填写内容	说明
供应商名称	`MoYunAPI`	自定义名称，便于识别
备注	选填	可留空
官网链接	`https://moyunapi.com`	MoYunAPI 官网地址
API Key	你的 API 密钥	在 MoYunAPI 平台获取的 API Key
请求地址（Base Url）	`https://moyunapi.com`	MoYunAPI 接口地址
API 格式	`OpenAI Chat Completions`	不同模型/厂商格式不同，需注意区分
认证字段	`ANTHROPIC_AUTH_TOKEN`	默认值，一般无需修改

⚠️ 安全提醒
请妥善保管令牌密钥，不要在公开场合或不可信的平台中展示。若令牌疑似泄露，请及时禁用或删除，并创建新令牌

4. 配置模型映射

填写完上述信息后，可点击 获取模型列表，一键获取可用模型名称并直接选择填入

以下示例使用 4 款不同的 AI 模型进行展示（也可以全部使用同一模型）：

模型角色	显示名称	实际请求模型
Sonnet	`deepseek-v4-flash`	`deepseek-v4-flash`
Opus	`mimo-v2.5`	`mimo-v2.5`
Fable	`MiniMax-M3`	`MiniMax-M3`
Haiku	`gpt-5.6-luna`	`gpt-5.6-luna`
Subagent（子 Agent 默认模型）	不显示在 /model 菜单	`LongCat-2.0`

默认模型兜底：deepseek-v4-flash

其他设置：按需填写，不修改也可正常使用

全部设置完成后，点击保存

三、测试与使用

1. 测试连通性

保存配置后，测试连通性，然后启动并开启路由

2. 在 Claude Code CLI 中使用

启动 Claude Code CLI，输入 /model 并回车，即可看到并使用已接入的模型

3. 验证模型可用性

选择 Haiku 4.5 模型（按照上述配置，会映射到 gpt-5.6-luna），发送消息测试是否可用

4. 查看使用统计

此外，还可以在 CC Switch 的 设置 → 使用统计 中查看使用情况，例如上述问答的 Token 使用详情：

CC Switch 安装与配置教程

工具概述#

核心功能#

支持系统#

一、下载与安装#

1. 获取安装包#

2. 选择对应版本#

3. 安装#

二、配置 MoYunAPI#

1. 添加配置#

2. 选择配置方式#

3. 填写 API 信息#

4. 配置模型映射#

三、测试与使用#

1. 测试连通性#

2. 在 Claude Code CLI 中使用#

3. 验证模型可用性#

4. 查看使用统计#