如何 10 分钟在桌面跑起 Cherry Studio AI 聊天客户端:完整安装指南 📅 发布时间:2026/8/31 13:36:16 👁 浏览次数: 如何 10 分钟在桌面跑起 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在好几个 AI 模型的网页之间来回切换、再逐个管理它们的 API Key是不是挺烦的Cherry Studio 把 OpenAI、Claude、Gemini 等主流云服务和本地模型统一进一个桌面客户端还内置了 300 个 AI 助手。这份 Cherry Studio 安装教程带你从零把它装进自己的电脑。快速上手4 条命令跑起来 Cherry Studio如果你只想先看到效果按这个顺序敲就行3 分钟内能启动 git clone https://gitcode.com/GitHub_Trending/ch/cherry-studio cd cherry-studio corepack enable pnpm install pnpm devcorepack enable的作用是把 pnpm 这个包管理器打开开关它随 Node.js 自带不用单独安装。最后一条命令启动后应用窗口弹出来快速上手就结束了。这是个什么项目Cherry Studio 是一款跨平台的 AI 生产力桌面应用支持 Windows、macOS 和 Linux。它的核心是智能聊天和自主 Agent你在同一个界面上统一访问 300 多款大模型服务和 AI 助手云端模型OpenAI、Anthropic、Google 等和本地模型Ollama、LM Studio都能接进来。从结构上看界面Renderer和后台Main是两个进程你的消息从聊天框出发穿过 IPC 通道交给 AI 核心处理回答再流式传回界面显示。这就是上面那张图想表达的事。技术栈一览每个名词一句话讲明白Electron让网页技术变成桌面应用的框架Cherry Studio 本质是一个能装进系统托盘的浏览器壳子。React拼界面的前端库聊天窗口、侧边栏、模型选择器都是它组装出来的。TypeScript加了静态类型的 JavaScript相当于给代码装了拼写检查很多错误在运行前就被拦住。Viteelectron-vite构建工具开发时改一行代码、界面秒级热更新体验很顺。Drizzle ORM SQLite本地数据库方案你的对话记录、助手配置都保存在自己电脑上。Mermaid把一段文本直接画成流程图的工具Cherry Studio 的图表渲染就靠它。详细安装步骤从环境检查到启动即使你从没用过命令行照着这个顺序走就行。每一步只给一条主命令。1. 检查 Node.js 和 Git 版本先确认两样东西都装好了node -vCherry Studio 要求 Node.js 24精确范围是24.11.1 24.16.0。版本不对可以用 nvm 或 fnm 这类版本管理器装一下nvm install 24。Git 用来拉取代码git --version有输出版本号即可。2. 克隆 Cherry Studio 仓库git clone https://gitcode.com/GitHub_Trending/ch/cherry-studio代码会放进cherry-studio文件夹后面的命令都在这个目录里执行。3. 用 pnpm 安装依赖项目锁定使用 pnpm比 npm 装得快、占盘小Node.js 自带无需另装corepack enable pnpm install如果你习惯 npm这里就不必硬换了——项目依赖是用 pnpm 管理的混用容易出奇怪的版本问题。4. 配置并启动把示例环境配置复制成真实配置然后启动cp .env.example .env pnpm devpnpm dev会自动完成三件事重建 better-sqlite3 这个原生模块、下载所需的本地二进制文件、拉起应用。窗口弹出来打开 Cherry Studio 安装教程这一步就算通关了。5. 可选构建一个安装包想打包出可分发的版本而不是开发态运行pnpm build它会先做全量类型检查再编译产物之后可按平台用pnpm build:win、pnpm build:mac、pnpm build:linux出对应安装包。常见坑与解决 ⚠️坑 1Node 版本不匹配装依赖直接被拒。报错里如果提到 engines 或版本约束就是 Node 版本超出24.11.1 ~ 24.16.0这个范围。用nvm install 24切到 24.x 再装。坑 2better-sqlite3 原生模块构建失败。这个模块需要按你的 Electron 版本重新编译。pnpm dev通常会代劳失败时手动跑一次pnpm rebuild:electron若仍报错先装系统构建工具Windows 装 Visual Studio Build ToolsmacOS 运行xcode-select --install。坑 3Windows 克隆时报符号链接错误。项目用到了符号链接Windows 默认不放开。去系统设置 → 更新和安全 → 开发人员选项打开开发者模式然后执行git config --global core.symlinks true再重新克隆即可。接下来去哪深入装好并跑起来之后先打开 Cherry Studio 配置第一个模型发一句你好验证全链路。想理解更多内部设计可以直接读 官方文档 和这份 开发环境指南遇到问题也可以到项目社区里提问。祝你用得顺手 【免费下载链接】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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考