接入 Cherry Studio

Cherry Studio 是桌面端 AI 客户端，适合图形界面对话、多模型切换和代码讨论。

很多人第一次接入 小蓝中转站，会先用 Cherry Studio 跑第一条链路。原因很直接：

• 图形界面里能直接看到服务商、Key、模型和会话切换位置
• 配好后发一句“你好”，最容易先确认地址、鉴权和模型是否都正常
• 就算后面你真正主力使用 Claude Code 或 Codex，先把 Cherry Studio 跑通，也能先排除账号、余额和 Key 层的问题

下载与安装

下载入口：

• 官网：https://www.cherry-ai.com/
• 官方下载页：https://docs.cherry-ai.com/cherry-studio/download
• 官方文档：https://docs.cherry-ai.com/
• GitHub 发布页：https://github.com/CherryHQ/cherry-studio/releases

国内用户优先打开官方下载页。这个页面已经把官网主线路、GitHub、备用线路和夸克网盘下载整理在一起，通常比只盯着 GitHub 更省事。

下载顺序建议：

1. 官方下载页里的主线路
2. 官方下载页里的备用线路或夸克网盘
3. GitHub 发布页

安装包选择：

• Windows：第一次安装优先选 Setup 安装版；不想写注册表或没有安装权限时，再选 Portable 便携版
• macOS Apple 芯片：选择 arm64 / aarch64
• macOS Intel 芯片：选择 x64 / x86_64
• Linux：优先选择 .AppImage，Ubuntu / Debian 也可以选 .deb

官方下载页还说明了两点：

• Windows 7 不支持安装 Cherry Studio
• macOS 下载时要分清 Intel 和 Apple Silicon

macOS 首次打开如果被系统拦截，到 系统设置 → 隐私与安全性 允许打开。 Windows 如果被安全软件拦截，确认下载来源是官网或官方 GitHub 后再放行。

配置步骤

1. 准备你的网关凭证

前往 小蓝中转站控制台，为桌面客户端生成一把专用 Key，建议命名为 Desktop-Cherry。

第一次配置时，建议这样准备：

项目	建议	原因
分组	auto 或默认分组	先把链路跑通
模型权限	个人自用先不额外限制	先减少误判
第一个模型	先选轻量模型	先确认地址、Key 和模型链路都正常
第二个模型	再补一个强模型	后面切到代码、长文任务更方便

还没创建 Key 时，先看 创建专属 Key。

2. 添加 OpenAI 兼容服务商

打开 Cherry Studio 的设置中心，找到自定义服务商 / OpenAI 兼容接口，填入以下配置：

• API 地址 (Base URL)：https://xiaolan.ainb.plus
• API Key：填入你刚准备好的凭证。
• 获取模型列表：点击客户端自带的“拉取/获取模型”按钮，小蓝中转站 网关会自动下发你当前权限内的所有可用模型；或者你可以直接从模型广场复制特定的模型代号手动添加。

常见入口名称可能略有不同：

• 自定义服务商
• OpenAI Compatible
• OpenAI 兼容
• 自定义 OpenAI

看到这些入口，都可以按上面的地址和 Key 填。

这里要注意一层：
Cherry Studio 里常常同时能看到 OpenAI、Anthropic、Gemini 或其他内置服务商入口。接 小蓝中转站 时，优先找的是 OpenAI 兼容 / 自定义服务商 这一类入口，而不是直接把 小蓝中转站 填进别的官方服务商模板里。

最容易填错的是地址。
Cherry Studio 官方当前对服务商地址的说明是：如果服务商给你的完整接口长得像 https://xxx/v1/chat/completions，那在 Cherry Studio 里通常只填根地址，让客户端自己继续补后面的 OpenAI 兼容路径。

在 Cherry Studio 里，https://xiaolan.ainb.plus 比 https://xiaolan.ainb.plus/v1 更稳。
如果把 /v1 也一起填进去，Cherry Studio 继续补路径后，最终请求就可能多拼一层。

3. 保存后先做一次校验

Cherry Studio 官方当前在服务商设置里提供 Check 校验按钮。
保存服务商后，先点一次 Check，再继续拉模型，会比直接开新会话更容易判断问题卡在哪一层。

这一层主要是在确认：

• 地址能不能连通
• Key 有没有填错
• 当前服务商是不是已经启用

当前版本的界面右上角还有启用开关时，也顺手确认一下它已经打开。

这一步已经失败时，先不要急着改模型。
Check 失败时，问题通常还停留在地址、Key、服务商启用状态或本地网络这一层。

4. 先把模型列表拉下来

通过 Check 以后，再点“获取模型”或“拉取模型列表”。

第一次拉完后，重点看三件事：

• 列表里有没有你当前想用的模型系列
• 模型名是不是完整的
• 当前会话下拉框里能不能真的选到这些模型

已经知道后面会做两类事情时，第一次拉完后就可以顺手分一下：

• 一个轻量模型：拿来验证链路、日常聊天、短问答
• 一个强模型：拿来做长文、代码、多轮复杂问题

这样后面切换时不会只看到一长串模型名，却不知道先选哪个。

如果自动拉取失败，再回模型广场复制模型名手动添加。

模型已经拉下来，不代表当前对话一定已经在用它。
很多时候设置页里能看到模型，真正开新会话时却还停留在旧服务商或旧模型，所以回到对话页后，最好再看一眼当前线程顶部或下拉框里实际选中的模型。

5. 测试对话

保存配置后，开启一个新对话。选择模型，发送一句“你好”。能正常回复，说明配置已生效。

第一次测试建议使用轻量模型，先确认鉴权和网络没问题。再切到 Claude、Gemini 或更强模型处理长文和代码。

第一次真正算接通，通常要同时满足：

1. Check 成功
2. 模型列表能拉下来，或手动添加后能被当前会话选中
3. 发一句短消息能正常返回
4. 当前线程里显示的确实是你刚选的那个模型

推荐配置方式

自动获取模型

如果 Cherry Studio 提供“获取模型”按钮，优先点击它。模型列表来自当前 Key 的权限范围。

获取后重点看：

• 模型名是否完整
• 是否包含你要用的系列
• 价格是否已在模型广场确认

拉到列表以后，不等于当前会话一定已经切过去了。
很多人看到模型已经在设置页里出现，就以为配置结束了，结果开新会话时还在用别的服务商或别的旧模型。

最稳的做法是：回到对话页，再看一眼当前线程实际选中的服务商和模型。

手动添加模型

自动获取失败时，打开 模型广场，复制模型名后手动添加。

不要手动输入模型名。多一个空格、少一个日期后缀，都可能导致模型不存在。

多模型分工

建议至少准备两类模型：

• 日常聊天：轻量模型，响应快、成本低
• 代码和长文：强模型，适合复杂任务

Cherry Studio 可以保存多个会话，适合把聊天、代码分析、翻译总结分开。

使用建议

• 工作流分离：利用 Cherry Studio 的多会话特性，把聊天、代码分析、翻译总结分开。
• 温度控制：要求严谨的编码任务，可以在客户端侧边栏将 Temperature 调低。
• Key 隔离：桌面客户端单独一把 Key，和 Claude Code、Codex 分开。
• 上下文控制：避免一次拖入整个仓库。只放相关文件，响应会更快，费用也更稳。
• 先校验再聊天：先点 Check，再拉模型，再发消息，排障顺序会更清楚。
• 先轻后强：先用轻量模型把链路跑通，再切强模型，最容易分清问题是在配置层还是模型层。

排障

• 获取不到模型列表？ 先检查 API 地址是不是误写成了 https://xiaolan.ainb.plus/v1，再看 API Key 是否多复制了空格。
• 地址填成了 https://xiaolan.ainb.plus/v1 会怎样？ Cherry Studio 可能会继续往后拼 OpenAI 兼容路径，最后看起来像“接口不存在”或“模型列表始终拉不下来”。
• 回复极慢或断流？ 去模型广场确认该模型当前的拥挤状态，或者切一个轻量级模型交叉验证是否为本地网络波动。
• 401 / 鉴权失败？ 重新复制 Key。确认没有前后空格，控制台里这把 Key 没有禁用，余额没有耗尽。
• 404 / 模型不存在？ 回模型广场复制模型名。不要使用客户端内置的旧模型名。
• 保存后仍然走旧配置？ 关闭 Cherry Studio 后重新打开。多服务商并存时，确认当前会话选中的是 小蓝中转站 服务商。
• 能拉到模型，但发消息时报模型不存在？ 先确认当前会话真正选中的是刚拉下来的模型，再检查这把 Key 的分组和模型权限。
• 流式回复中途断开？ 先换轻量模型测试。如果轻量模型稳定，大概率是当前模型负载高或上下文太长。
• 公司网络无法访问？ 换手机热点测试一次。热点可用时，说明是当前网络策略拦截。

最小可用配置

只填这三项即可开始：

服务商类型：OpenAI 兼容
API 地址：https://xiaolan.ainb.plus
API Key：sk-你的专属Key

模型名从模型广场复制。其他高级参数先保持默认。
保存后先点 Check，再拉模型，再开新会话测试，会更稳。