跳到主要内容

如何通过 CC Switch 将 B.AI 接入 Codex？图文操作教程

本文介绍如何通过 CC Switch 在 Codex 中使用 B.AI API Key。完成配置后，Codex 将通过 B.AI Responses API 发起模型请求。

  • 生产 API 地址： https://api.b.ai/v1
  • 上游格式： Responses (native)
  • 建议首次使用的模型： gpt-5-mini
  • 截图版本： macOS 上的 CC Switch 3.20.0

后续 CC Switch 版本中的菜单名称可能略有不同，但 B.AI API 地址和 Responses 协议保持不变。

开始前准备​

请确认你已经：

  1. 安装 Codex 并完成首次登录；
  2. 从可信发布渠道安装 CC Switch；
  3. 创建有效的 B.AI 生产 API Key；
  4. 确认 B.AI 账户具有所需模型的访问权限和足够余额。

请将 API Key 视为密码。不要在截图、聊天消息、支持工单、源代码或公开仓库中泄露它。

1. 使用中文界面​

在 CC Switch 中打开 Settings > General，在 Language 下选择中文。本文截图使用英文界面展示；切换为中文后，配置位置和操作顺序一致，按对应中文字段操作即可。

CC Switch 英文界面截图示例

2. 保留 Codex 官方登录​

如果需要在 B.AI 和 OpenAI Official 之间切换，请打开 Settings > General，在 Codex App Enhancements 中启用 Keep official login for direct switches。

启用 Keep official login for direct switches

启用后，即使 B.AI 已生效，Codex 仍可能继续显示已登录的 OpenAI 账号，这是正常现象。CC Switch 中标记为 In Use 的供应商决定模型请求实际发送至何处。

3. 添加 Codex 供应商​

返回 CC Switch 首页，在应用栏中选择 Codex，然后点击橙色 + 按钮。

在 Codex Provider 下选择 Custom Configuration。

添加自定义 Codex 供应商

4. 填写 B.AI 生产环境配置​

请按下表填写供应商配置：

字段配置值
Provider NameB.AI Production
Website URLhttps://b.ai/
API Key你的 B.AI 生产 API Key
API Request URLhttps://api.b.ai/v1
Full URL关闭
Default Modelgpt-5-mini

填写 B.AI 生产环境供应商配置

API Key 输入后会被遮挡。截图或共享屏幕前不要点击眼睛图标。CC Switch 还可能在编辑器下方生成的 auth.json 预览中显示 API Key，因此请勿将该区域包含在截图中。

5. 选择原生 Responses 协议​

展开 Advanced Options，将 Upstream Format 设置为 Responses (native)。

选择 Responses native 作为上游格式

B.AI 原生支持 Responses API，此供应商不需要本地路由或协议转换。

点击 Fetch Models，检查生产地址、API Key 和账户访问权限。成功返回表示 CC Switch 已可访问 B.AI；模型数量会随着平台更新而变化。

6. 保存并启用 B.AI​

点击 Save。返回 Codex 供应商页面后，找到 B.AI Production 并点击 Enable。

启用已保存的 B.AI Production 供应商

切换成功后，B.AI Production 卡片会高亮并显示 In Use。

B.AI Production 已生效

CC Switch 会自动生成 Codex 配置。等效配置如下：

model_provider = "custom"
model = "gpt-5-mini"

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

CC Switch 会单独管理 API Key。请勿将真实 Key 写入文档、项目源代码或提交到版本控制的 config.toml 文件中。

7. 重启并验证 Codex​

完全退出并重新打开 Codex，或启动新的 Codex CLI 会话，以重新加载供应商配置和模型列表。

输入以下测试提示：

请严格回复：B.AI Codex connection successful

如果 Codex 返回指定文本，说明连接正常。你也可以在 B.AI 用量页面确认该请求已由 B.AI 处理。

生产环境已使用 gpt-5-mini 完成模型获取、非流式 Responses、SSE 流式 Responses 以及端到端 Codex 请求验证。

8. 切换模型​

首次连接建议使用 gpt-5-mini。验证成功后，编辑供应商配置并选择 Fetch Models 返回的其他模型。

初始 B.AI Responses 模型列表包括：

  • gpt-5-mini
  • gpt-5-nano
  • gpt-5.2
  • gpt-5.4
  • gpt-5.4-mini
  • gpt-5.4-nano
  • gpt-5.4-pro
  • gpt-5.5
  • gpt-5.5-instant
  • gpt-5.6-luna
  • gpt-5.6-sol
  • gpt-5.6-terra

模型可用性取决于 B.AI 账户、余额和 Codex 版本。B.AI Responses API 支持并不代表每个模型都兼容所有 Codex 版本。例如，gpt-5.4-nano 和 gpt-5.5-instant 不兼容 Codex CLI v0.149.1。如果模型在 Codex 中调用失败，请从 Fetch Models 返回的列表中选择其他模型，并在当前安装的 Codex 版本中验证。

9. 切回 OpenAI Official​

如需恢复 Codex 官方供应商，找到 OpenAI Official 并点击 Enable。

启用 OpenAI Official

切换后，OpenAI Official 卡片会高亮。

OpenAI Official 已重新生效

对于 Codex CLI，可以使用以下命令检查登录状态：

codex login status

已登录的官方账号通常会返回：

Logged in using ChatGPT

故障排查​

问题检查项
无法获取模型确认地址为 https://api.b.ai/v1、生产 Key 有效且账户余额充足。
401 UnauthorizedAPI Key 缺失、无效或属于其他环境。请确认使用的是生产 Key。
403 Forbidden检查账户状态、余额和模型访问权限。
找不到模型使用 Fetch Models 返回的准确模型 ID，并确认该模型支持 Responses。
Codex 仍使用此前供应商确认目标供应商已在 CC Switch 中高亮，然后完全重启 Codex。
Codex 仍显示官方账号启用了 Keep official login for direct switches 时属于正常现象；请以 CC Switch 中的当前供应商为准。

安全建议​

  • 仅从可信发布来源下载 CC Switch；
  • 不同项目或环境使用不同 API Key；
  • 定期轮换 API Key，怀疑泄露时立即撤销；
  • 不要复制、共享或手动编辑 ~/.codex/auth.json；
  • 不要在截图、日志、公开仓库或客户端安装包中包含 API Key。

相关文档​