Cherry Studio接入教程聊天客户端

Cherry Studio 配置教程:通过自定义 API 使用 Claude 和 GPT

(文中价格随实时价格表更新)

简短回答

在 Cherry Studio 中使用 APIVAI:打开 Settings → Model Services,点击 + Add Provider,命名为 APIVAI,把 OpenAI 端点地址填为 https://api.apivai.com(Cherry Studio 会自动补上 /v1/chat/completions)。把 APIVAI 密钥粘贴到 API Key,通过 Get model list 或 + 按钮添加 claude-sonnet-4-6、gpt-5.5 等模型 ID,然后打开该服务商开关,在对话中选择模型即可。如果想用 Anthropic 原生格式调用 Claude,也可以把内置 Anthropic 服务商的 API Address 改成同一个 https://api.apivai.com。截至 2026-10-07,通过 APIVAI 使用 Claude Sonnet 4.6 每百万输入 / 输出 token 为 $1.04 / $5.22,官方价为 $3.00 / $15.00,从预付余额按 token 扣费。

Cherry Studio 是什么?

Cherry Studio 是一款免费的桌面 AI 客户端,支持 Windows、macOS 和 Linux。它提供带助手的对话窗口、模型选择、知识库、MCP 工具,以及多个模型并排回答。Cherry Studio 本身不带模型:你用 API 密钥接入服务商,每条消息都由该服务商计费。

APIVAI 就是这样的服务商。一个 APIVAI 密钥可以调用 Claude 和 GPT 模型,同时支持 OpenAI 格式和 Anthropic 格式,按 token 计费且低于官方标价。因此在 Cherry Studio 里只需一个服务商条目,就能在同一个模型列表中使用 Claude Sonnet 4.6、Claude Opus 5.5 和 GPT-5.5。

应该用哪种服务商设置?

在 Cherry Studio 中接入 APIVAI 有两种清晰的方式:

自定义服务商(OpenAI 端点)内置 Anthropic 服务商
位置Settings → Model Services → + Add ProviderSettings → Model Services → Anthropic
地址https://api.apivai.comhttps://api.apivai.com
模型Claude 和 GPT仅 Claude
适合一个条目覆盖所有模型以原生 Messages 格式使用 Claude

选择自定义服务商:想用一个密钥同时使用 Claude 和 GPT,大多数人选这个即可。选择 Anthropic 服务商:只用 Claude 并且偏好原生格式,例如 Cherry Studio 中需要 Anthropic 协议端点的功能。两种可以用同一个密钥同时配置。

当前版本的 + Add Provider 对话框会显示独立的端点字段(默认是 OpenAI 和 Anthropic,更多在 More Settings 中)。Cherry Studio 文档没有说明同一服务商下的模型如何在两个端点之间选择,所以本文在那里只填写 OpenAI 端点,Claude 原生格式则通过内置 Anthropic 服务商接入。旧版本会让你选择 Provider Type,选 OpenAI 即可。

如何一步步把 Cherry Studio 接入 APIVAI?

第 1 步:获取 APIVAI 密钥

  1. 在 apivai.com 用邮箱注册。
  2. 充值余额,$10 起,支持银行卡、加密货币、支付宝或微信支付。没有订阅,也没有免费试用,只按实际使用的 token 付费。
  3. 打开控制台,创建密钥并复制。可以为该密钥单独设置预算上限。

第 2 步:把 APIVAI 添加为自定义服务商

  1. 点击左侧导航栏的 Settings(齿轮图标)。
  2. 打开 Model Services 标签页。
  3. 点击服务商列表下方的 + Add Provider。
  4. 按下表填写对话框,然后点击 Add。
字段值
Provider NameAPIVAI(任意你认得出的名称)
API Key你的 APIVAI 密钥
OpenAI 端点(API Address)https://api.apivai.com

关于 /v1:Cherry Studio 需要的是基础地址,会自己补上版本号和路径,因此 https://api.apivai.com 实际请求的是 https://api.apivai.com/v1/chat/completions。当前版本填 https://api.apivai.com/v1 也不会重复添加,但千万不要粘贴带 /v1/chat/completions 的完整地址。地址末尾加 # 表示让 Cherry Studio 原样使用该地址,接入 APIVAI 不需要这样做。

第 3 步:添加模型

  1. 在列表中打开刚创建的 APIVAI 服务商。
  2. 点击 Get model list。Cherry Studio 会拉取你的密钥可用的模型,在需要的模型旁点击 +。只有添加过的模型才会出现在模型选择器中。
  3. 如果想手动输入,点击 + 并填写模型 ID,例如 claude-sonnet-4-6、claude-haiku-4-5 或 gpt-5.5。

模型列表会随时间变化,请以 Get model list 或价格页上的 ID 为准,不要照抄旧截图。

第 4 步:测试并启用

  1. 点击 Test(部分版本叫 Check)并选择一个模型。提示成功说明密钥和地址都正确。
  2. 用服务商页面右上角的开关启用它。已启用的服务商在列表中会显示绿点。
  3. 打开对话,在顶部的模型下拉菜单中选择模型并发送消息。

可选:通过内置 Anthropic 服务商使用 Claude

在 Model Services 中打开 Anthropic,把 APIVAI 密钥粘贴到 API Key,并把 API Address 从 https://api.anthropic.com 改成 https://api.apivai.com。不要加 /v1,地址格式与 Anthropic 官方一致。然后点击 Get model list,添加需要的 Claude 模型并启用该服务商。GPT 模型在这里不可用,请通过第 2 步的自定义服务商使用。Anthropic 格式的更多说明见 Claude API 代理页面。

在 Cherry Studio 中该选哪个模型?

每百万 token 价格,截至 2026-10-07。全部模型见价格页。

模型模型 ID输入输出适合
Claude Sonnet 4.6claude-sonnet-4-6$1.04$5.22日常默认,写作和代码
Claude Sonnet 5.5claude-sonnet-5-5$0.69$3.47更新的 Sonnet,擅长编程
Claude Haiku 4.5claude-haiku-4-5$0.35$1.74快速提问、翻译、摘要
Claude Opus 5.5claude-opus-5-5$1.39$6.96最难的分析和推理
GPT-5.5gpt-5.5$0.77$4.56通用对话的 GPT
GPT-6 Solgpt-6-sol$0.30$1.52更新的 GPT,适合高要求任务
GPT-6 Lunagpt-6-luna$0.0144$0.0768最便宜,适合简单任务

比较实用的搭配是:默认助手用便宜的 Claude Haiku 4.5 或 GPT-6 Luna,主力助手用 Claude Sonnet 4.6,只有真正需要时才用 Claude Opus 5.5。Cherry Studio 可以把同一个问题同时发给多个模型,这是在自己的任务上对比模型的低成本方法。

用 APIVAI 时 Cherry Studio 要花多少钱?

Cherry Studio 本身免费,你只为 token 付费。每条消息都会重新发送之前的对话,所以对话越长,每轮越贵。Thinking 默认开启,思考 token 按输出计费。

  • 日常对话: 假设每轮约 3,000 输入 token(你的消息加最近的历史)和 800 输出 token。用 Claude Sonnet 4.6 一轮花费 $0.0073(官方价 $0.021)。每天 40 轮、持续 30 天(共 1,200 轮),一个月是 $8.76,官方价为 $25.20。同样一个月用 Claude Haiku 4.5 为 $2.93,用 GPT-6 Luna 为 $0.126。
  • 处理长文档: 你粘贴一份约 30,000 token 的报告,再追问 10 个问题,每次重新发送约 31,000 输入 token,返回 1,500 输出 token。用 Claude Sonnet 4.6 这次会话花费 $0.401(官方价 $1.16)。

想省钱,换话题时就新开一个话题,并给 Cherry Studio 单独建一个带预算上限的密钥。控制台会列出每次请求的 token 和费用。更全面的价格对比见 Claude API 价格对比。

Cherry Studio 的知识库能用 APIVAI 吗?

对话可以完全通过 APIVAI 使用,但知识库需要嵌入(embedding)模型来索引文件,而 APIVAI 不提供 embeddings。要使用知识库,请在 Cherry Studio 中为它另外配置一个嵌入模型服务商;负责回答的助手仍然可以是 APIVAI 的 Claude 或 GPT 模型。APIVAI 也不提供图像生成模型。

排错

  • 401 或 “invalid API key”: 密钥复制不完整、已被删除或已用完预算。从控制台重新复制,并检查余额。
  • 404: 地址填错了。自定义服务商填 https://api.apivai.com,不要带 /chat/completions,末尾也不要加 #。Anthropic 服务商填 https://api.apivai.com,不要带 /v1。
  • 找不到模型: 模型 ID 必须完全一致,例如 claude-sonnet-4-6,而不是显示名称。用 Get model list 查看密钥可用的模型。GPT 模型在 Anthropic 服务商下会失败,请加到自定义服务商中。
  • 对话的模型选择里没有该模型: 服务商开关没打开,或者拉取了列表但没有点模型旁边的 +。
  • 回复为空或被截断: 思考 token 也计入输出上限。在助手的 Edit Assistant → Model 标签页中,关闭 Enable message length limit (MaxToken),或把它设为 4096 以上。
  • 回复一次性出现或流式输出中断: 检查同一标签页中的 Streaming output (Stream) 开关,以及 Cherry Studio 网络设置中的代理。
  • 429: 每个密钥默认每分钟 60 次请求。同时对比多个模型会消耗多次请求;稍等片刻,或联系客服提高限额。

全部端点和错误码见文档。

常见问题

Cherry Studio 里应该选 OpenAI 还是 Anthropic?

Claude 和 GPT 一起用,就选带 OpenAI 端点的自定义服务商。只有想以 Anthropic 原生格式使用 Claude 时,才用内置 Anthropic 服务商。

地址需要带 /v1 吗?

不需要。填 https://api.apivai.com,Cherry Studio 会自动加上 /v1 和请求路径。不要填带 /v1/chat/completions 的完整地址。

一个密钥能同时用 Claude 和 GPT 吗?

可以。一个 APIVAI 密钥适用于价格页上的所有模型,两种格式都支持。同一个密钥也能用于 Chatbox 和其他 OpenAI 兼容工具。

APIVAI 会保存我的聊天记录吗?

不会。请求和响应内容不记录日志,只保留用于计费的使用数据,例如模型、token 数和费用。聊天记录保存在你电脑上的 Cherry Studio 里。

有免费试用吗?

没有。预付费、按量计费,$10 起充,无订阅。

注册账号,充值 $10 起,把密钥粘贴到 Cherry Studio 即可。

准备好了吗?

30 秒获取 API 密钥,按量付费使用 Claude 和 GPT