登录/注册
Cherry Studio 接入教程
推荐工具高级功能更新时间：2025-11-26产品简介
Cherry Studio 是一款功能强大的 AI 桌面客户端，专为开发者和高级用户设计。它不仅支持标准的 AI 对话功能，还提供了多项高级特性：
核心功能
- 🤖 200+ AI 模型支持 - 接入海鲸AI的全部模型库
- 🔧 MCP 服务器集成 - 让 AI 调用各种外部工具和服务
- 📚 本地知识库 - 通过 Embedding API 实现私有数据问答
- 💭 思考模式 - 支持 Qwen3、o1 等推理模型的深度思考
- 🔄 OpenAI API 兼容 - 无缝对接标准接口
- 🖥️ 全平台支持 - Windows、macOS、Linux 桌面应用
适用场景
| 场景 | 说明 | 推荐模型 |
|---|---|---|
| 智能对话 | 日常问答、创作、翻译等 | GPT-4、Claude、Qwen-Plus |
| 工具调用 | 通过 MCP 集成网页抓取、数据库查询等工具 | GPT-4-Turbo、Claude-3-Opus |
| 知识库问答 | 基于私有文档的精准问答 | Qwen-Plus、GPT-3.5-Turbo |
| 深度推理 | 复杂问题的逐步思考分析 | Qwen3-Thinking、o1-preview |
效果展示
以下示例展示了 Cherry Studio 的强大能力：导入限流文档 → 集成网页抓取 MCP 工具 → 探索限流报错的解决方案
功能亮点
- ✅ 自动读取本地文档内容
- ✅ 调用 MCP 工具获取网络数据
- ✅ 结合知识库和实时信息给出解决方案
- ✅ 展示完整的思考推理过程
注意：实际使用时响应速度取决于模型选择和网络状况。
快速开始
前置准备
在开始配置前，请确保：
✅ 安装 Cherry Studio
- 访问 Cherry Studio 官网 下载对应系统的安装包
- 支持 Windows 10+、macOS 11+、Linux 主流发行版
✅ 获取海鲸AI API Key
- 前往海鲸AI控制台注册账号
- 在 API 管理页面生成 API Key
- 确保账户余额充足
✅ 选择合适的模型
- 查看模型列表了解各模型特性
- 根据使用场景选择对应模型
- 确认 API Key 有相应模型的调用权限
配置步骤
1. 添加海鲸AI服务商
- 启动 Cherry Studio，单击右上角的 ⚙️ 设置 按钮
- 在左侧菜单选择 模型服务
- 找到 自定义服务商 或选择 添加新服务商
2. 配置 API 参数
在配置面板中填入以下信息：
| 配置项 | 值 | 说明 |
|---|---|---|
| 服务商名称 | 海鲸AI | 或 HaiJing AI |
| API 类型 | OpenAI 兼容 | 选择 OpenAI Compatible |
| API 地址 | https://api.atalk-ai.com/v2 | 替换为海鲸AI实际 API 地址 |
| API 密钥 | sk-xxxxxxxxxxxxxxxx | 填入您的 API Key |
| 模型 ID | gpt-4.1 | 或其他模型名称 |
推荐模型配置
顶级性能
模型ID: gpt-4.1 名称: GPT-4.1 特点: OpenAI最新旗舰模型，强大的推理和代码能力
多模态专家
模型ID: gemini-2.5-flash
名称: Gemini 2.5 Flash
特点: Google最新模型，速度快、支持超长上下文
编程助手
模型ID: claude-4-sonnet 名称: Claude 4 Sonnet 特点: Anthropic旗舰模型，代码理解和生成能力卓越
查看完整模型列表
3. 验证配置
- 单击 保存 或 测试连接
- 如果配置正确，会显示"连接成功"提示
- 返回主界面，在模型选择器中应该能看到新添加的模型
常见配置错误
- ❌ API 地址末尾不要添加多余的斜杠
- ❌ 确保 API Key 没有多余的空格
- ❌ 模型 ID 必须严格匹配，大小写敏感
使用指南
场景一：简单对话
最基础的使用方式，适合快速测试和日常对话。
操作步骤
- 单击主界面的 💬 新建对话 按钮
- 在模型选择器中选择刚配置的海鲸AI模型（如 `gpt-4.1`）
- 在输入框输入问题，例如："你是谁？"
- 等待模型响应
示例对话
markdown
👤 用户：你是谁？
🤖 AI：我是人工智能助手。我可以帮助您：
- 回答各类问题
- 协助文档撰写和翻译
- 进行代码编写和调试
- 提供创意建议和头脑风暴
有什么我可以帮助您的吗？思考模式切换
对于支持思考的模型（如 `gpt-4.1`），可以通过输入框旁的 🧠 思考 按钮控制是否启用思考模式。开启后，AI 会展示完整的推理过程。
场景二：MCP 工具调用
MCP (Model Context Protocol) 允许 AI 调用外部工具和服务，极大扩展了功能边界。
什么是 MCP？
MCP 是一种标准协议，让 AI 模型能够：
- 🌐 访问网页内容
- 🗄️ 查询数据库
- 📊 读取和分析文件
- 🔧 调用各种 API 和工具
配置 MCP 服务器
- 在 Cherry Studio 设置中找到 MCP 服务器
- 单击 添加服务器
- 选择或配置所需的 MCP 工具，例如：
- 网页抓取工具 - 获取实时网页内容
- 文件系统工具 - 读写本地文件
- 数据库工具 - 查询数据库数据
使用示例
markdown
👤 用户：帮我查询 example.com 的标题和主要内容
🤖 AI：好的，我来使用网页抓取工具获取信息...
[调用 MCP 工具: web-fetch]
URL: https://example.com
Status: 200 OK
📊 查询结果：
标题: Example Domain
主要内容: This domain is for use in illustrative examples...推荐的 MCP 工具
- fetch - 网页内容抓取
- filesystem - 本地文件操作
- sqlite - SQLite 数据库查询
- github - GitHub 仓库访问
- puppeteer - 浏览器自动化
高级功能
思考模式详解
某些模型（如 Qwen3、o1 系列）支持深度思考模式，能展示完整的推理过程。
支持思考的模型
| 模型系列 | 模型 ID | 思考模式 | 说明 |
|---|---|---|---|
| Claude 4 Sonnet | `claude-4-sonnet` | 可选 | 强大的推理和分析能力 |
| Claude 3.7 Sonnet | `claude-3-7-sonnet` | 可选 | 平衡性能与成本 |
| Claude 4.5 Opus | `claude-opus-4.5` | 可选 | 最强推理能力 |
| Claude 3.5 Sonnet | `claude-3-5-sonnet` | 可选 | 快速响应的思考模型 |
如何使用
- 选择支持思考的模型
- 单击输入框旁的 🧠 思考 按钮（如果可切换）
- 提出问题，观察 AI 的推理过程
示例：复杂数学问题
markdown
👤 用户：小明有 15 个苹果，给了小红 1/3，又买了 8 个，
然后和小李平分，小明还剩多少个？
🤖 AI：[思考中...]
💭 思考过程：
1. 首先计算小明给小红的苹果数：15 × 1/3 = 5 个
2. 小明剩余：15 - 5 = 10 个
3. 买了 8 个后：10 + 8 = 18 个
4. 和小李平分：18 ÷ 2 = 9 个
✅ 答案：小明还剩 9 个苹果。多模态能力
部分模型支持图像输入和理解功能。
支持图像的模型
- GPT-4 Vision - `gpt-4-vision-preview`
- Claude 3 系列 - `claude-3-opus`, `claude-3-sonnet`
- 通义千问 VL - `qwen-vl-plus`
使用方法
- 选择支持视觉的模型
- 单击输入框的 📎 附件 按钮
- 上传图片（支持 JPG、PNG、WebP）
- 输入关于图片的问题
常见问题
Q1：如何计费？
海鲸AI采用按 Token 计费模式，输入和输出分别计价。
| 费用项 | 说明 | 优化建议 |
|---|---|---|
| 输入 Token | 发送给 AI 的文本（包括上下文） | 控制历史消息轮数 |
| 输出 Token | AI 生成的回复内容 | 限制最大输出长度 |
| MCP 调用 | 工具调用次数（按调用计费） | 合并相关操作 |
节省成本的技巧：
- 💡 简单任务使用 gpt-4.1-mini（成本低）
- 💡 定期清理无用的对话历史
- 💡 设置合理的 max_tokens 限制
查看详细价格说明
Q2：MCP 工具调用失败怎么办？
常见错误及解决方案
错误 1：MCP server not responding
原因：MCP 服务器未正常启动或连接超时
解决：
- 检查 MCP 服务器状态
- 重启 Cherry Studio
- 检查防火墙设置
- 查看 MCP 服务器日志
错误 2：Tool not authorized
原因：模型没有调用该工具的权限
解决：
- 在 Cherry Studio 设置中启用对应工具
- 确认使用的模型支持 Function Calling
- 检查 API Key 权限
错误 3：Tool execution timeout
原因：工具执行时间过长
解决：
- 增加超时设置（设置 → MCP → 超时时间）
- 优化工具执行逻辑
- 使用更快的 MCP 实现
相关资源
推荐阅读
最佳实践
性能优化
模型选择策略
简单任务 → gpt-4.1-mini (快速、便宜) 复杂任务 → gpt-4.1 (质量高) 中文任务 → DeepSeek-V3 (中文优化) 推理任务 → qwen-plus (展示思考)上下文管理
- 保持对话历史在 10 轮以内
- 使用知识库而非长上下文
- 及时清理无关对话
MCP 工具使用
- 合并相关操作减少调用次数
- 缓存常用数据
- 设置合理的超时时间
安全建议
安全提示
- 🔒 API Key 切勿泄露给他人
- 🔒 定期轮换 API Key
- 🔒 监控异常调用行为