CC-Switch深度配置手册：bblabu一键导入+多工具接入+故障转移完整指南

CC-Switch是AI编程工具的统一控制台。配上bblabu的一键导入，从安装到全工具接入只需10分钟。本文从安装、配置、一键导入、多工具接入到故障转移，做一次从头到尾的详尽记录。

一、CC-Switch是什么？为什么需要它？

CC-Switch是一个跨平台的桌面应用，核心功能就一个：在本地运行一个HTTP代理（默认127.0.0.1:7890），所有AI编程工具把API请求发给它，它负责路由到对应的模型供应商。

为什么需要这个中间层？三个原因：

1. 统一入口：Codex、Claude Code、Cursor、Windsurf——每个工具只需要把API地址指向127.0.0.1:7890，不需要分别配置Base URL和Key。

2. 动态切换：在CC-Switch界面中切换模型或供应商，所有接入的工具同步生效，零等待。

3. 供应商管理：你可以同时配置多个API供应商（bblabu、官方、其他中转站），根据不同场景灵活切换。

可以把CC-Switch理解成一个「AI API路由器」：你家里所有设备（工具）都连到这个路由器，路由器负责选择走哪条宽带（供应商）、用哪个DNS（模型）。

二、安装CC-Switch

macOS

# 从GitHub Releases下载最新版.dmg
# https://github.com/farion1231/cc-switch/releases
# 下载后双击安装到/Applications

# 或通过Homebrew（如已上架）
brew install --cask cc-switch

Windows

# 从GitHub Releases下载.exe安装包
# https://github.com/farion1231/cc-switch/releases
# 双击运行安装程序

验证安装

# 启动CC-Switch后，在终端验证
curl http://127.0.0.1:7890/health
# 返回 {"status":"ok"} 表示正常运行

三、bblabu一键导入配置

这是bblabu最方便的功能。不需要手动填API地址、协议类型、模型列表、Key——一个链接全搞定。

操作步骤

1. 登录bblabu控制台（api.bblabu.cn/console）

2. 进入「令牌管理」，创建或选择一个API令牌

3. 点击「CC-Switch配置」→「生成导入链接」

4. 复制生成的ccswitch://import?...链接

5. 在浏览器地址栏粘贴并回车

6. CC-Switch自动弹出导入确认窗口，点击确认

导入完成后，CC-Switch中会自动出现两个供应商：

• bblabu-主线：API地址api.bblabu.cn，模型gpt-5.5和claude-4.7

• bblabu-加速：API地址api.kkkliao.cn，同样模型

如果一键导入不生效

手动在CC-Switch中添加供应商：

供应商名称：bblabu
协议类型：OpenAI Compatible
API Base URL：https://api.kkkliao.cn（或https://api.bblabu.cn）
API Key：sk-your-bblabu-token
可用模型：gpt-5.5, claude-4.7

四、多工具接入配置

Codex配置

# ~/.codex/config.toml
[api]
base_url = "http://127.0.0.1:7890/v1"
# Key留空，CC-Switch统一管理

Claude Code配置

# ~/.zshrc
export ANTHROPIC_BASE_URL="http://127.0.0.1:7890"
# 不需要设置ANTHROPIC_API_KEY

Cursor配置

Settings → Models → Add custom model → API Base URL填http://127.0.0.1:7890/v1

Windsurf配置

Settings → AI → Custom Provider → URL填http://127.0.0.1:7890/v1

OpenClaw / Hermes配置

provider: openai-compatible
base_url: http://127.0.0.1:7890/v1
model: gpt-5.5

Python SDK / 自建应用

from openai import OpenAI
client = OpenAI(
    base_url="http://127.0.0.1:7890/v1"
)

所有工具配置完成后，在CC-Switch中切换供应商，所有工具同步生效。

五、高级功能：故障转移与双线路策略

CC-Switch支持供应商级别的故障转移配置：

主供应商：bblabu-加速（api.kkkliao.cn）  ← 日常优先，低延迟
备用供应商：bblabu-主线（api.bblabu.cn） ← 自动故障转移，高稳定

当主供应商不可用时（超时、返回5xx错误），CC-Switch自动将请求路由到备用供应商。对上层工具完全透明，你的Codex和Claude Code继续正常工作。

配置方法：CC-Switch → 供应商设置 → 故障转移 → 添加备用节点。

六、多供应商切换策略

CC-Switch的价值在于你可以在不同供应商之间一键切换：

七、与其他代理工具共存

如果你同时使用ClashX、V2Ray等网络代理工具，CC-Switch与它们完美共存：

• CC-Switch：处理AI API流量（本地→bblabu），默认7890端口

• ClashX/V2Ray：处理其他网络流量（浏览器、终端等），默认7890/7891端口

如果端口冲突，在CC-Switch设置中更换端口即可。两者的流量路径完全不同，互不干扰。

八、性能数据

CC-Switch作为本地代理，性能开销极小：

• 额外延迟：

  <1ms（本地回环）<>

• 内存占用：50-100MB

• CPU占用：

  <1%（空闲），<5%（高并发）<>

实际体验中，走CC-Switch和不走CC-Switch的响应时间差异小于1ms，完全无感。

九、常见问题排查

Codex报Connection Refused

检查CC-Switch是否在运行：curl http://127.0.0.1:7890/health

API返回401

检查bblabu控制台中令牌余额是否充足。额度不足时API返回401。

CC-Switch导入后模型列表为空

重新生成导入链接并导入。或在CC-Switch中手动添加模型名。

切换供应商后工具没变化

在CC-Switch中确认切换已生效（查看当前活跃供应商），然后重新发送请求。

十、总结

CC-Switch + bblabu是AI开发者的黄金工具组合。搭建一次，长期受益。所有AI工具指向127.0.0.1:7890，所有模型管理交给CC-Switch，所有API费用走bblabu一个钱包。

从安装到全工具接入，10分钟。之后的每一天，省下的配置时间和管理精力，远比这10分钟值。

👉 bblabu：https://api.bblabu.cn

👉 CC-Switch：https://github.com/farion1231/cc-switch

👉 立即注册 bblabu  |       👉 查看充值套餐

本文链接：https://www.kkkliao.cn/?id=3926 转载需授权！