跳转到主要内容
ChatBox 是一款支持 Windows / macOS / Linux / iOS / Android 的开源跨平台 AI 桌面客户端。

​
配置步骤

1

打开设置

左下角齿轮图标 → 设置。
2

选择模型提供方

在 AI 提供方 / Model Provider 中选择 OpenAI API(也可选择自定义)。
3

填写连接信息

  • API Host / API 地址:https://openp.ai/v1
  • API Key / API 密钥:sk-XXXXXXXXXXXXXXXX
  • 模型 / Model:在下拉中选择或填入自定义模型 ID,如 gpt-5.5、claude-opus-4-8
4

保存并开始对话

回到主界面新建会话,顶部选择模型即可使用。

​
添加多个模型

ChatBox 支持在 模型列表 中预设多个模型,切换会话时直接选择即可:
  1. 设置 → 模型 → 添加自定义模型。
  2. 填入 OpenPAI 控制台上的模型 ID。
  3. 保存后,主界面对话顶部下拉菜单中即可看到。
推荐预设的模型组合:
  • gpt-5.4-mini(日常对话,便宜)
  • claude-opus-4-8(代码与长文)
  • gemini-3.1-pro-preview(超长上下文)
  • o3-mini-high(复杂推理)
  • dall-e-3 / gpt-image-1(图像生成)

​
移动端

ChatBox 的 iOS / Android 应用同样支持自定义 API Host, 配置流程与桌面端一致。建议把 API Key 设置为有额度上限的子令牌以防止丢失设备造成损失。

​
注意

  • ChatBox 默认使用 OpenAI 协议,因此 Base URL 必须包含 /v1。
  • 若 ChatBox 提示 “无法连接” / “Network Error”,请检查:
    • 网络是否能访问 https://openp.ai。
    • Base URL 末尾是否多余了斜杠。
    • 系统代理是否影响请求。