第三方客户端接入

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.6-luna 或 gpt-5.4-mini	成本低，响应快
Codex 任务	gpt-5.3-codex	面向代码任务的版本

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

TIP

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

Grok CLI 配置（grok-4.6 / Responses）

Grok CLI 使用独立的 endpoint 配置。下面以 grok-4.6 为例，将模型请求路由到 Brivionix 的统一 API 地址。

[endpoints].models_base_url 用于模型列表与主要推理请求。这里需要填写带 /v1 的 Brivionix API 地址：https://brivionix.com/v1。

配置文件位置：Linux / macOS 为 ~/.grok/config.toml，Windows 为 %USERPROFILE%\.grok\config.toml。api_key 填写 Brivionix 控制台「令牌管理」中创建的 API Key，无需再额外设置环境变量。

安装或更新（Linux / macOS）

curl -fsSL https://x.ai/cli/install.sh | bash
grok update
grok --version

写入 ~/.grok/config.toml

将 sk-你的 Brivionix API Key 替换为你在 Brivionix 控制台创建的令牌。不要把真实密钥提交到代码仓库或公开截图中。

[models]
default = "grok-4.6"
default_reasoning_effort = "xhigh"

[endpoints]
models_base_url = "https://brivionix.com/v1"

[model."grok-4.6"]
model = "grok-4.6"
name = "Grok 4.6"
api_key = "sk-你的 Brivionix API Key"
api_backend = "responses"
context_window = 500000
supports_backend_search = true

[auth]
preferred_method = "api_key"

[session]
# 可选：官方默认值为 85；设为 80 会更早触发自动压缩
auto_compact_threshold_percent = 80

[ui]
max_thoughts_width = 120
yolo = true
compact_mode = false
permission_mode = "always-approve"

yolo = true 与 permission_mode = "always-approve" 会允许 Grok CLI 无需逐次确认就修改文件和执行命令，只建议在可信项目与可信运行环境中使用。max_thoughts_width = 120、关闭 compact_mode 与上述配置保持一致。

验证配置与请求

grok inspect
grok models
grok --model grok-4.6 --output-format json -p '只输出 XAI_GROK_OK'

context_window = 500000 使用 grok-4.6 官方模型专页当前公布值；supports_backend_search = true 适用于 Brivionix 转发到 Grok Cloud 的链路。

这里的 api_key 必须是 Brivionix 控制台令牌（通常以 sk- 开头），不能填写 grok.com OAuth refresh_token。由于密钥以明文保存在配置文件中，Linux / macOS 建议执行：

chmod 600 ~/.grok/config.toml

共享机器则优先采用 Grok CLI 官方支持的 env_key 方式，并定期轮换 Brivionix 令牌。

手动配置（任意 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）**中是否有错误条目可参考