Skip to content

CCSwitch 接入(推荐) ​

CCSwitch 用来管理和切换 AI 客户端的接入配置。在 爱鹿 Plan 点一下 导入到 CCS,就能把地址和 Key 一次性配好,不用手动改配置文件。

一次导入配一类客户端

导入的是哪一类客户端,由这个 Key 的分组决定:OpenAI 分组的 Key 导入到 Codex,Anthropic / Claude 分组的 Key 导入到 Claude Code,Gemini 分组导入到 Gemini CLI。对应的 VS Code 插件和命令行共用同一份配置,所以也能直接用。

Codex 和 Claude Code 都要用的话,建两个不同分组的 Key,各导入一次。

这是最省事的接入方式,第一次使用建议走这条路。 其他客户端的教程都会引用本页的步骤。

  1. 下载安装
  2. 一键导入
  3. 启用到使用中
  4. 刷新用量
  5. 重启客户端

1. 下载并安装 ​

选择你的电脑系统。优先用官方下载;官方打不开时再用网盘备用。

CCSwitch 官方下载选择 .msi 安装包,安装后会自动注册 ccswitch:// 协议
下载
Windows 备用网盘官方下载慢或打不开时使用
下载

不推荐 Portable.zip 便携版:它可能没有注册 ccswitch:// 协议,导入到 CCS 时会提示「未安装」。

CCSwitch 官方下载选择 .dmg 安装包,拖入「应用程序」后打开一次
下载
macOS 备用网盘官方下载慢或打不开时使用
下载

第一次打开如果提示「无法验证开发者」,到 系统设置 → 隐私与安全性 里点 仍要打开。

GitHub Releases按发行版和架构选择安装包,需要能访问 GitHub
下载
下载页长什么样 / 视频说明

CCSwitch 下载入口

CCSwitch 视频说明

装好后先打开一次 CCSwitch,让系统记住 ccswitch:// 协议,再进行下一步。

2. 一键导入 ​

导入到 CCS 依赖浏览器识别 ccswitch:// 协议,建议用 Google Chrome:

  1. 用 Chrome 打开 API 密钥。
  2. 找到要用的 Key,点击操作栏里的 导入到 CCS。
  3. Chrome 弹出「是否打开 CC Switch」时,选择 打开。

API 密钥列表里的「导入到 CCS」按钮

正常情况下 CCSwitch 会被拉起,并自动新增一条配置,地址是 https://www.dcbot.online。配置名就是站点名,一般显示为 爱鹿 Plan。

3. 启用并确认「使用中」 ​

最容易漏的一步

导入成功不等于已经生效。 CCSwitch 可以同时保存很多配置,真正生效的只有显示 使用中 的那一条。

  1. 在 CCSwitch 列表里找到 爱鹿 Plan。
  2. 如果显示 启用,点击它,直到状态变成 使用中。

CCSwitch 确认配置正在使用

4. 刷新用量,验证连通 ​

点击 刷新用量。能看到余额或用量,说明 Key、地址和 CCSwitch 配置都正常。

刷新失败时依次检查:

  • 爱鹿 Plan 这条是不是 使用中。
  • Key 所在分组是否可用,见 模型与分组怎么选。
  • 账户余额或订阅是否有效。

5. 重启客户端 ​

为什么要重启

多数客户端(Codex、Claude Code、VS Code 插件)只在启动时读一次配置。在 CCSwitch 切换之后,已经打开的窗口还在用旧配置。

关闭已经打开的终端或 VS Code 窗口,再重新打开客户端,发一句测试消息:

text

text
用一句话回复:连接测试成功。

然后到站内 使用记录 看是否出现这次调用。有记录才说明真的走了 爱鹿 Plan。

一键导入失败时:手动添加 ​

一键导入始终不成功时,在 CCSwitch 里手动新增一条配置:

字段填写
名称爱鹿 Plan
地址https://www.dcbot.online
API Key站内创建的 sk-...

保存后回到列表点击 启用,直到显示 使用中。

下一步 ​