Cherry Studio 客户端 API 使用教程

本教程详细介绍如何在 Cherry Studio 中配置和使用各类 API 服务，帮助您快速上手这款强大的 AI 客户端工具。

🌟 软件介绍

Cherry Studio 是一款支持多个大语言模型（LLM）服务商的桌面客户端，兼容 Windows、Mac 和 Linux 系统。

✨ 主要特性

🌐 多样化 LLM 服务支持

☁️ 支持主流 LLM 云服务：OpenAI、Gemini、Anthropic、硅基流动等
🔗 集成流行 AI Web 服务：Claude、Peplexity、Poe、腾讯元宝、知乎直答等
💻 支持 Ollama、LM Studio 本地模型部署

🤖 智能助手与对话

📚 内置 300+ 预配置 AI 助手
🤖 支持自定义创建专属助手
💬 多模型同时对话，获得多样化观点

📄 文档与数据处理

📄 支持文本、图片、Office、PDF 等多种格式
☁️ WebDAV 文件管理与数据备份
📊 Mermaid 图表可视化
💻 代码高亮显示

🛠️ 实用工具集成

🔍 全局搜索功能
📝 话题管理系统
🔤 AI 驱动的翻译功能
🎯 拖拽排序
🔌 小程序支持
⚙️ MCP(模型上下文协议) 服务

🎨 优质使用体验

🖥️ Windows、Mac、Linux 跨平台支持
📦 开箱即用，无需配置环境
🎨 支持明暗主题与透明窗口
📝 完整的 Markdown 渲染
🤲 便捷的内容分享功能

📥 下载与安装

系统要求

✅ Windows 10/11 (64 位)
✅ macOS 10.15+
✅ Ubuntu 20.04+

下载地址

🔗 官方下载：https://github.com/CherryHQ/cherry-studio

安装步骤

📦 下载对应系统的安装包
🖱️ 双击运行安装程序
✔️ 按照提示完成安装

⚙️ 初始配置

首次启动

打开 Cherry Studio 后，您会看到类似的初始界面：

初始界面

🔑 API 配置（重要）

⭐ 注意：API 配置是使用 Cherry Studio 的关键步骤，正确的设置将确保您能够顺利使用各种 AI 模型。

进入 API 设置页面

点击左侧菜单的 设置 图标
选择 添加 选项，添加提供商
在右侧窗口将显示 API 配置界面

API配置界面截图

填写 API 信息

在配置页面中，您需要填写以下关键信息：

配置项	示例值	说明
🔗 API 地址	`https://api.cube004.com`	API 服务器地址，必须包含完整的 URL
🔑 API 密钥	当然是找站长要啊，难道这里有？	访问 API 的授权密钥，请妥善保管
🤖 默认模型	`claude-opus-4-20250514`	设置为默认使用的 AI 模型

API配置详情

模型配置

模型添加步骤：

初次配置时，模型列表为空
点击 添加模型 按钮
在弹出的对话框中输入 claude-opus-4-20250514
点击确认完成添加

💡 提示： claude-opus-4-20250514 (简称 Claude-4o) 是目前性能最佳的 AI 模型，建议优先使用。其他模型可在 https://api.cube004.com 的”模型定价”部分查看，但请注意部分模型可能处于维护状态。

验证 API 连接

完成 API 信息填写后，必须验证连接是否正常：

点击 API 密钥右边中的 检测 按钮
选择刚刚添加的模型
系统将自动尝试连接 API 服务器
等待几秒钟，查看测试结果

测试结果说明：

✅ 成功：系统显示 “连接成功！” 的绿色提示
- 此时 API 配置完成，可以开始使用 AI 功能
- 建议创建一个简单测试对话，确认响应正常
❌ 失败：系统显示错误信息
- 检查 API 地址是否输入正确（包括 https:// 前缀）
- 验证 API 密钥是否有效（复制粘贴时注意不要有多余空格）
- 确认网络连接正常，可访问外部服务
- 如问题持续，联系管理员获取支持

💡 基础使用

基本操作

发送消息

📝 在输入框输入内容
⏎ 按 Enter 发送（Shift+Enter 换行）

快捷功能

📎 附件：上传图片或文档（也可以直接拖进去）
📤 ctrl+N 新建话题

🚀 高级功能

🎯 模型切换

在对话框顶部可以快速切换模型：
模型切换

🎨 主题定制

🌙 切换深色/浅色模式
🎨 也可以去 Cherry Studio 主题库 https://cherrycss.com/ 查看

🛠️ 实用技巧

智能体

智能体的选择根据你当前使用场景进行选择即可

智能体

话题总结命名

话题命名

一般来说可以选择一些轻量的模型，没必要选择好的模型，如果不设置这个，每次产生的聊天框那里只会是默认话题，当会话窗口比较多的时候，不好辨认这个窗口之前的聊天内容以及作用

❓ 常见问题

Q1: API 连接失败怎么办？

🔧 解决方案：

检查 API 密钥是否正确
确认网络连接正常
验证 API 地址无误
找站主
可能在维护

Q2: 对话内容会被保存吗？

🔒 隐私说明：

本地对话历史加密存储
API 请求使用 HTTPS 加密
可随时清除所有数据

📞 获取帮助

cherry Studio 官方文档，如果有需要了解的可以去看看

📖 文档：docs.cherryai.com

💭 题外话

🌟 站长，你的 api 不用钱吗？

目前是用爱发电，成本在服务器和域名，以及人工，后续看站主钱包

💡 这个 AI 能用到什么时候？

目前来说，是比较稳定，一般月底会有一段时间维护，具体时间等通知

更新日志

最后更新：2025 年 8 月 24 日