Cherry Studio 安装与配置完整指南：从零跑通这个 AI 聊天桌面客户端-酒店常州论坛

Cherry Studio 安装与配置完整指南：从零跑通这个 AI 聊天桌面客户端

【免费下载链接】cherry-studioAI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs项目地址: https://gitcode.com/GitHub_Trending/ch/cherry-studio

Cherry Studio 是一款支持 300+ 个 AI 助手的跨平台 AI 生产力桌面应用，OpenAI、Gemini、Anthropic 等云端模型和 Ollama、LM Studio 本地模型都能接进来。这篇文章带你在一台干净的机器上把源码装好并启动它，只需要最基本的命令行操作。

Cherry Studio 使用场景：它上手就能干的三件事

多模型对比：同一个问题同时发给多个模型，并排对比输出，帮你快速判断哪个模型适合手头的任务。
本地模型更省心：电脑上跑着 Ollama 或 LM Studio 的话，直接指向它，提示词和文件都不用离开本机。
不只是聊天框：PDF、Office 文档、图片可以直接丢进去问答，还内置了翻译和 Mermaid 图表渲染。

技术上只说一句：它是 Electron + React + TypeScript 构建的桌面应用，装好 Node.js 就能编译运行。

Cherry Studio 安装前环境自检：先备齐这 3 样

对照下面清单检查一遍，缺哪个补哪个。

依赖	版本建议	说明
Node.js	24.11.1（项目锁定在 24.11.1 ~ 24.15 之间）	编译工具链
pnpm	11.8.0	装依赖用，corepack 自动管理版本
Git	任意较新版本	拉取仓库

项目是 pnpm monorepo，所以本文只走 pnpm 这条路；你习惯 npm 或 yarn 也可以了解，但这里不展开。
版本管理推荐用 nvm（fnm 也行），下一步就要用到。
如果你是 Windows，还需要提前开启"开发者模式"，因为仓库里用了符号链接，详见 docs/contrib/development.md。

Cherry Studio 开发环境搭建：六条命令跑起来

把仓库拉到本地

先拿到源码，后面所有命令都在这个目录里执行。

git clone https://gitcode.com/GitHub_Trending/ch/cherry-studio cd cherry-studio

执行后当前目录下能看到package.json、electron.vite.config.ts等文件，说明仓库完整。

切到 Node.js 24.11.1

项目把版本写死在.node-version文件里，Node 版本不对，后面的原生模块会编译失败。

nvm install nvm use 24.11.1

nvm use执行完，终端会提示Running node v24.11.1。

用 corepack 启用 pnpm

package.json里锁定了 pnpm 11.8.0，开启 corepack 后它会自动下载对应版本，不用手动装。

corepack enable

执行pnpm -v能看到版本号，说明已生效。

安装项目依赖

pnpm install

这一步耗时最长，几分钟正常。执行完会滚动安装进度，最后打印Done。

创建本地配置文件

把模板复制成.env，以后你的模型 API Key 就填在这里。

cp .env.example .env

启动开发服务

pnpm dev

首次启动会自动下载辅助二进制文件，稍慢属正常现象。完成后会弹出 Cherry Studio 的桌面窗口，且本地数据目录带Dev后缀，不会和正式安装的版本混在一起。

Cherry Studio 首次启动成功标志与新手常踩的 3 个坑

✅成功标志：Electron 窗口打开，看到 Cherry Studio 的界面。进设置页添加一个服务商、填上 API Key，就能发出第一条消息。

⚠️常见的坑：

better-sqlite3 等原生模块报编译错误：几乎都是 Node 版本不对。重新执行nvm use 24.11.1，再跑一次pnpm install。
Windows 克隆时符号链接报错：开启开发者模式并执行git config --global core.symlinks true，然后重新克隆。
pnpm dev长时间卡住：首次启动在下载二进制，网络差会卡在进度上。耐心等，或手动执行node scripts/download-binaries.js再启动。

绕过这三个坑之后，日常开发基本不会再报环境类错误。

写在最后

clone、切版本、装依赖、启动，六条命令之后你桌面就多了一个可以接任意大模型的 AI 聊天客户端。想继续深入，可以读 docs/contrib/development.md 里的完整开发约定，或翻翻 docs/ 下的架构文档。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析