CherryStudio 客户端
CherryStudio 是一款跨平台 AI 助手桌面应用,支持 Claude、Gemini、GPT 等主流模型,本地存储数据,一个界面管理所有 AI 对话。
安装
按系统选择安装包:Windows(.exe)、macOS(.dmg)、Linux(.AppImage / .deb)。
macOS 用户
若提示"无法打开,因为来自身份不明的开发者",到「系统设置 → 隐私与安全性」中允许打开。
配置速查
| 模型 | 提供商类型 | API 地址 |
|---|---|---|
| Claude | Anthropic | https://www.211api.com |
| Gemini | Gemini | https://www.211api.com/v1beta/models |
API Key 统一使用 211API 控制台 创建的 Key,模型名以控制台「模型列表」为准。
配置 Claude 模型
- 打开 CherryStudio,进入「设置 → 模型服务」。
- 添加提供商,类型选择 Anthropic。
- API 地址填
https://www.211api.com,API Key 填 211API 的 Key。 - 添加模型名称(以控制台模型列表为准),保存后启用。
配置 Gemini 模型
- 同样进入「设置 → 模型服务」,添加提供商,类型选择 Gemini。
- API 地址填
https://www.211api.com/v1beta/models,API Key 填 211API 的 Key。 - 添加模型名称(如控制台列表中的 Gemini 系列),保存后启用。
开始使用
- 点击「新建对话」,在模型选择器中选已配置的模型即可对话,对话中可随时切换模型。
- 可调参数:Temperature(编程建议 0.2-0.5,创意写作 0.7-0.9)、Max Tokens、Top P。
常见问题
提示 API Key 无效 — 检查 Key 是否完整复制(无多余空格)、账户余额是否充足、模型名与控制台列表一致。
模型列表为空 — 核对 API 地址是否与上表一致(Claude 用根地址,Gemini 用 /v1beta/models),检查网络连接。
响应慢 — 检查网络质量;换更快的模型(如 Gemini Flash 系列);清理过长的对话历史。
与其他客户端对比
| 特性 | CherryStudio | Alma | Hapi |
|---|---|---|---|
| 界面 | 桌面应用 | 桌面应用 | Web / PWA |
| 代码编辑 | 部分支持 | ✅ | ✅ |
| 终端集成 | ❌ | ✅ | ✅ |
| 远程访问 | ❌ | ❌ | ✅ |
| 上手难度 | 低 | 中 | 中 |
纯对话需求选 CherryStudio,编程开发选 Alma 或 Hapi,远程控制选 Hapi。