CC Switch 安装与渠道配置

CC Switch（GitHub Releases 下载）是一款专为 Claude Code、Claude Desktop 设计的高效模型与渠道管理工具，特别适合 Windows 平台用户一键配置和切换第三方反代。

💡 为什么必须以 OpenAI Chat Completions 格式配置？

很多初学者在 CC Switch 中误选了 Anthropic 原生协议，往往会遇到以下棘手问题：

Claude 官方频繁更新的试验性 Header（如 anthropic-beta）会导致第三方平台返回 400 格式错误；
流式输出卡顿、长代码段生成时中途截断；
思维链（Thinking Process）格式无法正常回传。

解决方案：
在 CC Switch 中添加渠道时，必须以 OpenAI 协议格式（OpenAI Chat Completions）为主。CC Switch 会在本地智能转换客户端请求，以业界最成熟稳定的 OpenAI 标准协议与 BBToken 通信，极大提升可用性与调用成功率。

⚡ 核心 4 步配置法

flowchart TD A[启动 CC-Switch 客户端] --> B[点击「添加自定义供应商」] B --> C["【核心】协议选择: OpenAI\nBase URL: https://bbtoken.boywe.cn/v1"] C --> D["粘贴 Key: sk-xxxx\n模型填: deepSeek-V4-flash"] D --> E[设为当前激活供应商，一键启动客户端开聊]

第 1 步：添加自定义供应商

启动 CC-Switch 客户端，点击 「添加自定义供应商」。
供应商名称可填写为：BBToken。
协议格式（核心项）：下拉菜单中选择 OpenAI（或 OpenAI Compatible / Chat Completions）。
Base URL：必须填入带 /v1 的完整端点地址：
text
```
https://bbtoken.boywe.cn/v1
```

第 2 步：填入 API Key

将从 BBToken 控制台 API 密钥页面复制的有效 sk-xxxxxxxxxxxxxxxxxxxxxxxx 粘贴进 Key 输入框，确保前后不包含多余空格或回车。

第 3 步：指定主力模型与映射

在模型配置栏中填入平台支持的高性能大模型标识：

text

deepSeek-V4-flash

(亦可填入别名 cctoken-deepseek-v4-flash、bbtoken-DeepSeek-V4-Flash，或填写低延迟的 bbqwen3.8-flash-next)

TIP

模型映射提示：
CC Switch 支持将官方模型名重定向。建议将 claude-3-5-sonnet、claude-3-7-sonnet、claude-3-opus 等别名统一映射为平台支持的 deepSeek-V4-flash，防止客户端发起非预期请求导致找不到模型。

### 第 4 步：激活并启动客户端 1. 保存该供应商配置，并在主界面点击设为 **当前激活供应商**。 2. 此时启动 Claude Desktop 或在终端中执行 Claude Code，发送一句「你好」。 3. 收到流式回复即代表协议桥接配置圆满成功！

🛠️ 本地守护进程与端口接管机制

CC Switch 支持在本地后台运行代理服务（默认端口通常为 http://127.0.0.1:8080）：

自动协议转换：客户端请求发往本地监听端口后，CC Switch 自动将其封装为标准的 OpenAI Chat Completions (/chat/completions) 格式发送给 BBToken；
环境变量导出：可在「环境变量管理」中一键将当前激活供应商导出并应用到系统环境变量中，方便随时在各种终端中启动命令行工具。