Cherry Studio 配置教程
Cherry Studio 是一款功能强大的 AI 桌面客户端，界面美观，支持多种模型和知识库功能。
下载安装
访问 Cherry Studio 官网 下载对应平台版本。
支持平台：Windows、macOS、Linux
配置步骤
步骤一：添加 API 提供商
- 打开 Cherry Studio
- 进入「设置」→「模型服务」
- 点击「添加提供商」
步骤二：配置 API
选择 OpenAI 类型（兼容模式）：
| 配置项 | 值 |
|---|---|
| 提供商名称 | ClaudeHub（自定义名称） |
| 提供商类型 | OpenAI |
| API 地址 | https://api.qinzhiai.com |
| API Key | sk-你的APIKey |
重要
提供商类型一定要选择 OpenAI，这样才能兼容 ClaudeHub 的 API 格式。
步骤三：获取模型列表
配置好后点击「管理」，Cherry Studio 会自动拉取可用的模型列表。按需选择添加即可。
步骤四：测试连通性
添加好可用模型后，点击测试按钮验证连通性。成功后就可以使用了。
推荐模型
| 模型 | 说明 |
|---|---|
gpt-4o | OpenAI 多模态模型 |
claude-sonnet-4-6 | Claude 4.5 Sonnet |
claude-opus-4-7 | Claude 4.7 Opus（最新） |
deepseek-chat | DeepSeek 高性价比 |
gemini-2.5-flash | Google Gemini 2.5 快速 |
功能特点
多模型对比
可以同时向多个模型发送相同问题，对比回答质量。
知识库
Cherry Studio 支持本地知识库功能：
- 在左侧菜单栏选择「知识库」
- 点击添加，创建新知识库
- 填写知识库名称，选择嵌入模型
- 添加文件、网址、笔记等知识信息
支持的知识类型：
- 文档文件（PDF、Word、TXT 等）
- 网页链接
- 笔记内容
历史记录
完整的对话历史管理和搜索功能。
快捷指令
自定义常用提示词和快捷操作。
多秘钥轮询
支持多个 API 秘钥轮换使用，避免速率限制问题。
常见错误码
| 错误码 | 说明 | 解决方案 |
|---|---|---|
| 400 | 请求错误 | 检查请求参数是否正确 |
| 401 | 身份验证失败 | 检查 API 密钥是否正确 |
| 403 | 禁止访问 | 检查是否完成实名认证 |
| 429 | 超出速率限制 | 等待后重试或使用多秘钥轮询 |
常见问题
模型列表为空
如果自动获取失败，可以手动添加模型 ID。
响应中断
- 检查网络连接
- 尝试重新发送
- 切换到响应更快的模型
知识库搜索不准
确保选择了合适的嵌入模型，推荐使用 bge-m3 或 text-embedding-3-small。