Cherry Studio 集成指南

Cherry Studio 是一款桌面端 AI 客户端，支持自定义 OpenAI 兼容供应商，可无缝接入 KOPRouter。

**前置条件**

已安装 Cherry Studio
一把 KOPRouter API Key（sk- 开头）

进入 Cherry Studio 的「设置 → 模型服务」，点击「添加」新建一个供应商。供应商类型选择 OpenAI 兼容，并填写：

<span class="field-row"><span class="field-kv">API 地址</span><code>https://koprouter.kopglobal.com/v1</code></span>
<span class="field-row"><span class="field-kv">API Key</span>`sk-...`</span>

保存后点击「刷新模型列表」，Cherry Studio 会自动拉取 `/v1/models` 中可用模型。 API 地址务必带上 `/v1` 后缀，否则部分请求会 404。 **Windows / macOS 通用**

以上步骤在 Windows 与 macOS 上完全一致。若所在网络无法直连 KOPRouter（如中国大陆），请在 Cherry Studio 的「设置 → 网络 / 代理」里填写 HTTP 代理地址（7890 只是示例端口，请换成你自己的代理端口），无需设置环境变量；或直接开启系统代理（TUN / 全局模式），详见「网络与代理配置」。