快速开始

新人入口注册 / 登录 / IP 加白创建 API 令牌

Base URLhttps://superapi.buzz

1. 准备两项

使用任何客户端前，都需要先准备：

• API Key / Token：在控制台创建。
• Base URL：默认使用 https://superapi.buzz。
• 可用客户端：Codex CLI、Claude Code、CC Switch、Cherry Studio 等。

新用户先走加白入口

注册、登录、IP 加白不要直接从官网入口开始。请先打开 https://cf-ip-whitelist-worker.pages.dev/，完成注册 / 登录 / 加白三步；否则请求接口时大概率会被 Cloudflare 拦截。

不要混用地址

配置里只填根地址 https://superapi.buzz。如果客户端单独要求 OpenAI 地址，再按客户端格式补 /v1。

2. 注册、登录、IP 加白

先打开统一入口：

https://cf-ip-whitelist-worker.pages.dev/

按顺序完成：

1. 注册账号。
2. 登录账号。
3. 提交当前公网 IP 到白名单。

完成后再访问官网：

https://superapi.buzz

https://superapi.buzz 支持海外、海内直连。如果仍然遇到 403 Forbidden，说明当前 IP 风险较高，换 IP、换梯子或重新加白。

3. 创建 API 令牌

1. 登录 SuperAPI 控制台。
2. 进入控制台的令牌 / API Key 页面。
3. 新建令牌。
4. 复制并保存令牌。令牌只展示一次，丢失后重新创建即可。

服务地址仍然是：

https://superapi.buzz

4. 选择客户端

常用客户端配置规则如下：

客户端	Base URL	Token 填写位置
Codex CLI	https://superapi.buzz/v1 或客户端要求的 OpenAI Base URL	OpenAI API Key
Claude Code	ANTHROPIC_BASE_URL=https://superapi.buzz	ANTHROPIC_AUTH_TOKEN
CC Switch	新建配置里的 Base URL	配置里的 Token
Cherry Studio	OpenAI 兼容提供商 Base URL	API Key

5. 安装常用 CLI

如果你要同时使用 Claude Code、Codex、Gemini CLI，可以一次安装：

npm install -g @anthropic-ai/claude-code@latest @openai/codex@latest @google/gemini-cli@latest

检查版本：

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

6. 最小验证

配置完成后，先用最小请求测试：

curl https://superapi.buzz/v1/models \
  -H "Authorization: Bearer sk-你的令牌"

如果返回模型列表，说明令牌和地址基本可用。

7. 出错先看这三项

• 401：令牌错误、令牌被删、复制时多了空格。
• 404：Base URL 填错，常见是漏了 /v1 或多填了路径。
• 403：当前 IP 被 CF 拦截，先去 https://cf-ip-whitelist-worker.pages.dev/ 加白，或换 IP / 换梯子。
• 503：当前分组 / 模型 / 上游账号暂时不可用，可换模型或稍后重试。