大约 3 分钟
Chatbox 配置
Chatbox 是一款极简风格的桌面 AI 聊天客户端，是平台为完全零基础用户推荐的首选工具。配置步骤少到不能再少：下载、装好、填一个地址 + 一个令牌、选模型，就能开聊。没有任何花里胡哨的功能，就是"打开即用"。
接入结论
- API Host：
https://www.yuzhixiaolongxia.com（不带/v1，Chatbox 会自动补） - 服务商类型：
OpenAI API或OpenAI 兼容 - API Key：你的平台令牌
- 认证方式：
Authorization: Bearer <你的 API 令牌> - 模型 ID 查询：模型广场
- 官方下载：https://chatboxai.app
谁适合用 Chatbox
| 场景 | 是否推荐 |
|---|---|
| 完全零基础，只想"打开就能聊天" | 强烈推荐 |
| 不想看长教程，希望三步搞定 | 强烈推荐 |
| 想在电脑上替代浏览器版聊天 | 强烈推荐 |
| 想生图 / 生视频 | 不推荐，用 Cherry Studio |
| 想做自动化流程 | 不推荐，用 n8n |
| 想在手机或平板上用 | 改用 NextChat，浏览器直接打开 |
下载与安装
去官网下载安装包：https://chatboxai.app
| 系统 | 文件类型 | 安装方式 |
|---|---|---|
| Windows | .exe 安装包 | 双击运行，一路下一步 |
| macOS | .dmg 镜像 | 双击挂载后把图标拖到 Applications |
| Linux | .AppImage | 赋予执行权限后双击运行 |
安装完和普通软件一样，没有任何特殊步骤。
添加服务商
启动 Chatbox 后，第一次会弹出设置引导。如果没弹出，点左下角齿轮图标进入"设置"。
关键三步
- 在设置页找到"AI 模型服务商"或"模型提供商"区域。
- 服务商类型选
OpenAI API（也可能显示为 "OpenAI 兼容"）。 - 按下面表格填写：
| 字段 | 填写内容 | 说明 |
|---|---|---|
| API Host | https://www.yuzhixiaolongxia.com | 不带 /v1，Chatbox 自动补 |
| API Key | 你的平台令牌 | 在 令牌创建教程 创建 |
| 模型 | claude-opus-4-7（或其他你想用的） | 见下表 |
API Host 不带 /v1
Chatbox 内部会自动给你拼上 /v1，你只要填到域名就够了。如果手动加了 /v1，反而会变成 /v1/v1 导致 404。
- 保存配置。
选模型，开始聊
回到主界面，顶部或左侧有"模型选择器"，把刚才填的模型选中（或点击切换）。直接在底部输入框打字回车——你已经在用平台的 AI 了。
常用模型 ID
| 用途 | 推荐模型 ID |
|---|---|
| Claude 聊天 | claude-opus-4-7 |
| Codex 编程问答 | gpt-5.5 |
| Gemini 长上下文 | gemini-3.1-pro-preview |
在 Chatbox 里切模型
Chatbox 没有内置模型列表，需要你手动把模型 ID 输到"模型"字段里。建议把 3-5 个常用的都加上，之后切换就像换频道一样。
第一次验证
新建对话，发一句：
你好，请用一句话介绍你自己。几秒钟内收到回复，配置完成。
常见坑
401 Unauthorized / "Invalid API Key"
- 令牌完整复制，前后没有空格。
- 令牌没过期（去平台后台看令牌状态）。
- 服务商类型选了
OpenAI API，不是其他乱七八糟的选项。
"Not Found" / 404
最常见原因：API Host 手动加了 /v1。把它改回 https://www.yuzhixiaolongxia.com（不带 /v1）就好。
模型选择器里找不到模型
Chatbox 不会自动拉取平台的模型列表，必须在"模型"字段里手动输入模型 ID。模型 ID 要从 模型广场 精确复制，不要凭记忆敲。
一直转圈不回复
- 网络问题：浏览器能打开
https://www.yuzhixiaolongxia.com吗？打不开就是网络问题。 - 开了代理软件：试试关掉代理再发一次。
- 流式中断：偶尔会卡，关掉对话重开一个再发一次通常就好。
想换模型
回到设置页改"模型"字段，或者在主界面有快捷切换的位置直接切。切换之后下一条消息就用新模型了。
上一步：n8n 自动化工作流 | 下一步：NextChat 配置