跳到主要内容

CC Switch

CC Switch 可一键选择 Claude、Codex 或 Gemini 配置，并使用对应服务地址。

配置前先确认​

  • 本页只写占位符；实际 Key 从 PopGo API 密钥页复制，模型从模型与价格页复制。
  • 一键配置适合已安装并注册协议的软件；浏览器提示打开外部应用时，需要允许一次。
  • 手动配置时先保存一个最小 Provider，首个请求成功后再启用流式、工具调用或多模型路由。

官方来源与核验​

本页于 2026-07-15 根据官方来源核验 CC Switch v3.17.0。 官方来源. 本页核验三种一键目标及其地址层级。

一键配置​

登录 PopGo API 密钥页，在目标 Key 所在行打开操作菜单。公开文档不会生成或展示任何带 Key 的跳转链接。 选择 CC Switch，再按目标选择 Claude、Codex 或 Gemini。 进入 CC Switch 后，再按目标选择 Claude、Codex 或 Gemini，并确认地址层级。

手动配置​

手动核对 CC Switch 中每个目标的 Endpoint，Key 与模型只使用占位符对应的实际值。

字段Endpoint
Claudehttps://api.popgo.site
Codexhttps://api.popgo.site/v1
Geminihttps://api.popgo.site
  • Claude 目标使用根地址，Codex 目标使用 /v1 地址；不要把两个地址混在同一目标里。
  • 如果导入后字段为空，先确认 Key 行菜单选择的是对应目标，再按表格手动补齐。

一键导入后的检查清单​

  1. 从 PopGo API 密钥页打开目标 Key 的操作菜单。
  2. 选择 CC Switch，再选择你要配置的目标：Claude、Codex 或 Gemini。
  3. 浏览器提示打开外部应用时选择允许。没有提示时，先确认本机已经安装并启动过 CC Switch。
  4. 导入完成后进入 CC Switch，确认目标配置里 Endpoint 与上表一致。
  5. 只替换 Key 和模型，不要把 Claude 的根地址填到 Codex 目标，也不要把 Codex 的 /v1 地址填到 Claude 目标。
  6. 保存后切换到目标配置，再从对应 CLI 或客户端新建会话测试。

什么时候改用手动配置​

  • 浏览器拦截外部应用，允许后仍无法唤起。
  • CC Switch 已安装但协议未注册，启动一次仍无法导入。
  • 导入成功但字段为空，或 Endpoint 被客户端改写。
  • 你要配置的软件没有出现在一键目标里。

成功判断​

保存并切换到目标配置后，在对应工具中新建会话；首个请求成功即完成核验。

常见错误和恢复​

  • 未安装：先从官方来源安装 v3.17.0，再回到 Key 行操作菜单重试。
  • 浏览器拦截：允许当前站点打开外部应用，然后重新执行一键配置。
  • 协议未注册：启动一次 CC Switch 完成系统协议注册，再回到浏览器重试。
  • 导入失败：确认选择了正确目标；仍失败时按下表手动核对 Endpoint。
  • 出现 401 时，重新粘贴 YOUR_API_KEY 并检查是否带有首尾空格。
  • 出现 404 时，核对 Base URL 层级，避免客户端重复追加 /v1。