Chatbox使用教程：从安装到配置API完整指南

如果你想找一款界面简洁、支持多模型、可本地保存聊天记录的 AI 客户端，那么 Chatbox 是非常值得尝试的一款工具。它支持 Windows / macOS / Linux / iOS / Android / Web，多平台可用；既可以使用 Chatbox AI 官方托管服务，也可以接入你自己的 API Key（如 OpenAI、Claude、Gemini、DeepSeek 等）。官方将它定位为一个“通用遥控器”——本身不直接提供模型，而是帮助你连接并使用各种 AI 模型服务。

本文将带你完整了解：

• Chatbox 是什么

• Chatbox 的主要功能

• 如何安装与配置

• 第一次如何使用 Chatbox 进行对话

• 常见报错与排查思路

Chatbox 是什么？

Chatbox 是一款面向个人和办公/学习场景的 AI 聊天客户端。它最大的特点是：

• 支持接入多个大模型服务

• 支持桌面端和移动端

• 聊天记录与设置默认存储在本地设备

• 支持文件理解、图像生成、联网搜索等增强能力（具体可因使用的服务方式/模型而不同）

官方说明中提到，Chatbox 客户端本身是免费且开源的，你可以使用自己的 API Key 来访问模型；如果不想自己折腾 API，也可以使用 Chatbox AI 官方服务，通过登录账号直接使用，并且新用户通常可以领取每日刷新的免费额度。

适合哪些人？

Chatbox 非常适合以下用户：

• 学生 / 研究者：做摘要、论文阅读、知识整理

• 内容创作者：写文案、润色、翻译、改写

• 程序员 / 开发者：代码生成、调试、解释代码

• 办公人群：总结文档、生成表格说明、写邮件/方案

• 多模型重度用户：希望一个客户端里切换 ChatGPT、Claude、DeepSeek、Gemini 等模型

Chatbox 的主要功能

根据神马中转API教程文档和 Chatbox 官方资料，Chatbox 的核心能力可以概括为以下几类。

1）多模型统一接入

你可以在 Chatbox 中切换不同模型提供方，比如：

• OpenAI / ChatGPT 系列

• Claude / Anthropic 系列

• Gemini

• DeepSeek

• 以及其他兼容 OpenAI API 格式的服务

对于经常横向比较模型输出质量的人来说，这一点非常方便。官方也明确表示，Chatbox 支持“连接数百个主流 AI 模型”。

2）与文档和图片聊天

你可以把 PDF、Word、Excel、图片、代码文件 直接发送给 Chatbox，然后围绕内容继续提问。对于“看论文”“读合同”“分析表格”“识别截图内容”等场景非常实用。

3）代码生成与预览

Chatbox 支持代码类任务，包括：

• 生成代码

• 解释代码

• 修改代码

• 帮你做简单的前端页面/脚本

• 某些场景下支持更强的代码展示体验

4）联网搜索与实时查询

当你需要最新信息时，Chatbox 可结合联网能力进行搜索，例如：

• 最新新闻

• 产品信息

• 技术文档

• 实时知识问答

5）AI 图表与可视化

Chatbox 支持将数据或内容生成图表、可视化表达，帮助你更直观地理解趋势、结构和逻辑关系。whatai 文档也提到它支持图表可视化与公式渲染等展示能力。

6）AI 图像生成

官方首页明确提到，Chatbox AI 支持图像生成。你只要输入一段描述（Prompt），即可生成对应图片。具体是否可用、额度多少，取决于你使用的是官方服务还是第三方 API，以及你所选模型。

7）本地优先的数据存储

这是很多人非常在意的一点。官方说明中强调：

• 聊天消息和设置数据默认存储在你的设备本地

• 如果你使用的是 Chatbox AI 官方服务，为了生成回复，你发送的消息/文件会被传到官方服务端处理，但官方表示不会永久存储，也不会用于广告或训练等其他用途

• 如果你使用的是第三方 API，数据隐私则取决于第三方服务商的政策

这一点对于重视隐私的用户非常重要。

Chatbox 安装与配置

安装配置主要分为两步：下载 Chatbox 和 配置 API。

1）下载 Chatbox

首先前往 Chatbox 客户端下载页面或 GitHub，下载适合你系统的安装包。whatai 文档给出的安装包对应关系如下：

• Windows → 下载 .exe

• macOS → 下载 .dmg

• Linux → 下载 .AppImage

如果你使用手机，也可以安装对应的 iOS / Android 版本；如果只是想临时体验，也可以先用 Web 版。官方首页明确说明 Chatbox 支持 Windows / Mac / Linux / iOS / Android / Web 全平台。

安装建议

• Windows 用户：双击 .exe 直接安装

• macOS 用户：打开 .dmg 后拖入应用程序目录

• Linux 用户：给 .AppImage 增加执行权限后运行

• 首次启动提示安全风险：macOS 可能会遇到“应用已损坏/无法验证开发者”等提示，这类问题官方帮助中心有专门 FAQ 分类可查。

2）配置 API

首次启动 Chatbox 后，你可以直接在设置里填写 API 参数。步骤如下：

步骤 1：打开设置（Settings）

启动 Chatbox 后，进入 Settings（设置） 页面。

• 桌面端：一般在左下角侧边栏找到设置入口

• 移动端：先点左上角菜单（☰）展开侧边栏，再进入设置

这一点也和 Chatbox 官方“第一次对话”页面描述一致。

步骤 2：填写 API Key

在 API Key 一栏中，填写你从 神马中转 API 平台 获取到的 Key，例如：

sk-xxxxxxx

步骤 3：填写 API Base URL

在 API Base URL / API Host 中填写：

https://api.whatai.cc

步骤 4：保存配置

保存后即可开始使用。

这样配置后，无论你调用 OpenAI、Claude 还是 DeepSeek，都可以统一通过 神马中转 API转发，不需要为每个模型单独配置不同 Key。

Chatbox 详细使用教程

这一部分结合 Chatbox 官方“第一次对话”页面，按新手实际使用流程来写。

1）第一次启动：欢迎界面怎么选？

首次打开 Chatbox 时，通常会看到欢迎界面。官方说明里有两个入口：

• 「我是新手」

• 「跳过引导」

建议怎么选？

• 纯新手：选 「我是新手」

• 你已经有 API Key / 已经会配置：选 「跳过引导」

如果你只是想尽快开始聊天，建议直接走 「神马中转API」，这是最省心的方式。

2）开始第一次对话

手动配置后开始对话

如果你已经按上面的方法配置好了 API，那么操作流程如下：

1. 打开 Chatbox

2. 点击 新建对话

3. 在顶部或模型选择区域，选择你想用的模型

4. 在输入框中输入问题

5. 回车发送

6. 查看 AI 回复

7. 左侧侧边栏会自动保存历史会话

示例 1：普通问答

帮我总结一下《小王子》的核心主题

示例 2：写作辅助

帮我写一篇 300 字的小红书风格护肤文案

示例 3：学习辅助

用高中生能听懂的方式解释牛顿第二定律

示例 4：编程任务

请写一个 Python 脚本，读取 CSV 并计算平均值

4）如何选择模型？

在新建对话时，你通常可以选择模型：

OpenAI / ChatGPT 系列

• gpt-5.4-nano

• gpt-5.4-mini-2026-03-17

• gpt-5.4-pro-2026-03-05

Claude / Anthropic 系列

• claude-opus-4-6

• claude-sonnet-4-6

• claude-haiku-4-5-20251001

• claude-3-5-sonnet-latest

**新手建议：**日常聊天/写作：选通用模型。写代码：优先 coder / 高推理模型，长文总结：选上下文更强的模型，追求性价比：选 mini / sonnet / chat 级别模型

5）如何上传文件和图片聊天？

如果你的 Chatbox 版本和所选服务支持文件能力，可以这样用：

1. 新建对话

2. 点击输入框附近的附件按钮（或拖拽文件）

3. 上传 PDF / Word / Excel / 图片 / 代码文件

4. 输入具体问题，例如：

   请总结这份 PDF 的核心观点

或：

请从这张截图中识别错误信息并告诉我如何解决

6）如何让回答更稳定、更好用？

很多人觉得“AI 不稳定”，其实往往是提问方式不对。这里给你一套 Chatbox 通用提问模板：

模板 1：明确任务 + 输出格式

请把下面内容总结成 5 条要点，并用表格输出：
（粘贴内容）

模板 2：指定身份 + 场景

你现在是一名资深前端工程师，帮我检查下面这段 React 代码的问题：
（粘贴代码）

模板 3：限制篇幅 + 风格

请用口语化、适合小红书的风格，写一篇 200 字以内的推荐文案

模板 4：多轮迭代

第一轮先让它出草稿：

先给我一个初稿，不要太长

第二轮再优化：

把第 2 段写得更有感染力，并加入 3 个标题备选

7）历史会话与管理

Chatbox 官方说明里提到，侧边栏会显示你的对话列表，你可以：

• 新建对话

• 切换历史会话

• 延续上下文

• 管理不同主题的聊天

使用建议

把不同任务分开建会话，例如：

• 论文总结

• Python 学习

• 简历优化

• 翻译润色

• 产品文案

这样后续追溯更方便，也能减少上下文混乱。

常见问题（FAQ / 报错排查）

问题 1：配置了 API Key，但发送消息没反应 / 报错

常见原因

1. API Base URL 填错

2. API Key 无效或复制不完整

3. 客户端版本较旧，接口兼容性不足

4. 模型名与当前服务不匹配

5. 网络环境异常

解决方法（优先级从高到低）

第一步：检查 Base URL 是否正确

按 whatai 文档，依次尝试：

https://api.whatai.cc
https://api.whatai.cc/v1
https://api.whatai.cc/v1/chat/completions

第二步：确认 Key 是否完整

• 是否少了前缀（如 sk-）

• 是否有多余空格

• 是否复制了换行

第三步：更换模型测试

先选一个最常见、最稳定的模型测试，避免一上来就选不兼容模型。

第四步：升级 Chatbox 到最新版本

旧版本可能对部分模型支持不好。

问题 2：第一次打开看不懂，不知道选“我是新手”还是“跳过引导”

建议

• 新手 → 选 「我是新手」

• 会配 API 的用户 → 选 「跳过引导」

官方明确表示「我是新手」会进入交互式引导，一步步完成配置；而「跳过引导」更适合已经知道如何配置 API Key 的用户。

问题 3：模型为什么会自称是别的模型？是不是被“偷换模型”了？

这是很多人都会遇到的问题。Chatbox 官方专门有 FAQ 解释：“模型说自己是别的模型”并不等于平台偷换模型。 官方说明这是大语言模型的普遍现象——模型并不真正具备“自我身份认知”，它只是根据训练语料和当前提示词进行统计推测，因此可能会错误声称自己是 GPT-4、GPT-3.5 或其他模型。

官方建议

不要通过“你是什么模型？”来判断真伪，更可靠的方法是：

• 看模型能力表现（推理、代码、知识范围）

• 用标准化评测方式对比

• 观察模型的典型风格特征

所以：模型口头自报家门不可靠，不能当作是否“以次充好”的证据。

问题 4：我的聊天记录存在哪里？安全吗？

官方首页说明：聊天记录和设置默认存储在本地设备。

但如果你使用的是 Chatbox AI 官方服务：

• 你发送给 AI 的消息、上下文、图片或文件会传到服务端生成回复

• 官方表示可能会做短暂缓存以提升后续响应速度

• 不会永久存储

• 不会用于广告或模型训练等其他用途

问题 5：我想“免费用”Chatbox，可以吗？

可以，但要区分“客户端免费”和“模型是否免费”。

官方说明：

• Chatbox 客户端本身免费

• 新用户通常可领取 Chatbox AI 免费 License

• 免费额度一般是每日刷新

• 如果免费额度用完：

  • 可以升级套餐

  • 或者改用自己的 API Key / 中转 API

这点在官方首页和第一次对话页面里都有提到。

问题 6：为什么我在 macOS 上提示应用损坏 / 无法打开？

Chatbox 官方帮助中心目录里专门列出了 “macOS 提示应用已损坏” 相关 FAQ。虽然你给的链接是错误页入口而不是具体单篇，但从帮助中心结构可以确认这是官方已知问题类别。

一般处理思路

• 确认安装包来自官方渠道

• 删除后重新下载最新版

• 在系统安全设置里允许打开

• 如仍有问题，查看官方帮助中心对应 FAQ

给新手的最佳实践（强烈建议）

如果你是第一次用 Chatbox，建议直接使用神马中转API

1. 安装 Chatbox

2. 进入设置

3. 填写：

   • API Key

   • Base URL：api.whatai.cc

4. 保存

5. 新建对话

6. 选择模型

7. 开始聊天

这条路线适合你已经有 Key、想统一接多个模型、或者更偏向 BYOK 的用户。

总结：Chatbox 值不值得用？

如果你希望有一个：

• 比网页端更像“工作台”

• 支持多模型切换

• 支持文件理解

• 支持本地保存聊天记录

• 可以灵活选择官方服务或自带 API Key

那么 Chatbox 非常值得用。

尤其是对于：

• 学习党

• 内容创作者

• 程序员

• 重度 AI 用户

它能显著提升你的日常效率。官方也明确将其定位为一个多平台、可接入多模型的 AI 客户端，而 whatai 的教程则提供了一种非常实用的“中转 API 配置”玩法，适合想把多个模型统一接入的人。