Cherry Studio

在初始化向导中添加 AIHubMix

首次启动后会进入初始化向导。在 选择服务商 页面点击 + 添加服务商。

在 添加自定义提供商 窗口中填写以下内容，然后点击添加：

在 选择模型 中搜索并勾选要使用的模型，然后点击 添加所选模型。

在 请选择要检测的模型 中选择一个模型，点击开始。

如果检测失败，请先关闭 VPN 后重试。

在 选择默认模型 中设置默认助手模型、快速模型和翻译模型，点击 开始使用。

初始化完成后，可以在 设置 → 模型服务 中修改服务商和模型。

常见问题

模型无法识别图片

在 设置 → 模型服务 中打开该模型的编辑页，在 输入模态 中启用视觉。

gemini-3-pro-image-preview 在开启流式输出时无法返回图片。使用该模型时，请关闭流式输出。

调用 Claude 模型返回 AI_APICallError

检查错误信息中的请求地址是否为 https://aihubmix.com/anthropic/v1/messages。如果是，请在服务商的 Anthropic 端点设置中将地址改为 https://aihubmix.com。

启用 Claude 提示词缓存

提示词缓存选项只在服务商包含 Anthropic 端点时显示。在添加自定义服务商时通过 更多设置 添加 Anthropic 端点后，打开该服务商的 API 设置，按需配置：

缓存 Token 阈值：消息超过该 Token 数才会缓存，设为 0 表示不缓存

缓存系统消息：是否缓存系统提示词

缓存最后 N 条消息：缓存最后 N 条对话消息，不含系统消息

缓存时长：5 分钟或 1 小时，写入 1 小时缓存的费用更高

配置后，Cherry Studio 会为 Claude 模型自动注入 cache_control。各项说明见 Claude 提示词缓存。

更新时间：2026-11-04

下载 Cherry Studio