从零开始：跨平台AI客户端Cherry Studio的完整安装指南

Cherry Studio是一款功能强大的跨平台AI桌面客户端，支持接入OpenAI、Gemini、Anthropic等主流大语言模型，同时兼容Ollama、LM Studio等本地模型部署方案。无论你是技术新手还是AI爱好者，都能通过这款集成了300+预置AI助手、多模型并行对话、文档处理等丰富功能的桌面应用，轻松开启智能工作流。

一、了解Cherry Studio的核心功能

Cherry Studio作为一站式AI交互平台，主要特点包括：

• 多模型支持：同时兼容云端API和本地部署模型
• 丰富预置助手：300+场景化AI助手即开即用
• 文档全格式处理：支持文本、图片、PDF等多种文件分析
• 跨平台兼容：完美运行于Windows、macOS和Linux系统
• 个性化定制：主题切换、快捷键配置和数据存储选项

二、准备工作：获取安装包与环境检查

2.1 选择适合的安装包版本

根据你的操作系统选择对应的安装包格式：

操作系统	推荐安装包格式	系统要求
Windows	.exe	Windows 10及以上，64位系统
macOS	.dmg	macOS 12.0或更高版本
Linux	.AppImage 或 .deb	支持主流Linux发行版

2.2 系统环境检查要点

• 存储空间：至少预留2GB可用空间
• 网络连接：确保稳定网络以获取必要组件
• 权限要求：安装过程可能需要管理员权限

2.3 依赖组件准备

Windows用户：

• 需安装WebView2运行时环境（首次启动时会自动提示安装）

Linux用户（Debian/Ubuntu）：

# 安装基础依赖库
sudo apt update
sudo apt install libgtk-3-0 libnotify4 libnss3 libxss1 libxtst6 xdg-utils

三、分系统安装步骤

3.1 Windows系统安装

1. 双击下载的.exe安装文件
2. 在弹出的安装向导中点击"下一步"
3. 接受许可协议并选择安装路径
4. 点击"安装"按钮等待完成
5. 勾选"创建桌面快捷方式"，点击"完成"

首次启动时若提示安装WebView2组件，请按提示完成安装

3.2 macOS系统安装

方法一：手动安装

1. 双击.dmg文件挂载安装镜像
2. 将Cherry Studio拖拽到Applications文件夹
3. 从启动台或应用文件夹启动应用

方法二：Homebrew安装

# 通过Homebrew快速安装
brew install --cask cherry-studio

首次运行时，需在"系统设置-隐私与安全性"中允许应用运行

3.3 Linux系统安装

AppImage方式：

# 添加可执行权限
chmod +x Cherry-Studio-*.AppImage

# 运行应用
./Cherry-Studio-*.AppImage

Debian/Ubuntu (.deb)方式：

# 安装deb包
sudo dpkg -i cherry-studio_*.deb

# 若出现依赖问题，执行：
sudo apt install -f

四、首次启动配置指南

4.1 初始设置流程

1. 语言选择：首次启动时选择界面语言（支持中文、英文等）
2. 用户协议：阅读并同意用户许可协议
3. 数据收集：选择是否参与匿名使用数据收集

4.2 基础功能配置

Cherry Studio消息处理流程示意图，展示了从网络搜索、知识库查询到模型处理的完整路径

4.2.1 AI模型配置

1. 在左侧导航栏选择"设置" > "模型管理"
2. 点击"添加模型"按钮
3. 选择模型类型（如OpenAI、Gemini等）
4. 输入API密钥或配置本地模型路径
5. 点击"测试连接"验证配置是否成功

4.2.2 数据存储设置

1. 进入"设置" > "数据管理"
2. 选择数据存储位置（默认或自定义路径）
3. 配置自动备份选项（可选）
4. 设置云同步服务（WebDAV/S3，可选）

五、从源码构建安装（开发者选项）

如果你希望获取最新开发版本或进行二次开发，可以从源码构建：

# 克隆代码仓库
git clone https://gitcode.com/CherryHQ/cherry-studio

# 进入项目目录
cd cherry-studio

# 安装依赖
pnpm install

# 构建应用
pnpm run build

# 运行开发版本
pnpm run dev

六、常见问题解决

Q：安装后无法启动怎么办？

A：首先检查系统是否满足最低要求，Windows用户确保已安装WebView2组件。若问题持续，尝试以管理员身份运行或重新下载安装包。

Q：如何更新Cherry Studio到最新版本？

A：应用内置自动更新功能，会在启动时检查更新。也可以从官网下载最新安装包进行覆盖安装。

Q：添加模型后无法正常使用是什么原因？

A：检查API密钥是否正确，网络连接是否正常，防火墙是否阻止了应用访问网络。对于本地模型，确认模型文件路径配置正确且模型已下载完成。

Q：如何导入/导出我的配置和数据？

A：在"设置" > "数据管理"中，使用"导出配置"和"导入配置"功能可以备份和恢复你的设置。数据备份可通过配置云存储自动完成。

七、开始使用Cherry Studio

完成安装配置后，你可以开始探索Cherry Studio的强大功能：

• 多模型对话：在聊天界面切换不同AI模型进行对话
• 文档处理：通过"文件"菜单上传文档进行分析
• AI助手：在"助手"面板选择预置助手快速启动特定任务
• 快捷键：使用Ctrl+N新建对话，Ctrl+F搜索历史记录

通过以上步骤，你已经成功安装并配置好了Cherry Studio。这款强大的AI桌面客户端将为你的工作和学习提供全方位的智能辅助支持。