Cherry Studio 完整配置指南（Mac/Windows）

目录

• 软件介绍
• API Key 获取
• 下载与安装
• 配置连接教程
• 常见问题

软件介绍

Cherry Studio 是一款支持多模型服务的现代化桌面客户端，专为高效的人工智能交互设计。它集成了主流大语言模型（LLM）云服务，支持自定义 OpenAI 兼容协议，拥有精美的 UI 和丰富的功能（如知识库、AI 助手管理等）。

对于 i-Coding 用户，Cherry Studio 是一个非常优秀的图形化操作界面选择。

API Key 获取

1. 访问 https://www.i-coding.shop/console/token，进入 令牌管理。
2. 点击 添加令牌。
3. 在弹窗中配置：名称、过期时间（推荐永不过期）、额度。
4. 提交后系统显示新令牌（以 sk- 开头），请 立即复制 并保存。

⚠️ 注意：该令牌将用于 Cherry Studio 的 API Key 设置。

下载与安装

请前往 Cherry Studio 官方渠道下载最新版本：

• 官方网站：cherry-ai.com
• GitHub Release：CherryHQ/CherryStudio

Windows

下载 .exe 安装包（如 CherryStudio-Setup-x.x.x.exe），双击运行并按提示完成安装。

macOS

下载 .dmg 安装包。打开后将 Cherry Studio 图标拖入 Applications 文件夹。

支持 Intel 与 Apple Silicon (M1/M2/M3) 芯片，请选择对应版本或通用版本。

Linux

提供 .AppImage、.deb 等格式，可根据发行版选择。

配置连接教程

1. 添加模型服务商

1. 打开 Cherry Studio，点击左下角的 设置（齿轮图标）。
2. 在设置菜单中选择 模型服务（Model Providers）。
3. 在服务商列表中，找到并选择 OpenAI（或者选择 OpenAI Compatible 兼容模式）。

   推荐：直接使用 OpenAI 选项，因为 i-Coding 完全兼容 OpenAI 协议。

2. 填写配置信息

在右侧配置面板中填写以下信息：

• API 密钥 (API Key)： 粘贴你在 i-Coding 控制台获取的令牌（sk-xxxxxxxx...）。

• API 地址 (API URL / Base URL)： 填写：https://www.i-coding.shop

  ⚠️ 重要：请不要包含 /v1 后缀，否则可能无法连接。

3. 添加与管理模型

1. 配置完成后，点击下方的 管理 或 添加模型 按钮。
2. 你可以点击 获取模型列表（如果有此按钮）自动同步支持的模型。
3. 或者手动添加常用模型 ID，例如：
   • gpt-4o
   • claude-3-5-sonnet-20240620
   • gemini-1.5-pro
   • deepseek-chat
4. 开启你希望在聊天界面使用的模型开关。

4. 开始对话

1. 点击左侧边栏的 对话（气泡图标） 返回主界面。
2. 在顶部模型选择栏中，选择刚才配置的 OpenAI 服务商及对应的模型。
3. 输入内容开始对话。

常见问题

配置后提示“连接失败”或 “404 Error”？

• 检查 API 地址是否为 https://www.i-coding.shop
• 确认 API Key 复制完整且未过期
• 在设置中切换 “OpenAI” 与 “OpenAI Compatible” 两种服务商类型测试

如何使用 Claude 或 Gemini 模型？

• i-Coding 平台通过 OpenAI 兼容协议统一透传所有模型
• 无需在 Cherry Studio 中另外配置 Anthropic 或 Google 服务商
• 只需在 OpenAI 服务商下添加对应模型 ID（如 claude-3-5-sonnet）即可调用

支持知识库功能吗？

支持。Cherry Studio 可解析 PDF/Word/TXT 等文件，配置好 i-Coding API 后会调用 Embedding 模型（建议使用 text-embedding-3-small 等）完成向量化与对话总结。

为什么看不到余额？

客户端暂不显示 i-Coding 余额，请登录 i-Coding 控制台 查看剩余额度。