CherryStudio 配置教程（桌面端 AI 客户端）

一、方案简介

CherryStudio 是一款跨平台桌面 AI 客户端，图形化界面操作简单，无需命令行基础。通过修改 API 地址指向 APIBox，我们可以在国内无缝直连调用 Claude、GPT-5 和各大国产模型。

二、安装步骤

1. 下载安装 CherryStudio

前往 CherryStudio 官网下载页面，根据你的操作系统选择对应版本：

• Windows：下载 .exe 安装包，双击运行安装。
• macOS：下载 .dmg 文件，拖入应用程序文件夹。
• Linux：下载 .AppImage 或 .deb 包安装。

安装过程和普通软件一样，下载后运行安装程序即可。macOS 用户如遇到安全提示，前往「系统设置 > 隐私与安全性」中允许打开。

2. 获取 API 密钥

前往 APIBox 控制台 获取你的 API Key。

提示：APIBox 价格约为官方 1/7，支持所有主流模型，人民币充值。

3. 配置 CherryStudio 接入 APIBox

打开 CherryStudio 应用，点击左下角的齿轮图标进入设置。

在 供应商 列表中，选择 添加自定义供应商。

• 供应商类型：选择 OpenAI（兼容接口）
• 供应商名称：填写 APIBox
• API Key：填写你的 APIBox API Key
• API URL：填写 https://api.apibox.cc/v1
• 模型列表：手动添加你需要调用的模型名，例如：
  • claude-sonnet-4-6 （性价比高，推荐日常对话）
  • gpt-5
  • gemini-2.5-pro
  • deepseek-v3

点击保存，配置完成。

三、常见问题排查

❌ 插件无法连接，提示 API 错误

原因： API URL 缺少 /v1 尾缀。 解决： 确保 Base URL 填写完整：https://api.apibox.cc/v1。

❌ 报错：“Invalid API Key”

原因： API Key 填写错误，或者你没有在提供商列表中选择 OpenAI 兼容接口。 解决： 请勿选择 Anthropic 或 OpenAI 官方提供商，必须选择自定义的 OpenAI 兼容提供商，并将 APIBox 的 Key 粘贴进去。

❌ 找不到模型

原因： 某些版本的 CherryStudio 不会自动拉取模型列表，需要手动输入。 解决： 请参阅 APIBox 官方文档或控制台确认模型名称，手动填写，例如不能填 claude-3-5-sonnet，要填 claude-sonnet-4-6。