Chatbox 怎么用?开源 AI 桌面客户端接入 OpenAI、Claude 和 Ollama

介绍 chatboxai/chatbox 这个开源桌面 AI 客户端的功能、适合人群、模型接入方式,以及它和网页聊天工具、本地 Ollama、Open WebUI 的区别。

Chatbox 是一个开源桌面 AI 客户端,GitHub 仓库是 chatboxai/chatbox

它的定位很直接:把不同 AI 模型接到同一个聊天窗口里。你可以用它连接 OpenAI、Claude、Gemini、DeepSeek、Ollama 等服务,也可以在 Windows、macOS、Linux 上使用。

如果你平时只用 ChatGPT 网页版,Chatbox 不一定是必需品。
但如果你经常在多个模型、多个 API Key、本地模型和云端模型之间切换,它会更像一个统一工作台。

Chatbox 能做什么

Chatbox 主要解决三个问题。

第一,把多个 AI 服务放到一个客户端里。你不用在 ChatGPT、Claude、Gemini、本地 Ollama、各种 API 控制台之间来回切。

第二,保留桌面客户端体验。相比纯网页工具,它更适合长期打开、管理会话、保存历史记录和固定工作流。

第三,降低 API 用户的使用门槛。很多模型服务本身只提供 API,对普通用户不友好。Chatbox 可以把 API 变成类似聊天软件的界面。

简单说,它不是一个新模型,而是一个 AI 聊天客户端。

支持哪些平台和模型

从项目介绍看,Chatbox 支持主流桌面系统:

  1. Windows
  2. macOS
  3. Linux

它也支持多种模型来源。常见用法包括:

  1. OpenAI API
  2. Claude / Anthropic
  3. Google Gemini
  4. DeepSeek
  5. Ollama 本地模型
  6. 其他 OpenAI 兼容接口

其中最实用的是 OpenAI 兼容接口和 Ollama。现在很多模型服务都会提供类似 OpenAI 的 /v1/chat/completions 接口,只要地址、API Key 和模型名能对上,通常就可以接入这类客户端。

怎么安装

最稳妥的方式是从官方仓库或官网入口下载:

  1. 打开 Chatbox GitHub 仓库
  2. 进入 Releases 页面。
  3. 根据系统选择 Windows、macOS 或 Linux 安装包。
  4. 安装后打开 Chatbox。
  5. 在设置里添加模型提供商和 API Key。

如果只是普通用户,不建议一上来从源码构建。直接下载 release 包更省事。

如果你使用的是本地 Ollama,可以先确认 Ollama 已经运行:

1
ollama list

再在 Chatbox 里添加本地接口。常见地址类似:

1
http://localhost:11434

具体字段名称可能随版本变化,但思路基本一样:选择提供商,填接口地址,填模型名,保存后测试。

适合哪些人

Chatbox 适合四类用户。

第一类是 API 用户。你已经有 OpenAI、Claude、Gemini、DeepSeek 或其他模型服务的 Key,但不想自己写前端界面。

第二类是本地模型用户。你用 Ollama 跑 qwenllamadeepseek 等本地模型,希望有一个好用的桌面聊天界面。

第三类是多模型对比用户。你经常想把同一个问题分别丢给不同模型,看哪个回答更好。

第四类是重视桌面体验的人。你不想每次都打开浏览器标签页,也不想把所有对话分散在不同网站里。

和 ChatGPT 网页版有什么区别

ChatGPT 网页版是 OpenAI 官方产品,登录后直接用,功能完整,适合大多数普通用户。

Chatbox 更像一个通用壳子。它不自带“万能模型”,而是让你自己接不同模型服务。

区别可以这样理解:

  1. ChatGPT 网页版:开箱即用,适合只用 OpenAI 的用户。
  2. Chatbox:需要配置,但可以接多个模型和接口。
  3. ChatGPT 网页版:功能由 OpenAI 控制。
  4. Chatbox:更适合自己管理 API、模型和本地服务。

如果你只是每天问几个问题,网页版更省心。
如果你想统一管理多个模型,Chatbox 更合适。

和 Ollama、Open WebUI 有什么区别

Ollama 是本地模型运行工具,负责把模型跑起来。它本身不是完整的桌面聊天产品。

Open WebUI 是一个偏网页端的本地 AI 界面,常和 Ollama 搭配使用,适合在浏览器里管理本地模型、用户和知识库等功能。

Chatbox 则更偏桌面客户端。

可以简单分工:

  1. Ollama:负责本地模型运行。
  2. Open WebUI:负责浏览器里的本地 AI 工作台。
  3. Chatbox:负责桌面端聊天和多模型接入。

如果你只想在本机跑一个本地模型,Ollama + Chatbox 就够简单。
如果你要多人使用、网页访问、知识库和服务化管理,Open WebUI 会更合适。

和 Cherry Studio 有什么区别

Chatbox 和 Cherry Studio 都属于“多模型 AI 客户端”方向,用户群也有重叠。

大体上,Cherry Studio 更强调模型供应商管理、知识库、Agent、MCP 等更完整的工作流体验。Chatbox 则更轻一些,适合想要简单桌面聊天、多模型切换和 API 接入的人。

选择时可以看需求:

  1. 只想要稳定聊天、多模型切换:Chatbox 更直接。
  2. 想玩更多工作流、知识库和插件能力:可以对比 Cherry Studio。
  3. 已经在用某个客户端:没必要频繁迁移,重点看会话导出、模型支持和使用稳定性。

使用时要注意什么

第一,API Key 要自己保管好。不要把 Key 发给别人,也不要截图公开设置页。

第二,第三方客户端会经过你配置的模型服务。敏感资料、公司内部代码、客户数据不要随便发送到不确定的模型接口。

第三,费用由模型服务方计费。Chatbox 只是客户端,真正消耗 token 的是 OpenAI、Claude、Gemini、DeepSeek 或你连接的其他服务。

第四,本地模型不等于完全免费。Ollama 跑本地模型虽然不消耗云端 API 费用,但会占用 CPU、内存、显存和电力,模型越大越吃机器配置。

第五,开源项目也要关注版本更新。安装包最好从 GitHub Releases 或官网入口下载,不要从来路不明的网盘和二次打包站获取。

我的看法

Chatbox 的价值在于简单。

现在 AI 工具越来越多,问题不是“没有模型可用”,而是每个模型都有自己的入口、价格、账号和限制。Chatbox 把这些入口收进一个桌面客户端里,对经常切换模型的人很省心。

它不适合替代所有专业工作流,也不一定比官方网页功能更多。
但如果你想把云端 API、本地 Ollama 和 OpenAI 兼容接口放到一个窗口里管理,Chatbox 是一个值得试的开源选择。

参考资料

记录并分享
使用 Hugo 构建
主题 StackJimmy 设计