CC Switch
Last updated on
对中国用户来说，先用 CC Switch 把 Claude Code 的供应商切换链路配好，再继续安装和使用，通常更稳。
先说结论：这一页是干什么的？
如果你前一页已经准备好了 API Key 和本地依赖，这一页要解决的就是：
- 把
CC Switch装到电脑里 - 在里面给
Claude Code添加一个可用供应商 - 切换到这个供应商，让 Claude Code 后面能直接走可用链路
对中国用户来说，这一步不是可有可无的“附加技巧”，而是主路径的一部分。
先理解为什么这里要先过 CC Switch
CC Switch 是什么？
按它的官方说明，CC Switch 是一个桌面管理工具，可以统一管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 的供应商配置、切换和相关扩展能力。
如果你直接跳过这一步，后面安装好 Claude Code 之后，往往还会卡在这些问题上：
- API 供应商怎么切换
- 配置文件到底在哪
- Base URL 和 Key 应该怎么写
- 想切回别的供应商时要不要手改配置文件
CC Switch 的价值，就是把这些原本要你手动改配置文件的操作，改成一个更直观的桌面界面。
对这套教程的目标用户来说，它更像是一个“先把接入路径铺平”的步骤。
先把 CC Switch 装好
这一页讲的是桌面软件，不是终端命令工具
这一部分你不用先打开 CMD、PowerShell 或 Windows Terminal。
因为 CC Switch 本身是桌面应用，先下载安装并打开就可以。
2. 按你的系统下载对应安装包
根据官方说明，CC Switch 支持：
- Windows
- macOS
- Linux
如果你是 Windows 用户，优先看这两个文件：
CC-Switch-v版本号-Windows.msi：更适合大多数普通用户，双击安装即可CC-Switch-v版本号-Windows-Portable.zip：绿色版，适合不想走安装流程的人
如果你不知道该选哪个，直接选 .msi 安装包就行。
3. 安装并启动 CC Switch
下载完成后：
- 如果你下载的是
.msi，双击安装，按默认选项一路继续 - 如果你下载的是绿色版压缩包，先解压，再双击里面的程序启动
第一次打开后，你会看到它的主界面。
做到这一步，算安装成功
你已经可以正常打开 CC Switch 主界面，并看到供应商管理相关界面。
给 Claude Code 添加一个可用供应商
这一段的目标很简单
不是要你一次性研究完 CC Switch 的所有功能。
你现在只需要先完成一件事：给 Claude Code 配一个后面能用的供应商。
1. 先切到 Claude 相关应用视图
打开 CC Switch 后，先在界面里找到 Claude 或 Claude Code 对应的区域。
你后面要接的是 Claude Code，所以这里不要先跑去配 Codex、Gemini CLI、OpenCode 或 OpenClaw。
2. 点击添加供应商
按它官方手册的说法，最常见的入口是点击主界面右上角的 + 按钮，打开“添加供应商”面板。
面板里通常会有：
- 预设供应商
- 自定义配置
- 名称、端点、API Key 等字段
如果你只是想先把 Claude Code 跑通，优先用预设方式，不要一开始就选最复杂的自定义 JSON。
3. 选择一个适合你的供应商预设
CC Switch 官方文档里提到，Claude 侧支持很多预设供应商。
你在这一页不用执着于“哪一家最完美”，而是先选一个你自己已经准备好 Key、并且当前能正常使用的供应商。
因为你前一页已经准备了 api.dingjiai.com 的 API Key，所以这一步最自然的做法就是：
- 优先选择和你现有 Key 匹配的可用供应商预设
- 如果预设里没有完全匹配的项，再考虑自定义方式
这里先不要贪多
先配通一个供应商就够了。
不要一上来同时加很多家，否则你很容易在“到底当前启用的是哪个”这件事上绕晕。
4. 填入 API Key 并保存
如果你用的是预设，按官方手册，一般会自动帮你填好一部分信息。你主要需要检查或填写的是：
- 供应商名称
- 端点地址
- API Key
把你前一页准备好的 Key 填进去，然后点击 添加 或 保存。
做到这里，你就已经把一个 Claude Code 可用的供应商写进 CC Switch 里了。
切换到这个供应商并确认生效
2. 记住一个关键点：Claude Code 通常不用重启终端
CC Switch 的官方文档特别提到：
- 大多数工具切换供应商后，需要重启终端或重新打开 CLI
- Claude Code 是例外，它支持热切换，通常不需要重启
这也是为什么 CC Switch 对 Claude Code 用户会特别省事。
对当前这套教程来说，这就是最关键的收益
你不用手动改一堆配置文件，也不用每切一次都怀疑“到底生效没”。
3. 知道它大概改了什么，但你现在不用手改
官方文档里提到，切换 Claude 供应商时，CC Switch 会去更新 Claude 对应配置文件里的环境信息。
你现在只需要知道一件事：
- CC Switch 本质上是在帮你管理 Claude Code 的接入配置
- 但你当前不需要自己手动打开配置文件硬改
这正是它存在的意义。
这一步做完，什么状态算合格
满足下面这 3 条，就可以进入下一页了
- CC Switch 已经安装并能正常打开
- 你已经在 Claude/Claude Code 相关区域里添加了一个可用供应商
- 这个供应商已经被你切换成“当前启用”状态
做到这里，接入链路这一步就完成了。
下一页继续看 安装 Claude Code。