使用 CC Switch 接入 B.AI
已有 B.AI API Key 的用户，可以通过 CC Switch 配置 Claude Code 或 Codex。CC Switch 负责管理和切换供应商配置，配置完成后仍需在对应客户端中发起请求。
准备工作
- 从 CC Switch 官方发布页下载安装，并安装需要使用的 Claude Code 或 Codex 客户端。
- 在 API Key 页面获取 B.AI API Key。
- 确认账户余额充足，且所选模型支持对应客户端使用的接口及工具调用。
请像保管密码一样保管 API Key，不要放进截图、共享配置或代码仓库。即使 Key 输入框已遮挡，CC Switch 下方生成的配置预览仍可能显示完整 Key。
1. 选择客户端并添加供应商
打开 CC Switch，先选择 Claude Code 或 Codex，点击添加供应商，选择自定义配置，将供应商命名为 B.AI，并填入自己的 B.AI API Key。
两个客户端的请求地址和协议不同：
| 配置项 | Claude Code | Codex |
|---|---|---|
| 供应商名称 | B.AI | B.AI |
| 官网链接，可选 | https://b.ai/ | https://b.ai/ |
| API Key | 你的 B.AI API Key | 你的 B.AI API Key |
| 请求地址 | https://api.b.ai | https://api.b.ai/v1 |
| 上游格式 | Anthropic Messages（原生） | Responses（原生） |
| 完整 URL | 关闭 | 关闭 |
| 实际请求端点 | /v1/messages | /v1/responses |
展开高级选项检查上游格式。使用上述原生协议时，不需要为协议转换单独开启本地路由。首次接入建议使用直连配置，不要混用 Chat Completions 转换或聚合配置。
不要把完整的 /v1/messages 或 /v1/responses 请求端点填入“请求地址”。Claude Code 如显示“认证字段”选项，保持默认的 ANTHROPIC_AUTH_TOKEN 即可。
2. 获取并填写模型 ID
填好请求地址和 Key 后，点击获取模型列表。也可以在 API Key 页面点击模型右侧的复制按钮获取模型 ID。
请填写准确的模型 ID，而不是模型展示名称。本指南不维护固定模型名单；模型出现在列表中，并不代表一定支持所选客户端的接口和工具调用。
Claude Code：配置模型映射
在供应商的模型映射中，为需要使用的角色填写实际请求模型，例如 Sonnet、Opus、Haiku；如果当前版本还有 Fable、Subagent（子代理）或默认/兜底模型，也应按需配置。
首次验证时，建议将这些角色及默认/兜底模型统一设为同一个兼容的 B.AI 模型 ID。确认调用成功后，再根据需要为不同角色选择不同模型。
Sonnet、Opus 等是客户端的模型角色，不代表实际请求必须使用 Claude 模型。显示名称只影响菜单展示，实际请求模型才决定发送给 B.AI 的模型 ID。
只设置主模型，可能导致后台任务或子代理仍请求其他模型。不要仅为扩大界面显示值而勾选“1M 上下文”，应与所选模型实际支持的上下文窗口一致。
Codex：设置默认模型
将默认模型设为兼容的 B.AI 模型 ID。如果当前版本提供模型映射表，也将模型加入其中，便于在 Codex 的模型菜单中选择。
首次接入建议选择当前 Key 可用的 GPT 模型。使用 DeepSeek 时，请同时参照 Codex 接入指南关闭不支持的内置网页搜索等功能。
3. 保存、启用并重新加载
保存供应商配置，返回同一客户端的供应商列表，点击 B.AI 卡片的启用，确认卡片显示使用中。
保存配置不等于启用。Claude Code 和 Codex 的供应商配置分别管理，启用其中一个不会自动配置另一个。
Claude Code 请启动新会话；Codex 桌面端请完全退出后重新打开，CLI 请启动新会话，让客户端重新加载供应商配置和模型目录。
如果希望切换供应商时保留 Codex 官方账号登录，可按 Codex 接入指南中的可选步骤设置。不要复制或共享 auth.json。
4. 验证实际调用
在已配置的客户端中发送：
请只回复：B.AI 连接成功
再创建一个本地文本文件，写入简短的测试内容，请客户端通过文件读取工具或终端读取该文件，并返回文件内容。这样可以同时检查文本生成和工具调用是否正常。
最后在 B.AI 用量信息（Usage）页面核对对应请求、模型及用量。不要仅凭“获取模型列表成功”或模型回答中自称的身份判断接入成功。验证请求会产生正常的计费用量。
常见问题
| 问题 | 排查方式 |
|---|---|
| 获取不到模型列表 | 检查请求地址、Key、网络和账户/模型权限，确认使用生产地址及生产 Key。 |
| 能获取模型，但实际调用失败 | 确认模型支持所需的 Messages 或 Responses 接口及客户端工具调用，并检查接口返回的错误。 |
返回 401 | 检查 Key 是否有效，以及是否填入了正确客户端的供应商配置。 |
返回 404 | 检查地址与上游格式，避免重复拼接 /v1，或误把完整请求端点当作基础地址。 |
| 提示模型不存在 | 使用当前 Key 可用的准确模型 ID，并检查所有模型映射，包括后台任务角色。 |
| 仍然使用之前的供应商 | 确认 B.AI 已在正确客户端下启用，重新启动客户端，并检查终端环境变量或项目配置是否覆盖了设置。 |
| 用量中出现未手动选择的模型 | 检查 Claude Code 的角色、子代理和兜底模型映射，以及是否有其他会话复用了同一个 Key。 |