Cherry Studio 安装配置指南

本教程教你如何在 Cherry Studio 中配置本站的 API，实现模型调用。

第一部分：安装 Cherry Studio

下载地址

支持 Windows、macOS、Linux 三平台。下载对应系统的安装包，安装即可。

第二部分：配置 API

准备工作

你需要一个本站的 API Key。在本站控制台的令牌页面创建 API Key（以 sk- 开头）。

配置步骤

第一步：进入模型服务商设置

打开 Cherry Studio，点击左侧边栏的 设置图标（齿轮），找到 模型服务 或点击顶部的 服务商管理。

点击 + 添加一个新的服务商，名称可以填 huanyu 或任意你喜欢的名字。

第二步：填写 API 密钥

在 API 密钥 输入框中，填入你的 API Key：

sk-xxxxxxxxxxxxxxxxxxxxxxxx

多个密钥使用逗号分隔。填完后可以点击检测按钮验证密钥是否有效。

第三步：填写 API 地址

在 API 地址 输入框中，填入：

https://api.huanyuf.top

预览地址会自动显示为：https://api.huanyuf.top/v1/chat/completions

第四步：获取模型列表

点击 获取模型列表 按钮，Cherry Studio 会自动从 API 拉取所有可用模型。

获取成功后，你会看到模型按分类显示，例如：

分类	模型
claude-opus	`claude-opus-4-6-thinking`
claude-sonnet	`claude-sonnet-4-6-thinking`
gemini	`gemini-3.1-pro`、`gemini-3-flash`

第五步：开启服务商

确保服务商右上角的开关处于 ON 状态（绿色），这样该服务商的模型才会在对话中可用。

第三部分：开始使用

配置完成后，回到聊天界面：

点击模型选择下拉框
选择你刚配置的服务商下的模型
开始对话

常见问题

Q: 点击“检测”提示失败？

A: 请检查：

API 密钥是否正确（以 sk- 开头）
API 地址是否填写正确：https://api.huanyuf.top
网络是否能访问该地址

Q: 获取模型列表为空？

A: 请确认：

API 地址末尾不要加 /v1 或 /v1/chat/completions，Cherry Studio 会自动补全
API 密钥有效且有权限

Q: 对话时提示 timeout？

A: 思考模型响应较慢，可以在设置中调大超时时间，建议设为 300 秒以上。

Q: 如何切换不同模型？

A: 在聊天界面顶部的模型选择框中直接切换即可，无需重新配置。

目录