mascot bblabuDocs API 接入指南
✦ v2.0 教程大补充

bblabu API 中转站 使用教程

ChatGPT / Claude Code / VS Code / Node.js 全流程接入 · OpenAI & Claude 双接口支持

  • 🪟 Win / macOS / Linux 三端
  • ⚡ 直链下载
  • 💡 报错速查
⚙️ CC Switch 一键导入配置
🧠 ChatGPT / Claude 主流模型随选
🪟 VS Code 官方 AI 插件
萌系吉祥物
技术支持 有任何不懂的或技术问题,可添加技术微信:wancezhilian

配置、兑换、登录、客户端报错都可以咨询。

联系技术

购买后使用流程

兑换码开通到账户,按教程一键配置即可使用

  1. 1
    拍下商品

    按所选规格下单

  2. 2
    获取兑换码

    订单后获得专属码

  3. 3
    登录网站 api.bblabu.cn

    注册或登录个人账号

  4. 4
    输入兑换码

    点击钱包管理,选择额度充值,兑换码充值,填入兑换码。

  5. 5
    兑换到账户

    个人钱包或绑定套餐

  6. 6
    一键配置

    按教程完成设置

配置完成后,即可开始使用

兑换码请妥善保管,请勿泄露;兑换失败可联系技术处理。

📖 文档说明

本教程收录 bblabu API 中转站全流程使用方法,覆盖 ChatGPT、Claude Code、VS Code 三种主流客户端的接入与排错。

💡
推荐阅读顺序

先看 Node.js 下载线路与接口地址CC Switch 配置 → 按需看 ChatGPT / Claude Code / VS Code 教程。

主站注册地址
api.bblabu.cn
新增备用线路
api.bblabu.chat
余额优惠充值
fake.kkkliao.cn
线路部署
香港 · 日本 · 新加坡 · 美国 4 地区 20+ 节点智能调度
系统支持
Windows · macOS · Linux
维护方
bblabu 团队
更新日期
2026.07.17

快速开始

最短 5 分钟跑通 ChatGPT / Claude Code,新手直接照抄。

  1. 安装 Node.js —— 点此跳转,按系统下载安装包。
  2. 生成令牌 —— 登录 bblabu 后台 → API 密钥 → 创建密钥,复制 sk-xxx
  3. 下载 CC Switch —— 点此跳转,用它一键导入配置。
  4. 安装 ChatGPT 或 Claude Code —— ChatGPT / Claude Code 二选一。
  5. 发送测试消息 —— 看到 AI 回复就说明接通了~

📦 Node.js 下载区

Claude Code、VS Code 里的插件和命令行工具,很多都会用到 Node.js。已经装过可以直接跳过;没装过就按你的系统点下面的安装包。

验证安装

终端执行 node -v && npm -v,能看到版本号就 OK~

🌐 线路与接口地址怎么填

平台现已部署香港、日本、新加坡、美国 4 地区共 20+ 节点,全线 cn2 线路,并开启全球智能调度系统,自动选择最优路线。下面两条线路任选一条,复制到 CC Switch 或客户端的 Base URL 字段即可。

🚀
【线路维护完成】

平台现已部署香港、日本、新加坡、美国 4 个地区共 20 余个节点,全线采用 cn2 线路,并开启全球智能调度系统,系统会自动选择最优路线,不再是纯香港线路。

🌏
主线路(默认)OpenAI 兼容 https://api.bblabu.cn/v1 香港 · 日本 · 新加坡 · 美国 多节点智能调度,系统自动选择最优路线
🌏
新增线路 · 负载低 · 体验好 OpenAI 兼容 https://api.bblabu.chat/v1 与主线路一样,4 地区 20+ 节点智能调度,目前负载较低体验更好
🌏
主线路(默认)Claude 兼容 https://api.bblabu.cn Claude Code / Anthropic 接口专用,不要加 /v1
🌏
新增线路 Claude 兼容 https://api.bblabu.chat Claude Code 备用线路,目前负载较低体验更好
💡
路径填写规则

OpenAI 兼容接口地址末尾要带 /v1,例 https://api.bblabu.cn/v1
Claude Code 填根域名即可,不要/v1,例 https://api.bblabu.cn

⚙️ CC Switch 安装与一键导入配置

CC Switch 是个超好用的多模型管理工具,能在不重启的情况下切换不同提供商的配置。

CC Switch 下载

从 bblabu 一键导入配置

bblabu 支持把供应商配置一键导入到 CC Switch。导入后可直接应用到 Codex、Claude Code、OpenClaw、Hermes 等工具,不用手动编辑多个配置文件。

  1. 先在 bblabu 控制台 创建或复制 API Key。
    在 bblabu 控制台创建或复制 API Key 的界面
    bblabu 控制台 API Key 管理界面
  2. 打开 bblabu 提供的「CC Switch」一键导入入口。
    bblabu 提供的 CC Switch 一键导入入口
    CC Switch 一键导入入口
  3. 系统会唤起 CC Switch,进入供应商导入流程。按需勾选要写入的工具:Claude Code、Codex、Gemini。
    CC Switch 供应商导入流程,勾选要写入的工具
    CC Switch 供应商导入流程
  4. 点击保存并切换为当前供应商。

手动创建配置(可选)

如果不用一键导入,也可以手动创建:

  1. 打开 CC Switch,点击右上角「创建新配置」。
  2. 按工具类型选择 Codex、Claude Code、OpenClaw 或 Hermes。
  3. 填入 bblabu API Key 和请求地址:
    • Codex / OpenAI 兼容工具:https://api.bblabu.cn/v1(或新增线路 https://api.bblabu.chat/v1),两条线路都是 4 地区 20+ 节点智能调度。
    • Claude Code:https://api.bblabu.cn(或 https://api.bblabu.chat),不带 /v1
  4. 点击「高级选项」打开模型选择页面。
  5. 点击「获取模型列表」,把获取到的模型名称填入待配置的模型项。
  6. 点击「保存」生成配置并使用。

生效规则

💡
切换后要不要重启?

大多数工具切换配置后需要重启终端或 CLI 才会生效;Claude Code 当前支持供应商数据热切换,通常不需要重启。

CC Switch 能管什么

  • 统一管理 Codex、Claude Code、OpenClaw、Hermes 等工具的供应商配置。
  • 一键导入供应商配置,减少手动改 JSON、TOML 或环境变量。
  • 通过 Deep Link 导入供应商、MCP 服务器、提示词和技能。
  • 支持系统托盘快速切换供应商。
  • 支持 MCP 和 Skills 管理,适合多工具、多模型用户长期使用。

💬 ChatGPT 官方客户端

ChatGPT 是 OpenAI 统一后的官方应用,网页 / 桌面 / 手机全平台可用。认准官方入口,别装错。

官方入口

桌面版安装

  1. 打开 官方下载页,点「Download for macOS」获取 .dmg 安装包(需 macOS 14 及以上,建议 M 系列芯片)。
  2. 打开 .dmg,把 ChatGPT 拖入「应用程序」。
  3. 任意界面按 Option + Space 即可唤起。
  1. 打开 官方下载页,会自动跳转 Microsoft Store。
  2. 在 Microsoft Store 页面点「获取」安装。
  3. 任意界面按 Alt + Space 即可唤起。

手机版

App Store / Google Play 搜索「ChatGPT」,认准开发者 OpenAI

⚠️
认准官方域名

只从 openai.com / chatgpt.com 官方域名下载和登录,谨防第三方仿冒客户端。

Claude Code 安装教程

Anthropic 官方的 Claude Code 客户端,配 bblabu 主线路跑 Opus 4.8 体验最佳。

第一步:安装 Node.js

同上:Node.js

第二步:安装 Claude Code

官方推荐使用原生安装脚本(零依赖,无需先装 Node.js):

curl -fsSL https://claude.ai/install.sh | bash

macOS 用户也可以用 Homebrew 安装:

brew install --cask claude-code
💡
关于 npm 安装方式

官方已不再推荐用 npm 安装 Claude Code(新版会提示 npm 安装已弃用),建议优先用上面的原生脚本。如确实需要 npm,可先确认 Node.js 再安装:

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

第三步:配置 config.toml

~/.claude 目录下新建 config.toml,填入:

base_url = "https://api.bblabu.cn"
model = "claude-opus-4-8"
💡
使用新增线路

如果要用新增线路,把 base_url 改成 https://api.bblabu.chat 即可。两条线路都是香港 · 日本 · 新加坡 · 美国 4 地区 20+ 节点智能调度,新增线路目前负载较低。注意:Claude Code 填根域名,不要/v1

第四步:配置 auth.json

{
  "api_key": "sk-你的bblabu密钥"
}

第五步:测试

claude --version

看到版本号后运行 claude,能正常回复就说明配置完成 ✨

附录:Claude Code 请求地址说明

⚠️
Claude Code 填根域名,不带 /v1

Claude Code 的请求地址填根域名即可,工具会自动拼接 Anthropic 路径。两条线路都是香港 · 日本 · 新加坡 · 美国 4 地区 20+ 节点智能调度

  • 主线路(默认):https://api.bblabu.cn
  • 新增线路(负载低):https://api.bblabu.chat

🪟 VS Code 使用教程

按顺序完成 VS Code 安装、中文界面、官方 AI 插件安装和连接测试。适合想在代码编辑器里直接用 GPT / Claude 系列模型的用户。

🛤️
使用前提示

先完成 快速接入 的环境配置,再回来继续本页。保持 CC Switch 处于运行中。

第一步:下载 Visual Studio Code

💡
安装小贴士

Windows 安装时建议勾选「添加到 PATH」和「通过 Code 打开」;macOS 下载后把 VS Code 拖到「应用程序」;Linux 用 sudo apt install ./code_*.debsudo rpm -i code-*.rpm

第二步:把 VS Code 切换成中文

  1. 打开 VS Code → 左侧点击「扩展」图标(Ctrl + Shift + X)。
  2. 搜索 Chinese → 找到 Chinese (Simplified) Language Pack(发布者 Microsoft)→ 点击 Install
  3. 安装后右下角弹出提示 → 点击 Change Language and Restart 重启生效。

第三步:安装官方 AI 插件

🟢 ChatGPT(OpenAI 官方)

用于跑 GPT 系列模型

插件市场
🟣 Anthropic Claude Code

用于跑 Claude 系列模型

插件市场

第四步:确认接入

插件装好后,先确认 CC Switch 已启动并选中 bblabu 线路,再回到 VS Code。

第五步:测试一次

  1. 左侧活动栏找到 ChatGPT / Claude Code 图标,打开面板。
  2. 输入测试消息:请用中文回复:你好,帮我确认 VS Code 插件已经可以正常连接使用。
  3. 能正常收到回复就说明配置成功 ✨

Linux 特别说明

🐧
Linux 用户三连确认

装完后打开终端运行:

code --version
node -v && npm -v
code --install-extension OpenAI.chatgpt
code --install-extension Anthropic.claude-code

🚑 常见报错排查

90% 的问题都能在这一节找到答案。Ctrl + F 搜错误码。

401 Unauthorized · 密钥错误

检查 CC Switch 里的 API Key 是否和 bblabu 后台一致,注意前后不要带空格。

404 Not Found · 路径错

Base URL 必须以 /v1 结尾,例 https://api.bblabu.cn/v1(Claude Code 除外,填根域名即可)。

ChatGPT 桌面版打不开或无法登录

检查系统地区 / 时区与网络环境,确认从 openai.com/chatgpt/download/ 官方页安装;仍不行就用网页版 chatgpt.com

VS Code 找不到插件

Ctrl + P → 粘贴 ext install OpenAI.chatgptext install Anthropic.claude-code

Node.js 命令找不到

Win 安装时没勾「Add to PATH」→ 重新跑安装包 → 勾上。macOS/Linux 装到 nvm 里更省事。

413 错误:请求包太大

原因:请求包太大被拒收。

解决方法:减小请求内容,或调整上下文窗口大小。可以编辑配置文件添加以下设置:

model = "gpt-5.4"
model_context_window = 1047576
model_auto_compact_token_limit = 900000
连接超时 / 线路不稳定

两条线路都是香港 · 日本 · 新加坡 · 美国 4 地区 20+ 节点智能调度,系统会自动选择最优路线。主线路 api.bblabu.cn 偶发繁忙时,切换到新增线路 api.bblabu.chat(目前负载更低)。OpenAI 兼容工具记得地址带 /v1,Claude 用根域名。

切换成中文界面
  • 退出程序。
  • 打开网络代理环境。
  • 重新打开程序。
  • 在设置中切换中文。
已复制