bblabu API 中转站教程文档

1. 注册账号并获取 API 密钥

   访问 https://api.bblabu.cn，完成账号注册后，进入左侧「令牌管理」页面，添加并复制以 sk- 开头的密钥。

2. 选择线路

   默认使用 https://api.bblabu.cn；国内网络环境可以使用 https://api.kkkliao.cn 作为加速 / 防 ban 域名。

3. 安装客户端

   按照本文档中的 Codex 安装教程或 Claude Code 安装教程配置工具。

推荐方法：通过 CC Switch 一键配置 Codex

bblabu 支持把 Codex 配置一键导入到 CC Switch。推荐优先用这个方式，避免手动编辑 auth.json、环境变量或多个配置文件。

1. 先安装 Codex 命令行工具。
2. 在 bblabu 控制台创建 API Key。
3. 点击或复制 bblabu 提供的「导入到 CC Switch」配置。
4. 在 CC Switch 中选择 Codex / OpenAI 兼容配置。
5. 确认请求地址为 https://api.bblabu.cn，国内加速线路为 https://api.kkkliao.cn。
6. 保存并切换为当前供应商。
7. 退出并重新打开 Codex。

手动安装教程

如果你需要手动安装，流程分为：注册账号并获取 API 密钥、安装 Codex 命令行工具、使用 CC Switch 配置 Codex 运行环境、验证安装。

第一步：注册账号并获取密钥

1. 访问 bblabu 网站：https://api.bblabu.cn
2. 按页面提示完成账号注册。
3. 注册完成后，网页左侧选择进入「令牌管理」页面。
4. 点击「添加令牌」按钮创建新的令牌。
5. 复制以 sk- 开头的密钥，并妥善保存。

第二步：安装 Codex

如果没有安装 Node.js，先访问 Node.js 官网 下载 LTS 版本。安装完成后，验证版本：

node --version
npm --version

通过 npm 安装 Codex：

npm install -g @openai/codex

安装好后打开命令行，输入 codex，如果能正常使用代表安装完成。

第三步：使用 CC Switch 配置 Codex

Codex 建议交给 CC Switch 管理配置。bblabu 支持一键导入配置到 CC Switch，导入后可以直接写入 Codex 所需的密钥、请求地址和模型信息。

1. 打开 CC Switch。
2. 在 bblabu 控制台复制或点击「导入到 CC Switch」配置。
3. 在 CC Switch 中选择 Codex / OpenAI 兼容配置。
4. 确认 API Key、请求地址和模型名称无误。
5. 主线路请求地址使用 https://api.bblabu.cn。
6. 国内加速 / 防 ban 线路使用 https://api.kkkliao.cn/v1。
7. 保存并应用配置后，退出并重新打开 Codex。

备用：手动写入 Codex 配置

如果暂时不使用 CC Switch，可以找到 Codex 配置目录手动配置：

• Windows：%APPDATA%\Codex 或 C:\Users\[用户名]\.codex
• macOS / Linux：~/.codex 或 ~/.config/Codex

在配置目录中创建或编辑 auth.json 文件：

{
  "OPENAI_API_KEY": "sk-...您的密钥..."
}

如果需要在命令行工具里显式指定 bblabu 接口地址，也可以使用环境变量：

export OPENAI_API_KEY="sk-你的-bblabu-key"
export OPENAI_BASE_URL="https://api.bblabu.cn"

# 国内加速 / 防 ban 域名
# export OPENAI_BASE_URL="https://api.kkkliao.cn/v1"

第四步：验证安装

codex --version
codex test

如果能正常显示版本号并返回结果，则安装成功。

附录：Codex GUI 图形界面版本

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

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

提取教程中说明：GUI 版本会自动读取已有的 config.toml 和 auth.json 配置文件。

从零开始安装并配置 Claude Code 命令行工具，共分为四个步骤：

1. 创建专用令牌（API 密钥）。
2. 安装 Claude Code 命令行工具。
3. 使用 CCSwitch 配置运行环境。
4. 验证安装，确认可以正常使用。

第一步：注册账号并获取密钥

1. 访问 bblabu 网站：https://api.bblabu.cn
2. 按页面提示完成账号注册。
3. 注册完成后，网页左侧选择进入「令牌管理」页面。
4. 创建一个新的令牌；令牌分组请以 bblabu 控制台显示为准。
5. 复制以 sk- 开头的密钥，并妥善保存。

第二步：安装 Claude Code

官方推荐 macOS / Linux / WSL 使用安装脚本：

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

macOS 用户也可以使用 Homebrew 安装：

brew install --cask claude-code

如果使用旧版 npm 安装流程，可先确认 Node.js：

node --version
npm --version
npm install -g @anthropic-ai/claude-code

第三步：使用 CC Switch 配置环境

Claude Code 也建议通过 CC Switch 管理供应商配置。bblabu 的一键导入配置可以直接写入 Claude Code 所需的请求地址、密钥和模型信息。

1. 打开 CC Switch。
2. 在 bblabu 控制台复制或点击「导入到 CC Switch」配置。
3. 选择 Claude Code 配置。
4. 确认 API Key、请求地址和模型名称无误。
5. 点击「高级选项」按钮打开模型选择页面。
6. 点击「获取模型列表」按钮获取当前分组可以使用的模型。
7. 把获取到的模型名称，填入待配置的 5 个模型中。
8. 点击「保存」按钮生成配置并使用。

第四步：验证安装

完成以上配置后，打开命令行，输入以下命令启动 Claude Code：

claude

启动后，在对话框中输入：

你好

若收到正常的文字回复，则说明 Claude Code 已成功安装并配置完毕，可以正常使用。

第一步：安装 CC Switch

第二步：从 bblabu 一键导入配置

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

1. 先在 bblabu 控制台 创建或复制 API Key。
2. 打开 bblabu 提供的「导入到 CC Switch」入口，或复制对应的 CC Switch 导入链接。
3. 系统会唤起 CC Switch，进入供应商导入流程。
4. 确认供应商名称、API Key、Base URL 和模型名称。
5. 选择要写入的工具：Codex、Claude Code、OpenClaw、Hermes，按需勾选。
6. 点击保存并切换为当前供应商。

第三步：手动创建配置

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

1. 打开 CC Switch，点击右上角「创建新配置」。
2. 按工具类型选择 Codex、Claude Code、OpenClaw 或 Hermes。
3. 填入 bblabu API Key 和请求地址。
4. Codex / OpenAI 兼容工具通常使用 https://api.bblabu.cn。
5. Claude Code 通常使用 https://api.bblabu.cn。
6. 国内网络可切换到 https://api.kkkliao.cn 或 https://api.kkkliao.cn。
7. 点击「高级选项」打开模型选择页面。
8. 点击「获取模型列表」，把获取到的模型名称填入待配置的模型项。
9. 点击「保存」生成配置并使用。

第四步：生效规则

第五步：CC Switch 可以管理哪些内容

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

更改上下文方法（仅限 5.4）

编辑配置文件，添加以下设置：

model = "gpt-5.4"
model_context_window = 1047576
model_auto_compact_token_limit = 900000

413 错误

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

解决方法：减小请求内容或调整上下文窗口大小。

中文设置

1. 程序退出。
2. 打开网络代理环境。
3. 重新打开程序。
4. 然后在设置中切换中文。