什么是 Cherry Studio
Cherry Studio 是一款桌面端 AI 助手应用，支持多种 AI 模型。它具有：
- 简洁美观的图形界面
- 支持多个 AI 服务商
- 多会话管理
- 本地数据存储
- 跨平台支持（Windows、macOS、Linux）
Cherry Studio 是桌面应用，比命令行工具更适合普通用户使用。
第一步：下载 Cherry Studio
1.1 访问官网
访问 Cherry Studio 官网 或 GitHub 发布页
1.2 选择对应系统的安装包
根据你的操作系统选择下载：
| 操作系统 | 文件格式 | 说明 |
|---|
| Windows | .exe | 双击安装 |
| macOS (Intel) | .dmg (x64) | 适用于 Intel 芯片的 Mac |
| macOS (Apple Silicon) | .dmg (arm64) | 适用于 M1/M2/M3 芯片的 Mac |
| Linux | .AppImage 或 .deb | 根据发行版选择 |
不确定 Mac 芯片类型？点击左上角苹果图标 → “关于本机”，查看”芯片”或”处理器”信息。
第二步：安装 Cherry Studio
Windows 用户
- 双击下载的
.exe 文件
- 按照安装向导提示操作
- 安装完成后，桌面会出现 Cherry Studio 图标
macOS 用户
- 双击下载的
.dmg 文件
- 将 Cherry Studio 拖拽到”应用程序”文件夹
- 首次打开时，如果提示”无法打开”，按以下步骤操作：
- 打开”系统设置” → “隐私与安全性”
- 找到 Cherry Studio，点击”仍要打开”
Linux 用户
使用 AppImage：
chmod +x Cherry-Studio-*.AppImage
./Cherry-Studio-*.AppImage
sudo dpkg -i cherry-studio_*.deb
第三步：在智牛API创建令牌
好消息： 智牛API服务部署在国内，访问和使用完全不需要魔法，网络连接稳定快速。
3.1 登录智牛API
- 访问 智牛API
- 注册或登录你的账号
3.2 创建新令牌
- 在左侧菜单或顶部导航找到”令牌”选项
- 点击”添加令牌”或”创建新令牌”按钮
- 填写令牌配置信息：
| 配置项 | 说明 | 示例 |
|---|
| 令牌名称 | 给这个令牌起个名字，方便识别 | cherry-studio-token |
| 额度 | 设置令牌的使用额度（可选） | 留空表示无限制 |
| 过期时间 | 令牌的有效期（可选） | 留空表示永不过期 |
| 模型权限 | 选择允许使用的模型 | 勾选 Claude 相关模型 |
3.3 保存并复制令牌
- 点击”提交”或”创建”按钮
- 系统会生成一个令牌（格式类似
sk-xxxxxxxxxxxxx）
- 立即复制这个令牌，它只会显示一次
令牌创建后只显示一次，请务必复制保存。如果丢失，需要删除旧令牌并重新创建。
第四步：配置 Cherry Studio
4.1 打开 Cherry Studio
双击桌面图标或从应用程序列表启动 Cherry Studio。
4.2 添加 AI 服务商
- 点击左下角的”设置”图标（齿轮图标）
- 在左侧菜单选择”模型服务商”或”Providers”
- 点击”添加服务商”或”Add Provider”按钮
4.3 配置智牛API
在添加服务商页面，填写以下信息：
| 配置项 | 填写内容 |
|---|
| 服务商类型 | 选择”OpenAI”或”自定义 OpenAI 兼容” |
| 服务商名称 | 智牛API（可自定义） |
| API Key | 粘贴你在智牛API创建的令牌 |
| API 地址 | https://niuapi.vip/v1 |
Cherry Studio 支持 OpenAI 兼容接口，所以选择 OpenAI 类型即可。
4.4 测试连接
- 填写完成后，点击”测试连接”或”Test”按钮
- 如果显示”连接成功”，说明配置正确
- 点击”保存”或”Save”按钮
第五步：开始使用
5.1 创建新对话
- 点击左上角的”新建对话”或”+“按钮
- 选择你想使用的模型（如 Claude 3.5 Sonnet）
- 开始输入你的问题
5.2 基本功能
| 功能 | 说明 |
|---|
| 多会话管理 | 左侧栏显示所有对话，可随时切换 |
| 重命名对话 | 右键点击对话，选择”重命名” |
| 删除对话 | 右键点击对话，选择”删除” |
| 导出对话 | 右键点击对话，选择”导出” |
| 切换模型 | 对话顶部可切换不同的 AI 模型 |
5.3 使用示例
示例 1：简单问答
你：什么是人工智能？
AI：人工智能（AI）是计算机科学的一个分支...
你：用 Python 写一个计算斐波那契数列的函数
AI：好的，这是一个计算斐波那契数列的函数...
你：把这段话翻译成英文：人工智能正在改变世界
AI：Artificial intelligence is changing the world.
常见问题
1. 提示 “API Key 无效”
原因： API 密钥错误或已过期
解决方法：
- 检查是否正确复制了令牌
- 检查智牛API账户中令牌是否还有额度
- 重新创建令牌并更新配置
2. 提示 “连接失败”
原因： 无法连接到 API 服务
解决方法：
- 检查网络连接是否正常
- 确认 API 地址是否为
https://niuapi.vip/v1
- 检查智牛API服务是否正常运行
3. 找不到想要的模型
原因： 模型未启用或令牌无权限
解决方法：
- 检查智牛API中是否启用了对应的模型
- 检查令牌是否有该模型的使用权限
- 在 Cherry Studio 设置中刷新模型列表
4. macOS 提示”无法打开应用”
原因： 系统安全设置限制
解决方法：
- 打开”系统设置” → “隐私与安全性”
- 找到 Cherry Studio，点击”仍要打开”
- 或在终端执行：
xattr -cr /Applications/Cherry\ Studio.app
5. 对话记录丢失
原因： 数据存储位置变更或损坏
解决方法：
- Cherry Studio 数据存储在本地
- 定期导出重要对话
- 检查应用数据目录是否完整
进阶功能
自定义提示词
- 在设置中找到”提示词”或”Prompts”
- 可以创建常用的提示词模板
- 对话时快速调用
快捷键
| 快捷键 | 功能 |
|---|
Ctrl/Cmd + N | 新建对话 |
Ctrl/Cmd + K | 搜索对话 |
Ctrl/Cmd + , | 打开设置 |
Enter | 发送消息 |
Shift + Enter | 换行 |
主题切换
- 打开设置
- 选择”外观”或”Appearance”
- 切换浅色/深色主题
完成以上步骤后，你就可以开始使用 Cherry Studio 了！
快速回顾：
- ✅ 下载并安装 Cherry Studio
- ✅ 在智牛API创建令牌
- ✅ 配置 Cherry Studio
- ✅ 开始使用
如果遇到问题，可以：
Cherry Studio 会定期更新，建议关注官方发布页获取最新版本。