爱次元使用文档

主题

CherryStudio 配置指南 ​

全能的 AI 助手桌面客户端

官方网站：https://www.cherry-ai.com/​下载地址：https://www.cherry-ai.com/download

📋 简介

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

✨ 功能特点 ​

CherryStudio 提供以下强大功能：

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

🛠️ 安装步骤 ​

第一步：下载安装 CherryStudio ​

  1. 访问 CherryStudio 下载页面

  2. 根据你的操作系统选择对应的安装包：

    • ​Windows​：下载 .exe 安装程序
    • ​macOS​：下载 .dmg 镜像文件
    • ​Linux​：下载 .AppImage​ 或 .deb 包

  3. 下载完成后，按照系统提示完成安装

💡 macOS 用户注意

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

第二步：获取 爱次元 API Key ​

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

  1. 访问 爱次元 控制台
  2. 登录你的账户
  3. 根据需要创建对应的令牌组：
    ​image
  4. 保存生成的 API Key

配置 AI 模型 ​

第一步：进入设置页面 ​

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

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

image

第三步：配置 爱次元 信息 ​

  1. 在爱次元控制台获取你的令牌API密钥
    ​image
  2. 密钥输入到Cherry Studio
    ​image
  3. API地址填写：https://api.aicy.pro
    ​image
  4. 点击模型-管理
    ​image
  5. 添加你想要使用的模型
    ​image

第四步：配置默认模型 ​

image

image

第五步：配置API设置 ​

image

image

‍

💬 开始使用 ​

创建新对话 ​

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

切换模型 ​

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

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

调整参数 ​

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

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

🎯 最佳实践 ​

1. 合理选择模型 ​

不同任务使用不同模型：

  • 代码编写：GPT5.2-codex
  • 快速对话：Grok-4.1-thinking
  • 复杂推理：GPT-5.2
  • ​多模态任务：Gemini 3 Pro Preview（支持图片）

2. 管理 API 使用 ​

  • 定期检查 爱次元 控制台 的余额
  • 为不同用途创建不同的 API Key
  • 避免在公共场合泄露 API Key

3. 优化对话体验 ​

  • 使用清晰的提示词
  • 合理设置上下文长度
  • 善用对话历史管理功能

常见问题 ​

提示 API Key 无效？ ​

​可能原因：

  • API Key 输入错误
  • 令牌组选择错误（C开头的背带裤分组的 Key 不能用于 Gemini）
  • 余额不足

​解决方法：

  1. 检查 API Key 是否完整复制
  2. 确认在 爱次元 控制台 创建了正确的令牌组（Claude 用 C开头的背带裤分组，Gemini 用 gemini分组）
  3. 查看账户余额是否充足

模型列表为空？ ​

​可能原因：

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

​解决方法：

  1. 确认 Claude 的 API 地址为 https://api.aicy.pro/v1/messages
  2. 确认 Gemini 的 API 地址为 https://api.aicy.pro/v1beta/models
  3. 检查网络连接
  4. 重新获取 API Key 并确保令牌组权限正确

对话响应速度慢？ ​

​可能原因：

  • 网络延迟
  • 选择的模型较大
  • 上下文过长

​解决方法：

  1. 检查网络连接质量
  2. 尝试使用更快的模型（如 grok-4.1、grok-4.1-thinking、gemini-2.5-flash）
  3. 清理或减少对话历史

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

在 CherryStudio 中：

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

✅ 完成 ​

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

记住以下要点：

  • ✅ 不同模型使用不同的 API Key（不同令牌组）
  • ✅ 根据任务选择合适的模型
  • ✅ 定期检查 爱次元 控制台 的余额
  • ✅ 妥善保管你的 API Key

‍

爱次元 让 AI 编程更简单

Copyright © 2026 爱次元