CC Switch 使用教程

准备好你的 API Key，按下面 5 步操作。

1. 下载并打开 CC Switch

打开 CC Switch 官网，下载适合你电脑的版本，安装后打开。

2. 选择应用，添加供应商

在左侧选择 Codex 或 Claude Code，点击上方的 直连，再点击右上角 ＋添加供应商。

CC Switch 的 Codex 供应商列表：左侧为折叠的应用栏，上方有直连选项和添加供应商按钮。
图示为 Codex。可点击左上角双箭头展开侧栏，查看应用名称；点击图片查看完整原图。

在预设选择页点击 自定义配置。

CC Switch 添加供应商页面中的自定义配置入口。
选择「自定义配置」。点击图片可放大。

3. 填写名称、Key 和地址

Codex

供应商名称tmallmodels
API Key粘贴你自己的完整 Key
API 请求地址https://tmallmodels.com/v1
备注、官网地址可以留空

高级选项保持默认，完整 URL 保持关闭。

CC Switch 的 Codex 自定义供应商表单：填写示例 Key 和 https://tmallmodels.com/v1，默认模型已清空，模型列表旁有获取模型列表按钮。
图中的 Key 仅作示例，请填写自己的 Key。点击图片可放大。

Claude Code

供应商名称tmallmodels
API Key粘贴你自己的完整 Key
请求地址https://tmallmodels.com
备注、官网地址可以留空

地址末尾不加 /v1。上游格式和认证字段保持默认，完整 URL 保持关闭。

CC Switch 的 Claude Code 自定义供应商表单：填写示例 Key 和 https://tmallmodels.com，高级选项中的协议保持默认。
图中的 Key 仅作示例，请填写自己的 Key。点击图片可放大。

4. 选择模型

Codex

  1. 先清空 默认模型 中的预填内容。
  2. 填写好 Key 和地址后，点击 获取模型列表。
  3. 获取成功后，在弹出的列表中勾选一个模型，点击 应用。

如果无法获取列表，向 Key 提供方索取可用的模型名称，准确填入 默认模型。

Claude Code

  1. 展开 高级选项，找到模型映射。
  2. 在 Sonnet 对应的 实际请求模型 中，填写 Key 提供方告知的模型名称。
  3. 点击 一键设置，将这个名称应用到各个模型角色。
  4. 在 默认兜底模型 中填写相同的模型名称。

图中的 your-model-id 是占位示例，不能照抄。未确认模型支持前，不要勾选 1M。

CC Switch 的 Claude Code 模型映射：实际请求模型和默认兜底模型均使用 your-model-id 占位，须替换为 Key 提供方给出的模型名称。
模型名称按 Key 提供方给出的内容填写。点击图片可放大。

5. 添加并切换

检查填写内容，点击底部 添加。回到列表，找到 tmallmodels，点击卡片右侧的 切换按钮（▶）。

卡片显示 使用中，表示已切换到这家供应商。如果按钮显示 回到直连并使用，点击它即可回到直连。

切换后，按 CC Switch 的提示重新打开所用应用，让配置生效。

以后更换 Key、地址或模型，点击这张卡片右侧的 铅笔图标，修改后点击 保存。