chatboxai/chatbox · 上手攻略

  • 仓库：chatboxai/chatbox
  • 链接：https://github.com/chatboxai/chatbox
  • 分类：skill
  • 作者：Jay
  • 更新：2026-07-11

这是什么

Chatbox 是一个跨平台桌面 AI 客户端，开源协议为 GPL-3.0，支持 Windows、macOS、Linux、Web、iOS 和 Android。它以本地数据存储为核心卖点，通过直观的界面聚合了 OpenAI（ChatGPT）、Claude、Gemini、Ollama（本地模型）等多种 LLM 提供方，并支持团队协作、DALL·E 3 图像生成、提示词库和流式响应。

它与 NextChat 的最大区别在于：数据完全存在本地，不依赖任何云服务；且同时提供桌面客户端和移动端，2024 年曾一度闭源，2025 年又重新开源（Community Edition），目前 GPL-3.0 下公开的 Community Edition 代码与 Pro 版定期同步。

解决什么问题

  • 多模型聚合管理：不需要在每个网页端之间切换，一个 App 用完 OpenAI 切 Claude、Ollama
  • 本地数据存储：对话记录、提示词库全部存在设备本地，隐私有保障（特别适合处理敏感业务内容）
  • 团队 API 共享：团队成员可以共享组织的 OpenAI API 资源，降低人均用量成本
  • 无网络延迟体验：流式响应速度快，界面本身轻量，启动快（Electron 架构）

快速安装

桌面客户端下载（推荐）

直接下载对应平台安装包，无需 Node.js 环境：

平台 下载地址
Windows GitHub Releases
macOS（Intel/Apple Silicon） 同上
Linux（AppImage） 同上
Web https://chatboxai.app
iOS App Store 搜索 "Chatbox AI"
Android Google Play 或 APK 直装

⚠️ GitHub Releases 页面会持续更新，版本号请以实际发布页为准（当前 Community Edition 活跃维护中）。

源码构建（开发者）

# 前置要求
# - Node.js v20.x - v22.x
# - pnpm v10.x（通过 corepack 启用）
# - Git

git clone https://github.com/chatboxai/chatbox.git
cd chatbox

# 安装依赖
pnpm install

# 开发模式（热重载）
pnpm run dev

常用 pnpm 脚本：

命令 说明
pnpm run dev 开发模式，热重载
pnpm run package 打包当前平台安装包
pnpm run package:all 打包全平台安装包
pnpm run build 生产构建（不打包）
pnpm run lint 代码质量检查
pnpm run test Vitest 单元测试

⚠️ Windows 用户若在 Git Bash 下 pnpm install 失败，运行 pnpm config set script-shell "C:\\Program Files\\git\\bin\\bash.exe" 后重试。

核心用法

1. 配置 AI 提供方

首次启动后，进入 Settings → AI Providers，添加你的 API Key：

提供方 配置项
OpenAI API Key（支持多 Key 逗号分隔）、Base URL（可选，代理用）
Azure OpenAI 资源 URL、API Key、API Version
Claude（Anthropic） API Key、API Version、Base URL（可选）
Google Gemini API Key
Ollama（本地） Base URL（如 http://localhost:11434），自动读取已下载模型列表

2. 开始对话

配置完成后在主界面选择模型，开始对话。支持流式输出（Streaming Response）。

3. 提示词库（Prompt Library）

  • 在侧边栏 Prompt Library 中保存常用提示词
  • 支持按分类组织，聊天时快速调用
  • 适合将复杂提示词模板化复用

4. 引用消息（Message Quoting）

右键或快捷键引用历史消息，作为上下文延续讨论，适合多轮推理场景。

5. 团队协作（API 共享）

在 Team 标签页配置团队 API 密钥，成员间共享用量：

# 详见团队共享文档
# /chatboxai/chatbox/blob/main/team-sharing/README.md

⚠️ 团队协作功能需要团队管理员配置企业 API 资源，实际配置方式取决于组织使用的计费方案。

6. DALL·E 3 图像生成

在支持的模型下，直接在对话中请求图像生成，结果在对话流中展示（OpenAI 提供方可用）。

典型适用场景

场景 说明
多模型对比评测 同一问题同时问多个模型，对比输出质量
隐私敏感对话 医疗、法律、财务等敏感内容不希望走云端
团队 AI 资源管理 小团队共享一个 API Key，统一记录使用量
本地模型体验 通过 Ollama 调用 Llama、Mistral 等开源模型，无需 GPU
移动端 AI iOS/Android 上随时使用，支持多端数据同步（本地）

坑与注意

  1. Ollama 模型需提前下载：Ollama 支持的模型（llama2、Mistral、Mixtral、codellama 等）需要先通过 ollama pull <model> 下载到本地，Chatbox 只是调用端。

  2. API 费用完全自担：Chatbox 本身免费，但调用任何云端 LLM 都会消耗你的 API 额度，使用前注意用量控制。

  3. 桌面端 Electron 资源占用：相比纯 Web 版本，Electron 桌面端对内存的占用相对较高，老旧设备可优先使用 Web 版。

  4. 团队协作安全性：共享 API Key 意味着所有人都能消耗相同配额，建议在 OpenAI 后台设置用量限制（Usage Limits）。

  5. 中国区访问：如果无法直连 GitHub Releases，可访问 chatboxai.app 的下载页面获取安装包。

  6. 构建全平台包耗时较长：pnpm run package:all 在网络不佳时可能超时，建议单独构建目标平台。

与同类对比

应用 数据存储 多模型 开源 团队协作 移动端
Chatbox 本地 ✅ 主流全覆盖 ✅ GPL-3.0 ✅ ✅ iOS/Android
NextChat 浏览器本地 ✅ 主流全覆盖 ⚠️ 部分开源 ✅ ✅
Claude Desktop Claude 本地 仅 Claude ❌ ❌ ❌
Ollama Web UI 本地 仅 Ollama ✅ ❌ ❌

Chatbox vs NextChat：两者功能高度重叠。Chatbox 的核心优势是完全本地存储（更彻底的隐私保护）和GPL-3.0 完全开源；NextChat 的优势是Vercel 一键部署和更丰富的插件生态。如果你重视数据自主权，选 Chatbox；如果你重视部署便捷性，选 NextChat。

一句话推荐结论

Chatbox 是一个功能完整、完全本地存储、真正开源（GPL-3.0）的跨平台 AI 客户端，适合需要在多模型、团队协作和隐私保护之间取得平衡的个人开发者和小型团队——如果你希望对话数据完全掌握在自己手中，同时又需要灵活切换 ChatGPT/Claude/Ollama 等多个模型，它是目前体验最均衡的免费开源选择。