bblabu API 中转站 使用教程
ChatGPT / Claude Code / VS Code / Node.js 全流程接入 · OpenAI & Claude 双接口支持
购买后使用流程
兑换码开通到账户,按教程一键配置即可使用
-
1
拍下商品
按所选规格下单
-
2
获取兑换码
订单后获得专属码
-
3
登录网站 api.bblabu.cn
注册或登录个人账号
-
4
输入兑换码
点击钱包管理,选择额度充值,兑换码充值,填入兑换码。
-
5
兑换到账户
个人钱包或绑定套餐
-
6
一键配置
按教程完成设置
兑换码请妥善保管,请勿泄露;兑换失败可联系技术处理。
📖 文档说明
本教程收录 bblabu API 中转站全流程使用方法,覆盖 ChatGPT、Claude Code、VS Code 三种主流客户端的接入与排错。
先看 Node.js 下载 → 线路与接口地址 → CC Switch 配置 → 按需看 ChatGPT / Claude Code / VS Code 教程。
⚡ 快速开始
最短 5 分钟跑通 ChatGPT / Claude Code,新手直接照抄。
- 安装 Node.js —— 点此跳转,按系统下载安装包。
- 生成令牌 —— 登录 bblabu 后台 → API 密钥 → 创建密钥,复制
sk-xxx。 - 下载 CC Switch —— 点此跳转,用它一键导入配置。
- 安装 ChatGPT 或 Claude Code —— ChatGPT / Claude Code 二选一。
- 发送测试消息 —— 看到 AI 回复就说明接通了~
📦 Node.js 下载区
Claude Code、VS Code 里的插件和命令行工具,很多都会用到 Node.js。已经装过可以直接跳过;没装过就按你的系统点下面的安装包。
Windows 下载(x64 / ARM64)
macOS 下载(Intel / Apple Silicon)
终端执行 node -v && npm -v,能看到版本号就 OK~
🌐 线路与接口地址怎么填
平台现已部署香港、日本、新加坡、美国 4 地区共 20+ 节点,全线 cn2 线路,并开启全球智能调度系统,自动选择最优路线。下面两条线路任选一条,复制到 CC Switch 或客户端的 Base URL 字段即可。
平台现已部署香港、日本、新加坡、美国 4 个地区共 20 余个节点,全线采用 cn2 线路,并开启全球智能调度系统,系统会自动选择最优路线,不再是纯香港线路。
https://api.bblabu.cn/v1
香港 · 日本 · 新加坡 · 美国 多节点智能调度,系统自动选择最优路线
https://api.bblabu.chat/v1
与主线路一样,4 地区 20+ 节点智能调度,目前负载较低体验更好
https://api.bblabu.cn
Claude Code / Anthropic 接口专用,不要加 /v1
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 下载
Linux 下载(x64 / ARM64)
从 bblabu 一键导入配置
bblabu 支持把供应商配置一键导入到 CC Switch。导入后可直接应用到 Codex、Claude Code、OpenClaw、Hermes 等工具,不用手动编辑多个配置文件。
- 先在 bblabu 控制台 创建或复制 API Key。
bblabu 控制台 API Key 管理界面 - 打开 bblabu 提供的「CC Switch」一键导入入口。
CC Switch 一键导入入口 - 系统会唤起 CC Switch,进入供应商导入流程。按需勾选要写入的工具:Claude Code、Codex、Gemini。
CC Switch 供应商导入流程 - 点击保存并切换为当前供应商。
手动创建配置(可选)
如果不用一键导入,也可以手动创建:
- 打开 CC Switch,点击右上角「创建新配置」。
- 按工具类型选择 Codex、Claude Code、OpenClaw 或 Hermes。
- 填入 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。
- Codex / OpenAI 兼容工具:
- 点击「高级选项」打开模型选择页面。
- 点击「获取模型列表」,把获取到的模型名称填入待配置的模型项。
- 点击「保存」生成配置并使用。
生效规则
大多数工具切换配置后需要重启终端或 CLI 才会生效;Claude Code 当前支持供应商数据热切换,通常不需要重启。
CC Switch 能管什么
- 统一管理 Codex、Claude Code、OpenClaw、Hermes 等工具的供应商配置。
- 一键导入供应商配置,减少手动改 JSON、TOML 或环境变量。
- 通过 Deep Link 导入供应商、MCP 服务器、提示词和技能。
- 支持系统托盘快速切换供应商。
- 支持 MCP 和 Skills 管理,适合多工具、多模型用户长期使用。
💬 ChatGPT 官方客户端
ChatGPT 是 OpenAI 统一后的官方应用,网页 / 桌面 / 手机全平台可用。认准官方入口,别装错。
官方入口
桌面版安装
- 打开 官方下载页,点「Download for macOS」获取 .dmg 安装包(需 macOS 14 及以上,建议 M 系列芯片)。
- 打开 .dmg,把 ChatGPT 拖入「应用程序」。
- 任意界面按 Option + Space 即可唤起。
- 打开 官方下载页,会自动跳转 Microsoft Store。
- 在 Microsoft Store 页面点「获取」安装。
- 任意界面按 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 | bashmacOS 用户也可以用 Homebrew 安装:
brew install --cask claude-code官方已不再推荐用 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 的请求地址填根域名即可,工具会自动拼接 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_*.deb 或 sudo rpm -i code-*.rpm。
第二步:把 VS Code 切换成中文
- 打开 VS Code → 左侧点击「扩展」图标(Ctrl + Shift + X)。
- 搜索
Chinese→ 找到 Chinese (Simplified) Language Pack(发布者 Microsoft)→ 点击 Install。 - 安装后右下角弹出提示 → 点击 Change Language and Restart 重启生效。
第三步:安装官方 AI 插件
第四步:确认接入
插件装好后,先确认 CC Switch 已启动并选中 bblabu 线路,再回到 VS Code。
第五步:测试一次
- 左侧活动栏找到 ChatGPT / Claude Code 图标,打开面板。
- 输入测试消息:
请用中文回复:你好,帮我确认 VS Code 插件已经可以正常连接使用。 - 能正常收到回复就说明配置成功 ✨
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.chatgpt 或 ext 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 用根域名。
❌ 切换成中文界面
- 退出程序。
- 打开网络代理环境。
- 重新打开程序。
- 在设置中切换中文。