Cherry Studio 接入 CaMeL Hub:一个密钥用遍 GPT、Claude、Gemini、DeepSeek

Cherry Studio 是一款免费开源的桌面端 AI 客户端,支持 Windows / macOS / Linux,集成多模型对话、知识库(RAG)、翻译、多模型对比等功能。把它接到 CaMeL Hub 后,一个 API 密钥就能通过同一个 OpenAI 兼容接口调用 GPT、Claude、Gemini、DeepSeek 等主流模型 —— 不用分别注册各家账号,也不用为了换一个模型系列反复切换密钥。

Cherry Studio ↗

  1. 获取 CaMeL Hub API 密钥

    登录 CaMeL Hub 控制台,进入密钥管理页面,新建一个密钥(或直接复用已有的)并复制,下一步会用到。
  2. 安装 Cherry Studio

    在官网下载对应系统的安装包并安装。添加自定义模型服务不需要额外注册 Cherry Studio 账号。
  3. 把 CaMeL Hub 添加为模型服务商

    打开「设置 → 模型服务」,点击添加服务商,类型选择 OpenAI,名称随意填(比如「CaMeL Hub」)。把密钥粘贴进名为「API 密钥」的字段,再把名为「API 地址 / Base URL」的字段改成下面这个地址 —— 这是 CaMeL Hub 上所有模型统一走的 OpenAI 兼容接口。
    https://api.camel-hub.com/v1
  4. 添加需要用的模型

    在同一个服务商面板里点击添加模型,把模型 ID 从 CaMeL Hub 控制台的模型列表里原样复制粘贴进去(区分大小写)。几个跨厂商的常用起点:
    claude-sonnet-5
    gpt-5.5
    deepseek-v4-flash
    gemini-3.5-flash
    gpt-image-2
  5. 验证连接

    点服务商旁边的检查 / 验证按钮,或者直接新建一个对话发条消息测试。验证通过或收到正常回复,就说明密钥和地址都配对了。
  6. (可选)把 Claude 加成原生 Anthropic 服务商

    如果想用 Cherry Studio 的 Anthropic 类型服务商(而不是走 OpenAI 兼容那条路)来调用 Claude,再新建一个服务商,类型选 Anthropic,把 API Host 改成下面这个裸域名,不要带 /v1 —— Cherry Studio 会自己在后面拼上 /v1/messages,这跟它直连 Anthropic 官方 api.anthropic.com 时的做法一致。
    https://api.camel-hub.com
  7. 按需给单个模型打开图片 / 工具调用开关

    Cherry Studio 不会总是自动识别自定义模型的能力。如果某个模型支持读图或函数调用,记得在该模型的设置里手动勾上对应能力开关,否则即便模型本身能看图,Cherry Studio 也可能不会把图片一起发过去。

常见问题

添加服务商后模型列表一直是空的,或者密钥明明是对的却一直验证失败。

先检查 API 地址有没有多打的斜杠或拼写错误,再确认密钥没有过期。如果还是不行,这种情况几乎都是网络链路问题,不是密钥本身的问题:公司防火墙、部分 VPN 客户端、某些 DNS-over-HTTPS 设置都可能拦截或改写发往 api.camel-hub.com 的请求。换个网络环境或临时关掉 VPN 再验证一次。

上传的图片模型好像看不到。

去 Cherry Studio 服务商设置里给这个模型手动打开「视觉 / 图片」能力开关(见第 7 步)。如果用的是图像预览类的多模态模型且在流式模式下无法返回图片,记得关闭该模型的流式输出 —— 具体以 CaMeL Hub 该模型页面的说明为准。

调用 Claude 模型报 AI_APICallError。

通常是服务商类型和地址没对上。如果 Claude 加在 OpenAI 兼容服务商下,地址用 https://api.camel-hub.com/v1 不用改;如果加在 Cherry Studio 原生的 Anthropic 服务商下,API Host 必须是裸域名 https://api.camel-hub.com(不带 /v1)—— 这种类型下 Cherry Studio 会自动在后面拼上 /v1/messages。

Cherry Studio 里该选哪些模型?

日常对话和写代码,claude-sonnet-5 或 gpt-5.5 都是稳妥的默认选择;想要更快更省,用 gemini-3.5-flash 或 deepseek-v4-flash;要用 Cherry Studio 的绘图功能,选 gpt-image-2。