AI 实战课 · 共 12 节

从零打造 AI 应用:完整实战课程

一休 · 主讲 4.5 小时 12,846 人在学 4.9 (328) 最近更新 2026-11-15
课程目录位置
第 3/12 节

Cherry Studio 本地部署与模型接入

◷ 18:24 ◉ 8.2万次观看 ◈ 更新于 2026-11-15 #AI工具#效率
本节 AI 摘要

本节课带你从零完成 Cherry Studio 的安装与配置,重点讲解如何接入第三方大模型 API、管理多个模型服务商,以及常见连接失败的排查方法。学完后你能把 Cherry Studio 变成自己的统一 AI 工作台。

Cherry Studio 是一款支持多模型的桌面客户端,能把不同的大模型服务商统一管理在一个界面里。这节课我们先完成本地安装,再配置第一个模型接口。

💡
开始之前

请提前准备好一个模型 API Key(OpenAI 或任意兼容接口)。没有的话可以先跳过 API 配置,跟着课程用免费模型体验。

一、下载与安装

打开官网下载对应系统的安装包,Windows 用户直接双击 .exe 完成安装。首次启动后,界面左侧是会话列表,右侧是设置入口。

二、配置模型接口

进入「设置 → 模型服务」,选择服务商类型后填入 API Key 和接口地址。不同系统的入口略有差别,按你的系统查看:

点击左下角齿轮图标进入设置,在「模型服务」中点击添加,选择 OpenAI Compatible,填入接口地址和密钥后点击「检查连通性」,显示成功后保存。

点击菜单栏 Cherry Studio → Preferences,切换到 Model 标签页,其余步骤与 Windows 一致。注意 macOS 首次启动需要在「安全性与隐私」里允许运行。

解压 AppImage 后赋予执行权限再运行。配置界面与 Windows 相同,若遇到无法启动,检查是否缺少 libwebkit2gtk 依赖。

三、常见问题

接口返回 401 / 鉴权失败怎么办?›

先确认 API Key 是否复制完整(注意末尾多余空格),再检查接口的 Base URL 是否需要带 /v1 后缀。多数兼容接口要求完整的版本路径。

能连通但没有模型列表›

在模型服务设置里手动点击「获取模型列表」,如果接口不提供列表接口,需要手动填写模型 ID(如 gpt-4o-mini)。

streaming 输出卡顿›

在设置中关闭「流式输出」测试,若恢复正常说明是接口流式响应格式不标准,建议更换兼容接口。

配置完成后,回到主界面新建一个会话,选中刚加的模型发一条消息测试。能正常回复,说明你的统一 AI 工作台已经搭好了——下一节我们在此基础上搭建第一个可用的 AI 助手。

本节课资料
PDF
第3节 · Cherry Studio 配置图文讲义.pdf
2.4 MB
下载 ↓
JSON
模型配置文件模板.json
3 KB
下载 ↓

评论

有疑问、勘误或想聊的,欢迎在下面留言

不填则显示为「匿名访客」
0 / 500