CC Switch 多 AI 模型切换完整教程
基于 KeJiKe API 中转站，通过 CC Switch 统一配置管理器，实现 Claude Code、Codex CLI、Gemini CLI 等工具的模型一键切换，无需手动修改配置文件，兼顾成本与稳定性。
sub.kejike.top
一、产品概述
1.1 什么是 CC Switch
CC Switch 是一款 AI 编程工具统一配置管理器，专为 Claude Code、Codex CLI、Gemini CLI、OpenCode 等终端 AI 开发工具设计。核心作用是将所有工具的 API 配置集中管理，通过点击操作完成后端模型/供应商的秒级切换，无需手动编辑配置文件、重启终端。
1.2 核心价值（适配 KeJiKe API 场景）
- ▸ 零成本切换：无需修改代码、环境变量，托盘一键切换不同模型分组
- ▸ 多工具统一管理：一个软件同时管理 Claude、GPT/Codex、Gemini 等多类工具的后端
- ▸ 高可用保障：支持主备线路自动故障转移，配合 KeJiKe 多账号池实现稳定调用
- ▸ 成本可控：可快速切换不同倍率分组，日常开发用低价分组、复杂场景用高性能分组
- ▸ 用量可视化：统一统计各模型 Token 消耗，配合 KeJiKe 账单精准核对成本
二、前置准备
2.1 获取 KeJiKe API 密钥
- 访问 KeJiKe API 控制台，完成注册与登录
- 进入左侧「令牌管理」页面，点击「新建令牌」
- 根据需求选择对应模型分组（如 Claude Kiro 分组、GPT 标准分组、Gemini 分组），设置额度上限与有效期
- 复制生成的 API Key（格式为
sk-xxxxxxxx）
2.2 安装 CC Switch 客户端
- 访问 CC Switch 官方站点下载对应系统安装包
- 支持系统：Windows 10+、macOS 12+、主流 Linux 发行版
- 下载后按向导完成安装，首次启动会自动扫描本地已安装的 AI 编程工具
三、首次初始化与界面说明
3.1 首次启动引导
- 安装完成后打开 CC Switch，应用会自动检测本地已安装的终端 AI 工具
- 引导页选择「手动配置」（首次使用推荐），跳过导入步骤
- 进入主操作界面，完成基础初始化
3.2 界面功能总览
| 区域 | 功能说明 |
|---|---|
| 左侧边栏 | 工具列表：展示所有已识别的 AI 编程工具，可单独选中配置 |
| 中间区域 | 供应商列表：展示当前工具已添加的所有 API 供应商/模型分组 |
| 右侧区域 | 配置详情：选中供应商后，可修改接口地址、密钥、默认模型等参数 |
| 顶部导航 | 包含用量统计、本地代理、设置、云同步等进阶功能 |
四、添加多模型供应商配置
以下分别讲解三类主流模型的配置方法，配置完成后即可自由切换。
4.1 配置 Claude 系列模型
适配 Claude Code 工具，对应 KeJiKe Anthropic 兼容接口，支持所有 Claude 3/3.5 系列模型，含缓存读取计费。
- 左侧工具列表选中「Claude Code」
- 中间供应商区域点击 + 添加供应商，选择「自定义供应商」
- 按如下表格填写配置参数
- 点击「保存」完成添加，点击供应商卡片上的「启用」按钮设为当前生效后端
| 参数项 | 填写内容 | 详细说明 |
|---|---|---|
| 供应商名称 | KeJiKe-Claude-Kiro分组 |
自定义名称，建议标注分组类型，便于快速识别 |
| API 格式 | Anthropic |
必须选择 Anthropic 官方协议格式 |
| Base URL | https://sub.kejike.top |
根地址，无需追加 /v1，工具会自动拼接接口路径 |
| API Key | KeJiKe 生成的 Claude 分组密钥 | sk- 开头的完整字符串，注意无多余空格 |
| 默认模型 | claude-3-5-sonnet-20241022 |
可选，指定终端默认调用的模型 |
4.2 配置 GPT / Codex 系列模型
适配 Codex CLI、OpenCode 等工具，对应 KeJiKe OpenAI 兼容接口，支持 GPT-4o、GPT-4 等所有 OpenAI 格式模型。
- 左侧工具列表选中「Codex CLI」（或对应工具）
- 中间供应商区域点击 + 添加供应商，选择「自定义供应商」
- 按如下表格填写配置参数
- 点击「保存」并点击「启用」完成配置
| 参数项 | 填写内容 | 详细说明 |
|---|---|---|
| 供应商名称 | KeJiKe-GPT-标准分组 |
自定义名称，标注分组与模型类型 |
| API 格式 | OpenAI |
选择 OpenAI 兼容协议格式 |
| Base URL | https://sub.kejike.top/v1 |
必须带 /v1 后缀 |
| API Key | KeJiKe 生成的 GPT 分组密钥 | 对应分组的 sk- 密钥 |
| 默认模型 | gpt-4o-2024-08-06 |
可选，设置默认调用模型 |
4.3 配置 Gemini 系列模型
- 左侧工具列表选中「Gemini CLI」
- 添加自定义供应商，API 格式选择「Google Gemini」
- Base URL 填写 KeJiKe 对应兼容地址，API Key 填入 Gemini 分组密钥
- 保存并启用即可
⚡ 快捷方式：一键导入配置
KeJiKe 控制台已内置 CC Switch 一键导入能力，无需手动填参数：
- 登录 KeJiKe 控制台，进入「令牌管理」页面
- 找到对应令牌，点击右侧 CC Switch 一键导入 按钮
- 浏览器弹出应用唤起提示，选择「打开 CC Switch」
- CC Switch 自动填充所有配置参数，点击「确认添加」即可
- 点击「启用」，配置立即生效
五、切换 AI 模型的三种方式
配置完成后，可通过三种方式快速切换不同模型、不同分组，满足不同场景需求。
5.1 系统托盘一键切换（日常最高频）
适合开发过程中快速切换，无需打开主界面。
- 找到系统托盘的 CC Switch 图标（Windows 右下角、macOS 右上角菜单栏）
- 右键点击图标，展开工具列表
- 鼠标悬停到目标工具（如 Claude Code），展开供应商列表
- 点击想要切换的模型分组即可立即生效
5.2 主界面精准切换
适合需要同时查看配置、修改参数时使用。
- 打开 CC Switch 主界面
- 左侧选中要切换的目标工具
- 在中间供应商列表中，点击目标供应商卡片上的「启用」按钮
- 按钮变为「已启用」状态，即切换成功
5.3 多工具独立切换
CC Switch 支持不同工具使用完全独立的后端模型，互不干扰：Claude Code 可以使用高价分组保障效果，Codex CLI 可以使用低价分组处理简单脚本，适合多工具并行开发场景。
六、进阶使用技巧
6.1 故障自动转移（高可用配置）
配合 KeJiKe 多分组特性，实现主备线路自动切换，保障调用不中断。
- 在同一工具下，添加至少 2 个不同分组的 KeJiKe 供应商（主线路 + 备用线路）
- 点击顶部「本地代理」，开启「自动故障转移」
- 拖拽调整供应商优先级（主线路排在最上方）
- 设置触发条件：如连续 2 次报错、响应超时 5 秒自动切换
6.2 分组倍率智能切换（成本优化）
结合 KeJiKe 的分组倍率定价体系，按需切换，平衡成本与效果：
- 日常编写简单代码、注释、格式化：切换到低价 Kiro 分组，大幅降低成本
- 复杂项目重构、深度调试、架构设计：切换到官方高速分组，保障输出质量
- 操作方式：将不同倍率的分组分别添加为独立供应商，通过托盘一键切换
6.3 用量与成本统计
左侧导航栏进入「用量统计」，可按工具、供应商、时间维度查看 Token 消耗明细，结合 KeJiKe 控制台消费记录对账。
6.4 多设备配置同步
进入「设置」→「云同步」，支持 iCloud、OneDrive、WebDAV 等方式，多设备配置自动同步，无需重复配置。
七、常见问题与排障
Q1：切换模型后，终端调用还是旧模型？
终端 AI 工具会缓存会话上下文，已开启的对话会沿用会话建立时的模型。解决方法：新开一个终端窗口，或重启对应 CLI 工具，再发起新对话验证。
Q2：调用报错 401 Unauthorized
可能原因：API Key 复制不完整存在空格、令牌已过期/额度用尽、分组不支持当前模型。
解决：核对密钥完整性，登录 KeJiKe 控制台查看令牌状态与分组权限。
Q3：调用报错 404 Model Not Found
可能原因：默认模型名称填写错误，与 KeJiKe 支持列表不一致；当前分组未开通该模型权限。
解决：核对 KeJiKe 模型列表，修正模型名称，或切换到支持该模型的分组。
Q4：连接超时 / 接口不通
核对 Base URL 格式（Anthropic 不带 /v1，OpenAI 带 /v1），检查本地网络连通性，重启 CC Switch 客户端。
Q5：一键导入功能无响应
确保已提前安装并启动 CC Switch 客户端；部分浏览器需手动允许网站唤起本地应用；备选方案：手动复制导入链接，在 CC Switch「导入配置」页面粘贴导入。
八、安全与最佳实践
- 1. 密钥安全：API Key 是消费凭证，请勿分享给他人、勿上传至公开代码仓库、勿在明文配置中泄露
- 2. 定期轮换：建议定期在 KeJiKe 控制台吊销旧密钥，生成新密钥，降低泄露风险
- 3. 额度限制：给每个令牌设置合理的额度上限，避免异常调用产生超额费用
- 4. 版本更新：保持 CC Switch 为最新版本，获取最新功能、兼容修复与安全补丁
- 5. 分组适配：根据使用场景选择对应分组，日常开发用低价分组，高要求场景用高速分组，平衡成本与体验