第三方客户端接入

Brivionix 控制台为多个第三方客户端预置了一键接入入口。无论一键还是手动，核心参数都是：

参数	值
API Base URL	https://brivionix.com/v1
API Key	令牌管理中创建的令牌
API 格式	OpenAI Chat Completions

推荐客户端

桌面端应用需要先下载安装，安装完成后在控制台令牌管理中点选对应图标，即可一键自动写入 API 地址与令牌，无需手动复制粘贴。

客户端	类型	下载地址
Cherry Studio	桌面端应用	cherry-ai.com
AionUI	桌面端应用	aionui.com
CC Switch	桌面端应用	GitHub Releases
AI as Workspace	网页版	aiaw.app（无需安装，直接访问）
OpenCat	桌面端 + iOS	opencat.app

下载并安装后，进入控制台令牌管理，点选对应客户端图标即可一键写入配置。

CC Switch 用法

CC Switch 是专门给 Codex CLI 和 Claude Code 做「多供应商 / 多 Key 快速切换」的桌面工具。Brivionix 控制台中点选 CC Switch 图标，会通过 ccswitch 协议把当前令牌一键写入到 CC Switch 中。

快速配置 Codex CLI

在 CC Switch 中将 Brivionix 添加为 Codex 端的 provider 后，即可直接在 Codex CLI 中使用 Brivionix 的 OpenAI 系列模型（如 gpt-5.3-codex）。

快速配置 Claude Code

CC Switch 也支持把 Brivionix 注入到 Claude Code 的 provider 槽位。由于 Brivionix 当前模型市场公开的是 OpenAI 兼容路径，你可以用 gpt-5.5 等 OpenAI 模型替代 Claude 槽位：

Claude Code 槽位	推荐填入的 Brivionix 模型	说明
Sonnet / Opus 槽位	gpt-5.5	1.1M 上下文，旗舰推理
Haiku 槽位	gpt-5.4-mini 或 gpt-5.2	成本低，响应快
Codex 任务	gpt-5.3-codex	面向代码任务的版本

这样即可在 Claude Code 的工作流里直接调用 Brivionix 的 OpenAI 系列模型，而不需要切换到其他客户端。

TIP

切换后请用一句简单 prompt（例如「你好」）在 Claude Code 中验证是否成功，失败时回到本文档底部的 验证方法 排查。

手动配置（任意 OpenAI 兼容客户端）

如客户端不在上面的推荐列表里，按 OpenAI 兼容服务手动填写即可：

配置项	填写
Provider 类型	OpenAI Compatible / Custom OpenAI
Base URL	https://brivionix.com/v1
API Key	sk-...
Model	gpt-5.4-mini 或模型市场中的其他模型

Base URL 拼接陷阱

部分客户端会自动拼接 /v1。如果请求最终变成 /v1/v1/chat/completions，请把 Base URL 改为 https://brivionix.com（去掉末尾 /v1）。

常见客户端备注

• Cherry Studio / OpenCat / AionUI / CC Switch — 桌面端 AI 客户端，按各自帮助文档导入 Brivionix 令牌即可。
• AI as Workspace — 网页版，无需安装，导入后以 strict 模式调用 https://brivionix.com/v1。
• Continue / Cline / Roo Code / Claude Code 等开发者助手 — 按「OpenAI Compatible」provider 类型手动填写即可。

验证方法

配置完成后发送一个简单请求：

你好，请回复"连接成功"。

如果失败，依次检查：

1. API Key 是否完整、是否带了 sk- 前缀
2. Base URL 是否重复或缺少 /v1
3. 模型名是否与模型市场一致（区分大小写）
4. 令牌分组与可用模型是否包含目标模型
5. 账户是否仍有余额
6. **调用日志（Usage Logs）**中是否有错误条目可参考