Skip to content

快速开始

1. 请求地址(区分 OpenAI 与 Claude)

服务根地址统一是 https://superapi.buzz,但不同格式补的路径不一样,别填混:

接口格式Base URL用于哪些客户端
OpenAI 兼容https://superapi.buzz/v1Codex CLI、Cherry Studio、Trae / Cursor / RooCode 等 OpenAI Compatible 客户端
Claude / Anthropichttps://superapi.buzz不带 /v1Claude Code(填到 ANTHROPIC_BASE_URL

不要把两种地址填混

OpenAI 格式要带 /v1;Claude / Anthropic 格式只填根地址 https://superapi.buzz不要/v1,否则会 404。

2. 选择分组(重要)

不同模型走不同分组。别用默认分组硬跑,选错分组容易 503 或模型不兼容。在创建 / 编辑令牌时按你要用的模型选对应分组:

选择正确的分组,而不是默认

你要用选哪个分组
GPT / Codexcodex- 开头的分组(codex-pluscodex-procodex-pro-advancedcodex-team),或 auto
Claude(默认推荐)default,kiro逆向
Claude(更强)反重力max-2max-4
Geminigemini-gcp(GCP 正规渠道)、gemini-逆向
DeepSeekdeepseek
Sora(视频)sora2
Windsurfwindsurf(比较差的claude逆向)

几个常用分组的含义:

  • default = kiro:默认分组,Claude 系上游,缓存率约 97%、1h 缓存,日常直接用即可。
  • 反重力:逆向 Claude,通常比 kiro 更聪明;想要更强表现时切它。
  • max-2 / max-4:Claude Max,极端情况下的逆向兜底。
  • auto:给 Codex 用的,自动挑当前可用、价格最低的 codex 分组;拿不准就选它。
  • deepseek / sora2:按次计费(DeepSeek 对话 / Sora 视频)。
  • 想用gpt要自己选分组,否则会打到default的claude分组上,就用不了。

3. 选择客户端

常用客户端的填写规则:

客户端Base URLToken 填写位置
Codex CLIhttps://superapi.buzz/v1OpenAI API Key(OPENAI_API_KEY 环境变量 或 codex login --api-key,二选一,见 Codex 配置
Claude CodeANTHROPIC_BASE_URL=https://superapi.buzzANTHROPIC_AUTH_TOKEN
CC Switch见下方「导出到 CC Switch」同左
Cherry StudioOpenAI 兼容提供商 Base URL https://superapi.buzz/v1API Key
Trae / Cursor / RooCodehttps://superapi.buzz/v1OpenAI Compatible 的 API Key

对应细节见 Claude Code 配置Codex CLI 配置

4. 安装常用 CLI

按需分开安装,只装你要用的那个:

bash
# Claude Code
npm install -g @anthropic-ai/claude-code@latest

# Codex CLI
npm install -g @openai/codex@latest

# Gemini CLI
npm install -g @google/gemini-cli@latest

安装后检查版本:

bash
claude --version
codex --version
gemini --version

5. 导出到 CC Switch

CC Switch 是本地的客户端配置切换工具,先下载安装:https://ccswitch.io

在控制台的令牌行点 「导出到CCS」,会拉起 CC Switch 并把这套配置导入进去:

导出 API Key 配置到 CC Switch

应用后要重启客户端

在 CC Switch 里应用 / 切换到该配置后,需要重启对应客户端(如 Claude Code)才会生效。

6. 出错先看这三项

  • 401:令牌错误、令牌被删、或复制时多了空格。
  • 404:Base URL 填错——OpenAI 格式漏了 /v1,或 Claude 格式多填了 /v1 / 多余路径。
  • 503:当前分组 / 模型 / 上游账号暂时不可用,也可能是选错分组导致模型不兼容;先换一个对应模型的可用分组(见上方「选择分组」)或同系列模型再试。

SuperAPI 文档仅用于帮助用户正确配置客户端。