Cherry Studio 使用指南

Cherry Studio 是跨平台桌面 AI 客户端。它的优势不在“终端自动化”，而在于：多模型、多会话、图形化、开箱即用。如果你不想把日常使用建立在 CLI 上，它通常是最容易落地的一类工具。

适合谁

• 不想长期使用终端
• 需要同时管理多个模型和多个会话
• 想接入 OpenAI、Anthropic、Gemini 或自定义兼容服务

官方定位

根据官方 GitHub README，Cherry Studio 支持：

• Windows / macOS / Linux
• 多家 LLM provider
• 本地模型与云模型混用
• 会话管理、搜索、Markdown 渲染、MCP 等扩展能力

安装

Windows

从官方发布页下载对应安装包，常见是 .exe。

macOS

从官方发布页下载对应的 macOS 安装包，拖入 Applications 即可。

Linux

官方通常提供多种包型，常见包括：

• .deb
• .rpm
• AppImage

如果你只是先试用，AppImage 往往最省事；如果你要长期维护，优先用本发行版匹配的包格式。

首次使用

安装完成后，先进入设置页，再配置模型服务。

官方文档里和配置最相关的两个点是：

• API Key
• API Address

Cherry Studio 对“多 Key 轮询”和“自定义 API 地址”支持都比较直接，这也是它适合接第三方兼容服务的原因。

接入 Flash API / 自定义提供商

Cherry Studio 对这类接入支持比较直接。

基本思路

1. 打开 设置
2. 进入 Model Services
3. 添加一个自定义 provider，或者改写已有 provider 的 API Address
4. 填入 API Key
5. 拉取或手动添加模型
6. 做连通性检测

推荐填写方式

• 名称：Flash API
• 提供商类型：New API 或 OpenAI Compatible
• API Key：你的 Flash API Key
• API Address：https://ai.flashapi.top/v1/

关于 API Address 的填写

Cherry Studio 官方文档强调了一点：

• 如果服务商文档给的是 https://xxx.xxx.com/v1/chat/completions
• 在很多场景下，你只需要填写根地址部分
• Cherry Studio 会自动拼接剩余路径

如果服务商走的是非标准路由，官方文档还提供了用 # 结尾避免自动拼接的方式。

这意味着：在接入兼容 API 时，地址一定要严格按服务商说明填写，不要凭经验随便补 /v1、/chat/completions。

对于 Flash API，最常见的填写方式就是：

https://ai.flashapi.top/v1/

推荐先添加这些模型

• claude-sonnet-4-6
• claude-opus-4-6
• gpt-5.2
• gpt-5.2-codex
• gemini-2.5-pro

你可以先加这几个常用模型，后续再按需要补充。

添加模型

Cherry Studio 支持通过管理界面自动获取模型列表，也支持手动添加。实际建议是：

• 能自动获取就先自动获取
• 只把你真正会用的模型加进来

模型太多会让选择器变得嘈杂。

常见工作流

多会话管理

Cherry Studio 很适合把不同任务拆到不同对话里：

• 一个对话专门写代码
• 一个对话专门读文档
• 一个对话专门做翻译或整理

多模型对比

如果你同时接了多个 provider，它适合做“同一个问题，换几个模型看看”的工作流。

非技术同事使用

如果团队里有人不愿意接触终端，Cherry Studio 往往比 CLI 更容易推广。

macOS / Windows / Linux 的差异建议

macOS

• 桌面体验通常比较完整。
• 适合个人长期日常使用。

Windows

• 对不使用终端的用户最友好。
• 如果你只想“打开就用”，Windows 桌面端通常最容易接受。

Linux

• 更适合已经习惯 Linux 桌面的用户。
• 如果你长期跑 Wayland / X11 桌面环境，建议选择与发行版更匹配的安装包。

使用建议

先把 Provider 配对好，再谈提示词

很多问题并不是提示词造成的，而是模型、地址或 provider 设置不对。

控制模型数量

把“日常主力模型 + 备用模型”保持在少量几个，比一次性塞几十个模型更实用。

多 Key 轮询要谨慎

Cherry Studio 支持一个 provider 配多个 Key 并轮询，但你需要自己清楚这些 Key 对应的额度、限制和用途，避免混用。

常见问题

测试连接失败

优先检查：

• API Address 是否写成了 https://ai.flashapi.top/v1/
• Key 是否可用
• 模型 ID 是否填写正确
• 是否误把需要根地址的字段写成了完整接口路径，或反过来

官方链接

• 官方仓库：https://github.com/CherryHQ/cherry-studio
• 官方文档：https://docs.cherry-ai.com/
• Provider 设置说明：https://docs.cherry-ai.com/en-us/pre-basic/settings/providers
• 自定义 Provider：https://docs.cherry-ai.com/docs/en-us/pre-basic/providers/zi-ding-yi-fu-wu-shang