Chatbox 配置自定义 AI 模型接口教程
Chatbox 桌面客户端添加自定义模型提供方的步骤：模型提供方选择、API 域名与密钥填写、模型添加，以及对话不响应的排查。
内容复核中：以下为保留的旧稿，不代表本站接入实测；配置、价格与模型信息请以对应产品当前官方文档为准。
Chatbox 是一款轻量的跨平台 AI 桌面客户端，配置简单，适合作为入门工具。这篇记录添加自定义 OpenAI 兼容接口的过程。
配置步骤
第 1 步：打开模型提供方设置
打开 Chatbox → 左下角 设置（齿轮图标）→ 模型（Model）→ 在提供方列表中选择 添加自定义提供方（Add Custom Provider）。
第 2 步：填写三项信息
| 字段 | 填什么 |
|---|---|
| 名称 | 自定义，如「我的端点」 |
| API 域名（API Domain） | 你的端点地址，一般填到 /v1 这一层 |
| API 密钥（API Key） | 你的密钥 |
第 3 步：添加模型
在「模型」字段填入端点支持的模型 ID（多个用逗号分隔）。保存后回到对话界面，在底部模型选择器里选中它。
第 4 步：验证
发一条消息，正常回复即完成。全程不超过两分钟。
特色功能提示
- 本地模型支持：Chatbox 也支持 Ollama / LM Studio 等本地推理，同一界面管理云端和本地模型
- 对话保存：本地存储对话记录，支持导出 Markdown
- 快捷指令：可以配置常用提示词模板，固定工作流场景好用
常见问题
一直转圈无响应
- API 域名层级：先试
/v1结尾，404 再试完整到/chat/completions（Chatbox 不同版本对路径拼接处理不同） - 端点的流式支持问题：个别网关 SSE 实现有缺陷，换个工具测试定位问题层
显示 401
Key 复制不完整或端点侧已失效，重新生成。
中文乱码
旧版本偶发，更新到最新版即可。
选型小建议
Chatbox、Cherry Studio、NextChat 这类客户端功能大同小异：
- 追求轻量、开箱即用 → Chatbox
- 要知识库、多模型深度管理 → Cherry Studio
- 主要在网页场景 → 沉浸式翻译这类插件
工具没有高下，配置逻辑都是「Base URL + Key + 模型名」三件套，学会一个等于全会。