CC Switch Claude Code 配置教程
CC Switch 是一个管理 Claude Code 供应商的桌面应用，不用手改配置文件，点一下就能在官方登录和第三方 API 之间切换。这篇 CC Switch Claude Code 配置教程以 cdnd（Claude Code 中转站） 为例，讲怎么安装 CC Switch、把 cdnd 添加为供应商、切换后怎么验证，以及哪些功能和 cdnd 不兼容。
CC Switch 是什么：Claude Code 供应商切换工具
CC Switch 是基于 Tauri 2 的开源桌面应用（MIT 协议），支持 Windows、macOS 和 Linux。它能管理 Claude Code、Codex、Gemini CLI 等多个工具的供应商，另外还能管理 MCP、Skills 和提示词。
对 Claude Code 来说，它做的事很简单：切换供应商时，把请求地址和 Key 写进 ~/.claude/settings.json 的 env，其他设置（插件、Hook、权限、MCP、你自己加的变量）原样保留。这和 Claude Code 第三方 API 配置教程 里手动改 settings.json 的效果一样，只是换成了点按钮。
所以 CC Switch 能配合 cdnd 使用：请求仍然是 Claude Code 自己发给 cdnd 的，CC Switch 只负责改配置。前提是使用默认的直连模式，原因见注意事项。
安装 CC Switch
先装好 Claude Code 本身，还没装的看 Claude Code 安装教程。CC Switch 只是改配置的工具，不包含 Claude Code。
| 系统 | 安装方式 |
|---|---|
| macOS | brew install --cask cc-switch，或从 Releases 下载 .dmg |
| Windows | 从 Releases 下载 .msi 安装包或 Portable.zip 绿色版 |
| Arch Linux | paru -S cc-switch-bin |
| 其他 Linux | 从 Releases 下载 .deb、.rpm 或 .AppImage |
Releases 页面在官方仓库的 releases。系统要求：Windows 10 及以上、macOS 12 及以上；Linux 需要 glibc 2.35+ 和 WebKitGTK 4.1（例如 Ubuntu 22.04+、Debian 12+）。
macOS 用 Homebrew 安装：
brew install --cask cc-switch
第一次启动时，CC Switch 会把 Claude Code 现有的配置导入为一个叫 default 的供应商，并自动添加官方供应商 Claude Official，原来的配置不会丢。
在 CC Switch 里添加 cdnd 供应商
准备 cdnd 的 API Key
在 cdnd 控制台 注册后创建一个 API Key，以 sk-cdnd- 开头。建议给 CC Switch 单独建一个 Key，方便在控制台看用量，也可以给它设每月花费上限。cdnd 按 Anthropic 官方价格按量计费，没有月费，价格见 Claude Code 价格。
添加步骤
- 打开 CC Switch，在左侧栏选中 Claude Code，点页面右上角的 +（添加供应商）。
- 在预设列表里选 自定义配置。
- 按下表填写：
| 字段 | 填写 |
|---|---|
| 供应商名称 | cdnd（随意，方便自己认） |
| 官网地址 | 可选，填 https://gateway.cdnd.sh，卡片上可以直接打开控制台 |
| 请求地址 | https://api.cdnd.sh |
| API Key | 你的 cdnd Key，sk-cdnd- 开头 |
| 认证字段 | 保持默认的 ANTHROPIC_AUTH_TOKEN |
| 上游格式（高级选项） | 保持默认的 Anthropic Messages（原生） |
| 主模型、各档默认模型 | 留空，使用 Claude Code 自己的默认模型 |
- 看一眼表单下方的配置编辑框。它显示的是切换后 settings.json 的样子，
env里应该有这两项：
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.cdnd.sh",
"ANTHROPIC_AUTH_TOKEN": "sk-cdnd-你的Key"
}
}
如果编辑框里显示的是 ANTHROPIC_API_KEY 而不是 ANTHROPIC_AUTH_TOKEN，也能用，cdnd 两种都认。
- 点页脚的 添加。
请求地址末尾不要加 /v1，也不要以斜杠结尾。Claude Code 会自己拼上 /v1/messages。
「获取模型列表」和模型字段
表单里的「获取模型列表」按钮会由 CC Switch 自己去请求 /v1/models。cdnd 会校验 Key 并返回 cdnd 的模型列表，这个按钮可以正常使用。不过还是建议模型字段留空，进了 Claude Code 再用 /model 切换。
供应商卡片上的「检测连通」只检查地址能不能连上，不发真实请求，通过了也不代表 Key 正确。真正的验证方法见下一节。
在 CC Switch 里切换 Claude Code 并验证
一键切换
在 Claude Code 页面顶部确认处于「直连」标签，点 cdnd 卡片上的 切换，按钮变成「使用中」就切好了。也可以右键系统托盘图标，在 Claude Code 子菜单里点 cdnd。
按 CC Switch 的说明，Claude Code 支持热切换，不用重启。如果正在运行的会话还在用旧配置，退出后重新运行 claude。
用 /status 验证
- 在终端运行
claude，输入/status。 Anthropic base URL一行显示https://api.cdnd.sh，Auth token一行写着ANTHROPIC_AUTH_TOKEN，说明配置已经生效。- 关掉
/status，随便发一句话。能正常回复就接通了，这次请求也会出现在 cdnd 控制台的用量里。
常用命令和计划模式等用法见 Claude Code 使用教程。
切回官方登录
- 在 CC Switch 里切换到 Claude Official。
- 在 Claude Code 里运行
/login，按官方流程登录 Claude 账号。
之后就可以在 Claude Official 和 cdnd 之间随时来回切换。如果不小心删掉了 Claude Official，在添加供应商的「账号登录」分类里选 Claude 官方预设，重新添加即可。
CC Switch 总会保留一个正在使用的供应商，不能删除。想删掉 cdnd，先切到别的供应商。
注意事项：用 cdnd 时保持直连
cdnd 只转发 Claude Code 自己发出的请求，其他客户端或者改写过的请求会返回 403 cdnd serves Claude Code only。对照 CC Switch 的几种模式：
- 直连（默认）：CC Switch 只改 settings.json，请求由 Claude Code 直接发到 cdnd，可以正常使用。
- 路由（开始路由）：Claude Code 的请求先发到 CC Switch 的本地路由（默认
127.0.0.1:15721），再由它转发，配置文件里只剩本地地址和占位密钥PROXY_MANAGED。转发时可能做模型名映射、格式转换和请求修正，cdnd 无法保证收到的还是 Claude Code 的原始请求。不要对 cdnd 开启路由，也不要把它放进故障转移队列。 - 聚合：同样经过本地路由，不要把 cdnd 加进聚合列表。
- 完整 URL 开关：只能配合路由使用，用 cdnd 时保持关闭。
另外几点：
- 只在 Claude Code 页面添加 cdnd。 不要把 cdnd 加到 Codex、Gemini CLI、OpenCode、Claude Desktop 等其他工具，也不要用「统一供应商」同步过去，它们发出的请求都不是 Claude Code 的，会被拒绝。
- 环境变量冲突：如果你之前在
~/.zshrc或 Windows 环境变量里设过ANTHROPIC_开头的变量，CC Switch 顶部会出现冲突警告。settings.json 里的值优先，不会影响切换，但建议清掉旧变量，免得以后排查时混淆。 - VS Code 插件：插件有自己的登录检查，配置方法见 Claude Code VS Code 插件配置。
想在飞书、钉钉、Telegram 里远程使用 Claude Code，可以再配一个 cc-connect，它启动的也是本机的 Claude Code。
常见问题
CC Switch 能配合 Claude Code 中转站使用吗？
可以。CC Switch 在直连模式下只是把请求地址和 Key 写进 ~/.claude/settings.json 的 env，请求仍由 Claude Code 自己发出。用 cdnd 时请求地址填 https://api.cdnd.sh，API Key 填 sk-cdnd- 开头的 Key，认证字段保持默认的 ANTHROPIC_AUTH_TOKEN。
CC Switch 切换供应商后要重启 Claude Code 吗？
一般不用。CC Switch 的说明是 Claude Code 支持热切换。如果切换后 /status 里显示的还是旧地址，退出 Claude Code 重新运行一次即可。
用 cdnd 时为什么不能开 CC Switch 的路由模式？
路由模式下请求先经过 CC Switch 的本地路由再转发，可能被修改模型名、转换格式或修正内容。cdnd 只接受 Claude Code 原样发出的请求，经过改写的请求可能返回 403。保持直连模式就没有这个问题。
添加 cdnd 后报 403 cdnd serves Claude Code only 怎么办？
说明请求不是 Claude Code 直接发出的。检查两处：Claude Code 页面是不是处于直连而不是路由或聚合；cdnd 是不是被加到了 Codex、Gemini CLI 等其他工具。
CC Switch 会改掉我原来的 settings.json 吗？
只改关键字段。切换时 CC Switch 只替换请求地址、Key、模型等连接信息，插件、Hook、权限、MCP 和你自己加的设置都保留。它第一次改写配置文件前，还会把原文件备份到 ~/.cc-switch/backups/live-first-write/。
服务器上没有桌面环境，能用 CC Switch 吗？
CC Switch 本身只有图形界面的桌面版。官方 README 推荐在服务器、SSH 远程环境用社区维护的 CC Switch CLI，也可以不装任何工具，直接按第三方 API 配置教程把两个变量写进 ~/.claude/settings.json。
通过 CC Switch 使用 cdnd 怎么收费？
和直接配置一样：按 Anthropic 官方美元价格计费，充值 ¥2 = $1，¥100 起充，没有月费，每个 Key 可以设每月花费上限。CC Switch 本身是免费开源软件，不经手计费。