文档 / 接入指南

CC Switch 一键导入

CC Switch 是一个开源桌面工具,用来管理和切换 Claude Code、Codex、Gemini CLI 的服务商配置。装好之后,可以从控制台一键把 peroai 的配置导进去。

导入步骤

  1. 先安装最新版 CC Switch 并打开过一次。
  2. 打开「API 密钥」,在要导入的那把密钥右侧点「⋯」菜单,选「CC Switch」。
  3. 在弹窗里选择: - 应用:Claude、Codex 或 Gemini; - 名称:在 CC Switch 里显示的名字; - 主模型:必填。Claude 还可以分别指定 Haiku、Sonnet、Opus 三个别名对应的模型。
  4. 点「打开 CC Switch」,浏览器询问是否打开应用时选允许。
  5. 在 CC Switch 里检查配置,确认导入并切换到这个服务商。

导入时地址会自动填好:Claude 用 https://api.peroai.cc,Codex 用 https://api.peroai.cc/v1。

注意

  • 模型列表里是你账户能用的所有模型,不只是这把密钥所在分组的。 请只选这把密钥分组里的模型,否则调用会报「无可用渠道」。各分组的模型见模型广场。
  • 用 claude-ccmax 分组导入 Claude 时,Haiku 模型请选 claude-haiku-5-5,原因见分组说明。
  • 导入链接里包含完整密钥,不要把它发给别人。
  • 浏览器没有反应时,确认 CC Switch 已安装,并已允许浏览器打开 ccswitch:// 链接。

最后更新:2026-11-15。模型、价格和分组以控制台实时显示为准。