Appearance
使用 CC Switch
适用对象:已安装 CC Switch,想用它管理 Claude Code、Codex、OpenCode 或 Pi Provider 的用户。预计耗时:5 分钟。
CC Switch 用来管理和切换编程助手的 Provider。连接AI主站的 导入到 CCS 与 复制导入命令 是两种由你自行选择的方式:前者交给 CC Switch 管理,后者由连接AI脚本写入本机配置。
第 1 步:安装 CC Switch
从 CC Switch 官方网站或 官方 GitHub 发布页安装适合当前系统的版本。先启动一次 CC Switch。当前连接AI链接会携带所选模型及 API 格式,建议使用支持这些参数的 CC Switch v4.0.10 或更新版本。
第 2 步:从连接AI导入
- 在 连接AI API 密钥列表找到目标 Key,点击 导入到 CCS。
- 选择 Claude Code、Codex、OpenCode 或 Pi。Claude Code 和 Codex 会使用当前 Key 的全部适用模型;OpenCode 和 Pi 的 CC Switch 导入链接目前只能写入一个模型,请在页面中明确选定一个。需要这两个工具的全部模型时,请改用快速导入命令或手动配置。
- 点击 导入到 CCS 卡片。浏览器会请求打开 CC Switch。
- 在 CC Switch 的导入确认窗口检查目标工具、
lianjieai.top地址、模型、API 格式和脱敏 Key,再按应用提示完成导入。 - 按 CC Switch 确认窗口的提示启用或切换到新 Provider,然后完全退出并重开目标工具。

这是已登录主站的真实完整视口。Claude Code 和 Codex 无需先选择模型;OpenCode 与 Pi 会显示单模型选择和限制说明。实际是否已导入,要看 CC Switch 的确认窗口,网页按钮本身不能证明成功。
链接含 Key
导入链接会携带你的 API Key。只在自己登录后的密钥页面点击,不要复制或转发完整 ccswitch:// 链接,也不要把它放进公开文档。
与快速导入脚本的区别
| 你选择的方式 | 配置由谁管理 | 怎样撤销 |
|---|---|---|
| 导入到 CCS | CC Switch | 在 CC Switch 中切换或移除 Provider |
| 复制导入命令 | 连接AI本机导入器 | 回到同一 Key 的快速导入页面复制清理命令 |
清理命令不会删除 CC Switch 中的 Provider。若你同时用过两种方式,先确认当前工具实际在用哪一套配置。
没有唤起 CC Switch
先确认已安装并启动应用,再回到密钥列表重新点击。仍无反应时,检查浏览器是否拦截外部应用链接;可按对应工具页面使用 快速导入命令或手动配置。CC Switch 对导入链接参数的解释和版本差异见 官方站点集成指南。
完成后在目标工具发送 测试消息,收到正常回复才算接入成功。
完成检查
CC Switch 已显示新 Provider;在目标工具里启用它、重启工具并收到模型回复。
