Appearance
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. 下载并安装
选择你的电脑系统。优先用官方下载;官方打不开时再用网盘备用。
CCSwitch 官方下载选择 .msi 安装包,安装后会自动注册 ccswitch:// 协议
下载Windows 备用网盘官方下载慢或打不开时使用
下载不推荐 Portable.zip 便携版:它可能没有注册 ccswitch:// 协议,导入到 CCS 时会提示「未安装」。
CCSwitch 官方下载选择 .dmg 安装包,拖入「应用程序」后打开一次
下载macOS 备用网盘官方下载慢或打不开时使用
下载第一次打开如果提示「无法验证开发者」,到 系统设置 → 隐私与安全性 里点 仍要打开。
GitHub Releases按发行版和架构选择安装包,需要能访问 GitHub
下载下载页长什么样 / 视频说明


装好后先打开一次 CCSwitch,让系统记住 ccswitch:// 协议,再进行下一步。
2. 一键导入
导入到 CCS 依赖浏览器识别 ccswitch:// 协议,建议用 Google Chrome:
- 用 Chrome 打开 API 密钥。
- 找到要用的 Key,点击操作栏里的 导入到 CCS。
- Chrome 弹出「是否打开 CC Switch」时,选择 打开。

正常情况下 CCSwitch 会被拉起,并自动新增一条配置,地址是 https://www.dcbot.online。配置名就是站点名,一般显示为 爱鹿 Plan。
3. 启用并确认「使用中」
最容易漏的一步
导入成功不等于已经生效。 CCSwitch 可以同时保存很多配置,真正生效的只有显示 使用中 的那一条。
- 在 CCSwitch 列表里找到 爱鹿 Plan。
- 如果显示 启用,点击它,直到状态变成 使用中。

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-... |
保存后回到列表点击 启用,直到显示 使用中。