CherryStudio 配置指南

简介

CherryStudio 是一款强大的 AI 助手桌面应用，支持多种主流 AI 模型（Claude、Gemini、GPT 等）。

核心功能

• 多模型支持（Claude、Gemini、GPT）
• 跨平台统一界面
• 自定义 API 集成
• Windows、macOS、Linux 全平台支持
• 本地优先的数据存储
• 对话管理和参数调节

安装步骤

第一步：下载 CherryStudio

• 访问官方下载页面：cherry-ai.com/download
• 选择对应操作系统的安装包：
  • Windows：.exe
  • macOS：.dmg
  • Linux：.AppImage / .deb
• 按系统提示完成安装

第二步：获取 CodeKey API Key

1. 访问 CodeKey 控制台
2. 登录账号
3. 创建对应模型的令牌组（Claude 与 Gemini 分开）
4. 保存生成的 API Key

配置详情

Claude 模型配置

配置项	值
Provider Type	Anthropic
API Endpoint	https://api.codekey.cc/v1/messages
推荐模型	Claude Sonnet 4.5 或 Opus 4.5

提示

使用 C 前缀 令牌组凭据。

Gemini 模型配置

配置项	值
Provider Type	Gemini
API Endpoint	https://api.codekey.cc/v1beta/models
推荐模型	Gemini 3 Flash Preview

注意

必须使用单独的 Gemini 专用 令牌组。

最佳实践

场景	推荐模型
编码任务	Claude Sonnet 4.5
快速对话	Gemini Flash
创意写作	温度 0.7-0.9
精确回答	温度 0.2-0.5

• 安全管理 API Key
• 定期监控账户余额
• 根据任务类型调整温度参数

故障排查

API Key 无效

验证令牌组选择是否与模型类型匹配。

模型列表为空

确认 API 端点 URL 和网络连接正常。

响应缓慢

检查网络质量或切换到更快的模型。

---

重要提醒

同一平台内不同 AI 模型使用不同的 API Key 和端点，请注意区分配置。