跳到主要内容

Cherry Studio 使用指南

Cherry Studio 是一款跨平台的 AI 桌面客户端，支持多模型对话、知识库、工作流等功能。本指南介绍如何将 Cherry Studio 接入 OPEAI Platform。

安装 Cherry Studio​

访问 Cherry Studio 官网 下载对应平台的客户端。

支持平台：

  • macOS (Apple Silicon / Intel)
  • Windows
  • Linux

配置 OPEAI Platform​

1. 打开设置​

启动 Cherry Studio 后，进入 设置 → 模型服务。

2. 添加 Provider​

点击 添加 按钮，创建新的 API Provider。

3. 输入配置信息​

配置参数​

配置项值
名称OPEAI
API 类型OpenAI
API 地址https://api-platform.ope.ai/v1
API Key您的 OPEAI API Key

添加模型​

手动添加以下模型 ID（每行一个）：

Claude-4.6-Sonnet
Claude-4.6-Opus
Claude-4.5-Haiku
GPT-5.4-Pro
GPT-5.4
GPT-5.3-Codex
DeepSeek-V3.2
DeepSeek-V3.2-thinking
Gemini-3-Pro
Gemini-3-Flash
Qwen3-235B-A22B
Kimi-K2-Instruct-0905
信息

OPEAI Platform 使用 OpenAI 兼容协议，支持所有模型。

4. 保存配置​

输入完成后点击 保存，Cherry Studio 会自动验证连接。

推荐模型​

应用场景推荐模型特性说明
日常编程与写作Claude-4.6-Sonnet综合能力强，响应快，性价比高
复杂推理任务Claude-4.6-Opus顶级推理能力，适合架构设计
快速问答Claude-4.5-Haiku极速响应，成本低
超长上下文GPT-5.4-Pro1M 上下文，适合分析长文档
代码生成GPT-5.3-Codex针对编程场景优化
成本优化DeepSeek-V3.2极低成本，高频调用首选
深度思考DeepSeek-V3.2-thinking支持思维链推理

完整模型列表和价格请查看 模型价格说明。

使用技巧​

多模型对比​

Cherry Studio 支持让多个模型同时回答同一个问题，非常适合对比不同模型的输出质量：

  1. 在对话界面选择多个模型（按住 Cmd/Ctrl 多选）
  2. 发送问题
  3. 查看并对比各个模型的回答

推荐对比组合：

  • 速度 vs 质量：Claude-4.5-Haiku vs Claude-4.6-Opus
  • 不同厂商：Claude-4.6-Sonnet vs GPT-5.4 vs Gemini-3-Pro
  • 成本对比：DeepSeek-V3.2 vs Claude-4.6-Sonnet

知识库功能（RAG）​

结合 Cherry Studio 的知识库功能，可以实现基于私有文档的问答：

  1. 创建知识库并上传文档（PDF、Word、Markdown 等）
  2. 在对话中启用知识库
  3. 模型会基于您的文档回答问题
信息

Cherry Studio 的知识库功能需要使用 Embeddings API。OPEAI Platform 支持向量模型 bge-m3。

在配置 Provider 时，确保 API 地址为 https://api-platform.ope.ai/v1，Cherry Studio 会自动调用 embeddings 接口。

工作流模式​

Cherry Studio 的工作流功能可以创建多步骤 AI 任务流：

  1. 在 工作流 标签页创建新工作流
  2. 拖拽添加节点（LLM 调用、条件判断、数据处理等）
  3. 配置每个节点使用的模型
  4. 保存并运行工作流

应用场景：

  • 代码审查 → Bug 修复 → 单元测试生成
  • 需求分析 → 架构设计 → 代码实现
  • 长文翻译 → 润色 → 格式化

常见问题​

模型列表不会自动加载​

Cherry Studio 需要手动添加模型名称。请参考上方的 添加模型 部分，复制完整的模型 ID 列表。

图像分析功能无法使用​

确认您选择的模型支持视觉功能（Vision），推荐使用：

  • Gemini-3-Pro
  • Gemini-3-Flash
  • Qwen2.5-VL-32B-Instruct

在 Provider 配置中确保 API 地址正确：https://api-platform.ope.ai/v1

认证失败​

  • 确认 API Key 格式正确（以 sk- 开头）
  • 登录 OPEAI Platform 控制台 确认 Key 有效
  • 检查 API 地址是否输入正确

知识库向量化失败​

  • 确认在 设置 → 模型服务 中添加了 Provider
  • API 地址必须为 https://api-platform.ope.ai/v1
  • Embeddings 模型会自动调用，无需手动配置

响应速度慢​

  • 尝试切换到更快的模型（如 Claude-4.5-Haiku、Gemini-3-Flash）
  • 检查网络连接，确认能访问 https://api-platform.ope.ai
  • 避免在高峰时段使用超大上下文