Skip to content

Cherry Studio

Cherry Studio 是一款开源跨平台桌面 AI 对话客户端,支持同时接多个 LLM provider,内置知识库、Artifacts、Agent 等功能。

接入步骤

  1. 打开 Cherry Studio → 左下角「设置」(齿轮图标)

  2. 模型服务」→ 找「OpenAI」(或「+ 添加」自定义)

  3. 填以下字段:

    字段
    API 地址https://s1.why01.top
    API Key你的 sk-xxxxxxxx
    (部分版本)路径前缀/v1/chat/completions(默认即可)
  4. 点「检查」按钮 → 显示「连接成功」即通

  5. 模型」标签页 → 「+ 添加」→ 填模型名(如 gpt-5-mini / claude-sonnet-4-6 / gemini-2.5-pro),按需添加多个

添加 Claude / Gemini 模型类型

如果想在 Cherry Studio 里直接调 Claude 或 Gemini 系列模型(不走 OpenAI 兼容路径),添加 provider 时把「类型」选成对应协议:

Claude(Anthropic 协议)

模型服务里类型选 Claude

Cherry Studio 选 Claude 类型

填 API 地址 + Key(API 地址用 https://s1.why01.top不带 /v1):

Cherry Studio Claude API 配置

Gemini(Google 协议)

类型选 Gemini

Cherry Studio 选 Gemini 类型

填 API 地址 + Key:

Cherry Studio Gemini API 配置

切模型

主对话窗口顶部模型下拉框 → 选刚才添加的模型。一个对话可以中途换模型(接续上下文)。

多 provider 共存

Cherry Studio 支持同时配置多个 provider。建议把 why01 命名清晰,比如把这个 provider 命名为 why01-中转,方便和你可能有的 Ollama / 其他 provider 区分。

常见问题

「连接失败」/ 显示 401

  • 检查 Key 拼写(前后空格、漏字符)
  • 确认 Key 在控制台「令牌管理」是「已启用」状态、未过期
  • 重新创建一个 Key 替换试试

添加模型后调用 404

  • 模型名拼写错(注意大小写、版本后缀),按 控制台模型页 实际可用名填
  • 你所在用户组没有该模型权限,联系客服询问

如何用流式输出

Cherry Studio 默认开启流式。无需特殊配置。

推荐打开的功能

  • 多模态」开关(如果你的模型支持视觉)
  • 温度」按场景调(写代码 0.3,写文案 0.7-1.0)
  • 最大 token」按需求设上限,避免单次回答太长多烧 token