bblabu API 中转站 使用教程

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

CC Switch 下载

从 bblabu 一键导入配置

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

1. 先在 bblabu 控制台 创建或复制 API Key。

   

2. 打开 bblabu 提供的「CC Switch」一键导入入口。

   

3. 系统会唤起 CC Switch，进入供应商导入流程。按需勾选要写入的工具：Claude Code、Codex、Gemini。

   

4. 点击保存并切换为当前供应商。

手动创建配置（可选）

如果不用一键导入，也可以手动创建：

1. 打开 CC Switch，点击右上角「创建新配置」。
2. 按工具类型选择 Codex、Claude Code、OpenClaw 或 Hermes。
3. 填入 bblabu API Key 和请求地址：
   • Codex / OpenAI 兼容工具：https://api.bblabu.hk/v1。
   • Claude Code：https://api.bblabu.hk，不带 /v1。
4. 点击「高级选项」打开模型选择页面。
5. 点击「获取模型列表」，把获取到的模型名称填入待配置的模型项。
6. 点击「保存」生成配置并使用。

生效规则

CC Switch 能管什么

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

下载 Codex++

使用流程

1. 打开 Codex++ → 点击「导入 CC Switch 配置」→ 选择 cc-switch-config.json。
2. 导入完成后会看到主线路已选中，点击「使用」。
3. 在「设置」里勾选「开启历史会话自动修复」—— 遇到报错会自动重试。
4. 点击「重启 Codex」，主页面状态显示「使用中」就 OK 了。
5. 最后回到 Codex 客户端主页面，看右下角是否显示 使用中 状态。

第一步：安装 Node.js

如果还没装，回 Node.js 下载区 装一下。

第二步：安装 Codex

npm install -g @openai/codex --registry=https://registry.npmmirror.com

第三步：下载 CC Switch 并配置

回 CC Switch 配置教程，导入 bblabu 配置。

第四步：登录测试

codex --version

看到版本号就说明装好了～ 接着在任意目录运行 codex，按提示选模型即可。

附录：Codex GUI 图形界面版本

Codex 除命令行版本外还提供图形界面版本。完成上述配置后可以下载桌面版使用。

• Codex 桌面版：https://openai.com/zh-Hans-CN/codex/

GUI 版本会自动读取已有的 config.toml 和 auth.json 配置文件。

附录：手动配置 Codex（不用 CC Switch）

如果暂时不想用 CC Switch，也可以手动写入配置文件：

在配置目录中创建或编辑 config.toml：

model_provider = "custom"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true

[model_providers.custom]
name = "custom"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://api.bblabu.hk/v1"

[features]
multi_agent = true

再创建 auth.json：

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

启动前确认：权限、模型和推理能力

1. 切换权限 —— 点击输入框左侧的权限菜单，选择「完全访问权限」。
2. 选择模型 —— 点击模型下拉菜单，选择需要使用的模型（如 gpt-5.4 / claude-opus-4-8）。
3. 选择推理能力 —— 按需要选择推理能力等级（low / medium / high / xhigh）。

第一步：安装 Node.js 与 Codex

同上：Node.js → Codex。

第二步：安装 Claude Code

官方推荐使用原生安装脚本（零依赖，无需先装 Node.js）：

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

macOS 用户也可以用 Homebrew 安装：

brew install --cask claude-code

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

第三步：配置 config.toml

在 ~/.claude 目录下新建 config.toml，填入：

base_url = "https://api.bblabu.hk"
model = "claude-opus-4-8"

第四步：配置 auth.json

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

第五步：安装 Node.js 与 Codex

这一步是 Codex 和 Claude Code 共用环境，可跳过——前面已装。

第六步：测试

claude --version

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

附录：Claude Code 请求地址说明

第一步：下载 Visual Studio Code

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

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

第三步：安装官方 AI 插件

第四步：确认接入

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

第五步：测试一次

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

Linux 特别说明

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