接入教程

用 CC Switch 一键导入桌面客户端配置

ROIBest AI

手动配置的问题不在于难,而在于容易抄错——多一个 /v1、少一个字符、把 Anthropic 分组的密钥填进 OpenAI 的配置项,每一种都会让你在 401 和 404 之间来回排查。

CC Switch 的导入功能把这段手抄流程去掉了。

它做了什么

在控制台的 API Keys 页面选中一个密钥,点击「导入到 CC Switch」,平台会按这个密钥所属的协议分组生成对应的配置:Anthropic 兼容分组生成 Anthropic 形态的配置,OpenAI 兼容分组生成 OpenAI 形态的。

也就是说,最容易出错的那两件事——分组和端点是否匹配、base URL 该不该带 /v1——都由平台按密钥的真实属性填好,不再靠你记。

怎么用

  1. 登录控制台,进入 API Keys 页面
  2. 选中要用的密钥(没有就先建一个,注意选对协议分组)
  3. 点击「导入到 CC Switch」
  4. 在 CC Switch 里确认导入

导入完成后直接在 CC Switch 里切换到这份配置即可使用。

关于密钥安全

导入链接是在你当前的浏览器里生成的,真实密钥不会出现在公开页面上。这意味着:

  • 你需要先登录才能看到这个入口——未登录状态下页面上没有任何密钥信息
  • 生成的链接包含凭据,不要转发给别人,也不要贴进聊天群或工单
  • 需要给同事配置时,正确做法是让他用自己的账号生成自己的密钥,而不是共享你的链接。这样用量和额度也能分开记

什么时候还是要手动配

导入功能覆盖的是 CC Switch 管理的桌面客户端。以下情况仍然需要手动填:

  • 在服务器或 CI 环境里跑,没有桌面客户端
  • 用 SDK 写代码调用
  • 客户端不在 CC Switch 的管理范围内

这些场景下的配置方式,见站内的 Claude Code、Codex 和 SDK 接入几篇。

配置完之后

不管用哪种方式配置,都建议做同一件事:跑一次请求,然后回控制台看用量明细里有没有这条记录。

有记录,说明请求确实走了 ROIBest AI。没有记录而客户端又工作正常,说明配置没生效、客户端还在用原来的凭据——这种情况从客户端那一侧是看不出来的。