CC-Switch核心逻辑： 先添加多家服务商/模型配置 → 一键启用切换 → 重启对应AI工具生效，支持Claude Code、Codex、Gemini CLI三类编程AI工具。

一、前置准备

1. 安装CC-Switch（GitHub Release下载对应系统包）

2. 提前备好各平台API Key：DeepSeek、Kimi、智谱GLM、Anthropic官方、中转代理密钥

3. 本地安装好要使用的AI CLI工具（claude / codex / gemini）

二、第一步：添加多套模型/服务商配置（必须先完成）

1. 打开CC-Switch，左侧选择你要适配的工具（Claude / Codex / Gemini）
2. 右上角点击 + 添加供应商
3. 两种添加方式：

方式1：内置预设（推荐新手）

列表自带50+厂商：Claude Official、DeepSeek、Kimi Coding、智谱GLM、千问、OpenRouter等

• 选中对应厂商，仅需填入API Key，接口地址、协议自动填充
• 下拉选择要使用的模型ID（如deepseek-v3、claude-3.5-sonnet）

方式2：自定义配置（中转/私有API）

选择「自定义配置」，手动填写4项核心参数：

• 名称：自定义备注（如“DeepSeek本地中转”）
• Base URL：服务商接口根地址（不要带/v1后缀）
• API Key：密钥
• 模型：指定调用模型名称

4. 点击保存，该套模型配置存入列表；重复操作添加DeepSeek、Kimi、Claude官方等多套配置。

三、第二步：一键切换AI模型（核心操作）

方法1：主界面可视化切换（最常用）

1. 返回对应工具的配置列表页，所有已添加模型全部展示
2. 找到想要切换的服务商/模型，点击右侧 启用（Enable）
3. 列表中该条目变绿色「当前使用」，CC-Switch自动重写AI工具本地配置文件（.claude/.codex）

方法2：托盘快捷切换（无需打开主窗口）

1. CC-Switch最小化后驻留系统托盘（Windows右下角/mac顶部栏）
2. 右键托盘图标，直接弹出所有服务商列表
3. 点击目标模型一键切换，后台自动更新配置

四、第三步：生效验证

切换完成后必须关闭终端/VS Code，重新打开，AI工具才会读取新模型配置：

1. 终端执行命令校验

# Claude Code
claude status
# Codex
codex /status

2. 输出内容会显示当前生效的API地址、模型名称，确认切换成功。

五、单服务商内切换不同子模型（无需新增配置）

同一厂商多模型（如Claude 3 Haiku/Sonnet/Opus）不用新建Provider：

1. 在列表点击该服务商右侧「编辑」
2. 修改「模型ID」下拉框，更换子模型
3. 保存后自动覆盖，重启工具即可切换同平台不同模型。