外观
CherryStudio 配置指南 工具
全能的 AI 助手桌面客户端
简介
CherryStudio 是一款功能强大的 AI 助手桌面应用，支持多种主流 AI 模型（Claude、Gemini、GPT 等），为开发者和用户提供统一的 AI 交互界面。本教程将指导你如何配置 CherryStudio 接入 CC Code 平台。
功能特点
- ✅ 多模型支持：支持 Claude、Gemini、GPT 等主流 AI 模型
- ✅ 统一界面：一个应用管理所有 AI 服务
- ✅ 自定义 API：支持接入自定义 API 提供商
- ✅ 跨平台：支持 Windows、macOS、Linux
- ✅ 本地优先：数据存储在本地，保护隐私
安装步骤
STEP 1 下载安装 CherryStudio
访问 CherryStudio 下载页面，根据你的操作系统选择对应的安装包：
- Windows：下载
.exe安装程序 - macOS：下载
.dmg镜像文件 - Linux：下载
.AppImage或.deb包
macOS 用户注意
如果提示「无法打开，因为它来自身份不明的开发者」，请在系统偏好设置 → 安全性与隐私中允许打开。
STEP 2 获取 CC Code API Key
在配置 CherryStudio 之前，需要先从 CC Code 平台获取 API Key：
- 访问 CC Code 控制台
- 登录你的账户
- 根据需要创建对应的令牌组：
- Claude 模型：选择「只允许逆向分组」
- Gemini 模型：选择「gemini 分组」
- 保存生成的 API Key
配置快速参考
| 模型 | 提供商类型 | API 地址 | 令牌组 |
|---|---|---|---|
| Claude | Anthropic | https://ai.cccode.org/v1/messages | 只允许逆向分组 |
| Gemini | Gemini | https://ai.cccode.org/v1beta/models | gemini 分组 |
配置 Claude 模型
进入设置页面
- 打开 CherryStudio 应用
- 点击左下角的「设置」或「偏好设置」
- 选择「模型配置」或「API 配置」选项
配置 Claude API
在 Claude 配置界面中填写以下信息：
- 提供商类型：选择 Anthropic
- API 地址：
https://ai.cccode.org/v1/messages - API Key：粘贴你从 CC Code 控制台获取的 Claude API Key
- 模型名称：输入对应的模型名称（如
claude-sonnet-4-5-20250929）
配置 Gemini 模型
配置 Gemini API
在 Gemini 配置界面中填写以下信息：
- 提供商类型：选择 Gemini
- API 地址：
https://ai.cccode.org/v1beta/models - API Key：粘贴你从 CC Code 控制台获取的 Gemini API Key
- 模型名称：输入对应的模型名称（如
gemini-2.5-pro-preview）
⚠️ 注意
Gemini 和 Claude 需要使用不同的 API Key（不同的令牌组），确保你在 CC Code 平台创建了对应的令牌组。
开始使用
- 点击「新建对话」按钮
- 在模型选择器中选择已配置的模型
- 开始与 AI 对话
常见问题
为什么有些模型无法使用？
- 检查对应的 API Key 是否有权限访问该模型
- 确认账户余额是否充足
- 查看 CC Code 控制台的令牌组设置