OneinAI

Appearance

CherryStudio 配置指南 ​

全能的 AI 助手桌面客户端

资源地址
官方网站cherry-ai.com
下载地址cherry-ai.com/download
oneinAI 控制台api.oneinai.com/console/token

📋 简介 ​

CherryStudio 是一款功能强大的 AI 助手桌面应用，支持 Claude、Gemini、GPT 等主流 AI 模型，为开发者和用户提供统一的 AI 交互界面。本教程将指导你如何配置 CherryStudio 接入 oneinAI 平台。

✨ 功能特点 ​

  • ✅ 多模型支持：Claude、Gemini、GPT 等主流 AI 模型
  • ✅ 统一界面：一个应用管理所有 AI 服务
  • ✅ 自定义 API：支持接入自定义 API 提供商
  • ✅ 跨平台：支持 Windows、macOS、Linux
  • ✅ 本地优先：数据存储在本地，保护隐私
  • ✅ 丰富功能：对话管理、模型切换、参数调整等

📋 配置快速参考 ​

模型提供商类型API 地址令牌组
ClaudeAnthropichttps://api.oneinai.comClaude 分组
GeminiGeminihttps://api.oneinai.com/v1beta/modelsGemini 分组

🛠️ 安装步骤 ​

第一步：下载安装 CherryStudio ​

  1. 访问 CherryStudio 下载页面
  2. 根据你的操作系统选择对应的安装包：
    • Windows：下载 .exe 安装程序
    • macOS：下载 .dmg 镜像文件
    • Linux：下载 .AppImage 或 .deb 包
  3. 下载完成后，按照系统提示完成安装

💡 macOS 用户注意 如果提示"无法打开，因为它来自身份不明的开发者"，请在系统偏好设置 → 安全性与隐私中允许打开。

第二步：获取 oneinAI API Key ​

在配置 CherryStudio 之前，需要先从 oneinAI 平台获取 API Key：

  1. 访问 oneinAI 控制台
  2. 登录你的账户
  3. 根据需要创建对应的令牌组：
    • Claude 模型：选择 Claude 分组
    • Gemini 模型：选择 Gemini 分组
  4. 保存生成的 API Key（请妥善保管，不要泄露）

创建 API Key

⚠️ Claude 和 Gemini 的 API Key 必须使用不同的令牌组，两者不能通用。

🔧 配置 Claude 模型 ​

第一步：进入设置页面 ​

  1. 打开 CherryStudio 应用
  2. 点击左下角的「设置」或「偏好设置」
  3. 选择「模型配置」或「API 配置」选项

第二步：选择 Claude 模型类型 ​

Claude 类型选择

在模型列表中选择你需要的 Claude 模型。

第三步：配置 Claude API ​

在 Claude 配置界面中填写以下信息：

Claude 配置界面

配置参数：

字段填写内容
提供商类型Anthropic
API 地址https://api.oneinai.com
API Key从 oneinAI 控制台 获取的 Claude API Key
模型名称例如 claude-sonnet-4-6、claude-opus-4-5-20251101

🔧 配置 Gemini 模型 ​

第一步：选择 Gemini 模型类型 ​

Gemini 类型选择

在模型列表中选择你需要的 Gemini 模型：

  • Gemini 3 Flash Preview：gemini-3-flash-preview — 最新版本，速度快，性能优秀（推荐）
  • Gemini 3 Pro Preview：gemini-3-pro-preview — 高性能，适合复杂任务
  • Gemini 2.0 Flash：快速响应，适合简单对话

第二步：配置 Gemini API ​

在 Gemini 配置界面中填写以下信息：

Gemini 配置界面

配置参数：

字段填写内容
提供商类型Gemini
API 地址https://api.oneinai.com/v1beta/models
API Key从 oneinAI 控制台 获取的 Gemini API Key
模型名称例如 gemini-3-flash-preview

⚠️ 注意：Gemini 和 Claude 需要使用不同的 API Key（不同的令牌组），确保你在 oneinAI 平台已创建对应的令牌组。

💬 开始使用 ​

创建新对话 ​

  1. 点击「新建对话」或「New Chat」按钮
  2. 在模型选择器中选择已配置的模型
  3. 开始与 AI 对话

切换模型 ​

在对话过程中，你可以随时切换不同的模型：

  1. 点击顶部的模型选择器
  2. 选择其他已配置的模型
  3. 继续对话（上下文可能会保留或重置，取决于应用设置）

调整参数 ​

CherryStudio 通常支持调整以下参数：

  • Temperature（温度）：控制回复的随机性（0-1）
  • Max Tokens（最大令牌数）：控制回复长度
  • Top P：控制采样范围

💡 参数建议

  • 编程任务：Temperature 0.2-0.5（更准确）
  • 创意写作：Temperature 0.7-0.9（更有创意）
  • 日常对话：Temperature 0.5-0.7（平衡）

🎯 最佳实践 ​

1. 合理选择模型 ​

不同任务使用不同模型：

任务类型推荐模型模型标识
代码编写Claude Sonnet 4.5claude-sonnet-4-5-20250929
快速对话Gemini 3 Flash Previewgemini-3-flash-preview
复杂推理Claude Opus 4.5claude-opus-4-5-20251101
多模态（图片）Gemini 3 Pro Previewgemini-3-pro-preview

2. 管理 API 使用 ​

  • 定期检查 oneinAI 控制台 的余额
  • 为不同用途创建不同的 API Key，便于管理和审计
  • 避免在公共场合或代码仓库中泄露 API Key

3. 优化对话体验 ​

  • 使用清晰、具体的提示词
  • 合理设置上下文长度，避免过长影响响应速度
  • 善用对话历史管理功能，及时归档或清理

🔍 与其他客户端的对比 ​

特性CherryStudioAlmaHapi
界面类型桌面应用桌面应用Web/PWA
多模型支持✅✅✅
代码编辑部分支持✅✅
终端集成❌✅✅
远程访问❌❌✅
学习曲线低中中

选择建议：

  • 纯对话需求：CherryStudio（界面简洁，易上手）
  • 编程开发：Alma 或 Hapi（功能更强大）
  • 远程控制：Hapi（独有功能）

❓ 常见问题 ​

提示 API Key 无效？ ​

可能原因：

  • API Key 输入错误或前后有空格
  • 令牌组选择错误（Claude 的 Key 不能用于 Gemini，反之亦然）
  • 账户余额不足

解决方法：

  1. 重新复制 API Key，确保完整且无多余空格
  2. 在 oneinAI 控制台 确认创建了正确的令牌组
  3. 查看账户余额是否充足

模型列表为空？ ​

可能原因：

  • Base URL 配置错误
  • 网络连接问题
  • API Key 权限不足

解决方法：

  1. 确认 Claude 的 API 地址为 https://api.oneinai.com
  2. 确认 Gemini 的 API 地址为 https://api.oneinai.com/v1beta/models
  3. 检查网络连接是否正常
  4. 重新获取 API Key 并确认令牌组权限正确

对话响应速度慢？ ​

可能原因：

  • 网络延迟
  • 选择的模型较大（如 Opus 系列）
  • 上下文过长

解决方法：

  1. 检查网络连接质量
  2. 尝试使用更快的模型（如 Gemini Flash 或 Claude Haiku）
  3. 清理或缩短对话历史

如何同时使用多个模型？ ​

  1. 在设置中分别配置不同的模型提供商
  2. 在新建对话时选择对应的模型
  3. 也可以创建多个对话窗口，每个使用不同模型

更多问题 ​

✅ 完成 ​

🎉 配置完成！现在你可以使用 CherryStudio 愉快地与 AI 对话了！

核心要点回顾：

  • ✅ Claude 与 Gemini 必须使用不同的 API Key（不同令牌组）
  • ✅ Claude API 地址：https://api.oneinai.com
  • ✅ Gemini API 地址：https://api.oneinai.com/v1beta/models
  • ✅ 根据任务特性选择合适的模型
  • ✅ 定期检查 oneinAI 控制台 的余额
  • ✅ 妥善保管你的 API Key，避免泄露

相关教程：