主题
CherryStudio 配置指南
一款功能丰富的多模型桌面 AI 客户端。
✨ 功能特点
- ✅ 多模型支持：同时接入 Claude、Gemini、OpenAI 等多家模型
- ✅ 多会话管理：同时维护多个对话窗口
- ✅ 提示词库：内置丰富的 Prompt 模板
- ✅ 知识库：支持本地 RAG 检索增强
- ✅ 跨平台：Windows / macOS / Linux 三端通用
🛠️ 安装步骤
第一步：下载安装 CherryStudio
访问 CherryStudio 官网 下载对应平台的安装包并完成安装。
第二步：获取 API Key
从本站 控制台 → 令牌管理 创建对应分组的 API Key：
- Claude 模型 → 使用 Claude 分组 Key
- Gemini 模型 → 使用 Gemini 分组 Key
- GPT / OpenAI 模型 → 使用 默认分组 Key
🔧 配置 Claude 模型
第一步：进入设置页面
- 打开 CherryStudio
- 点击左下角的 「设置」
- 选择 「模型配置」 或 「API 配置」 选项
第二步：选择 Claude 模型类型
在模型列表中选择你需要的 Claude 模型：
- Claude Sonnet 4.5：
claude-sonnet-4-5-20250929— 最新版本，日常首选 - Claude Opus 4.5：
claude-opus-4-5-20251101— 最强性能 - Claude 3.5 Haiku — 速度快，适合简单任务
💡 提示
具体可用的模型取决于你在控制台创建的令牌组权限。
第三步：配置 Claude API
| 字段 | 值 |
|---|---|
| 提供商类型 | Anthropic |
| API 地址 | https://api.nassaapi.xyz/messages |
| API Key | 你的 Claude 分组 Key |
| 模型名称 | 如 claude-sonnet-4-5-20250929 |
🔧 配置 Gemini 模型
第一步：选择 Gemini 模型类型
- Gemini 3 Flash Preview：
gemini-3-flash-preview— 最新版本，推荐 - Gemini 3 Pro Preview：
gemini-3-pro-preview— 高性能 - Gemini 2.0 Flash — 快速响应
⚠️ 注意
- Gemini 和 Claude 需要使用不同的 API Key（不同的令牌组）
- 确保你在控制台创建了对应的令牌组
第二步：配置 Gemini API
| 字段 | 值 |
|---|---|
| 提供商类型 | Gemini |
| API 地址 | https://api.nassaapi.xyzbeta/models |
| API Key | 你的 Gemini 分组 Key |
| 模型名称 | 如 gemini-3-flash-preview |
🔧 配置 OpenAI 兼容（GPT 系列）
如果要使用本站的 GPT-5 系列模型：
| 字段 | 值 |
|---|---|
| 提供商类型 | OpenAI |
| API 地址 | https://api.nassaapi.xyz |
| API Key | 你的默认分组 Key |
| 模型名称 | gpt-5.5 / gpt-5.4 / gpt-5.3-codex 等 |
💬 开始使用
创建新对话
- 点击左上角 「+」 新建对话
- 顶部选择模型（Claude / Gemini / GPT）
- 输入提示词开始对话
切换模型
随时点击对话顶部的模型选择器切换不同模型，可在一个对话中对比多模型回答。
调整参数
- Temperature：控制随机性（0–2，默认 1）
- Max Tokens：单次回复最大长度
- System Prompt：设定助手人格
🎯 最佳实践
1. 合理选择模型
- 复杂任务：
claude-opus-4-5或gpt-5.5 - 日常对话：
claude-sonnet-4-5或gpt-5.4-mini - 快速简单：
claude-3-5-haiku或gemini-3-flash-preview
2. 管理 API 使用
- 定期查看 控制台 → 账单 了解消费
- 对不同业务用独立 Key 方便核算
3. 优化对话体验
- 使用提示词库快速调用常用 Prompt
- 对长对话定期 总结压缩，避免上下文超限
🔍 与其他客户端的对比
| 特点 | CherryStudio | Alma | Claude Code |
|---|---|---|---|
| 形态 | GUI 桌面 | GUI + 终端 | CLI |
| 多模型对比 | ✅ 强 | ✅ | ❌ |
| 代码集成 | ❌ | ✅ | ✅✅ 深度 |
| 知识库 | ✅ | ❌ | ❌ |
| 适合场景 | 日常对话 / 知识库 | 交互式编码 | 项目级编程 |
常见问题
提示 API Key 无效？
- 检查 Key 是否复制完整（
sk-开头） - 检查 Key 对应的分组是否包含所选模型
- 前往 控制台 确认 Key 状态为「已启用」
模型列表为空？
点击 刷新按钮 或重启 CherryStudio。如果仍为空，检查 API 地址是否填写正确。
对话响应速度慢？
- 切换到更快的模型（如
haiku/mini/flash） - 关闭长上下文避免推理负担
- 检查网络是否稳定
如何同时使用多个模型？
在 CherryStudio 中可同时配置多家 Provider，对话时通过顶部下拉菜单切换。
更多问题
请查阅 疑难杂症 或 常见问题 (FAQ)。
✅ 完成
至此 CherryStudio 已成功接入本站，享受多模型对话的强大体验吧！