许多人把 Cherry Studio 装好之后，就卡在了同一个环节：不知道 API 地址该填什么、模型名怎么写，往往一发消息就报错。这篇文章要解决的就是这个问题——怎么用一把 Key，在 Cherry Studio 里同时把 OpenAI、Claude、Gemini 等几家模型都跑起来，配置一次，多个模型随意切换。下面重点讲清楚三个最容易填错的地方，再附上一份避坑清单。

先说清楚：为什么要这么配

Cherry Studio 是一款开源的桌面端多模型聊天客户端，能做对话、知识库、AI 绘图、一问多答这些事。但它本身不提供模型，得靠你去配置”模型服务商”来接外部 API。

新手最头疼的地方一般是：想用 GPT，又想试 Claude，还想看看 Gemini，结果得分别去三家平台注册、充值、管着三套 Key，花钱费心都不划算。

Code0 是一个面向开发者的多模型聚合 API 中转服务，核心就是”一个 Key 接入 OpenAI / Anthropic / Gemini 等主流模型”。它兼容 OpenAI 风格接口，官网公开表达支持 500+ 模型、40+ 接入服务商。对 Cherry Studio 用户来说，这意味着你只要配一个服务商，就能在下拉菜单里随手切换多家模型。

准备两样东西

第一，下载 Cherry Studio。从官方渠道下对应系统的安装包（Windows、macOS、Linux 都有），装完打开即可。

第二，注册 Code0 并创建 API Key。提议专门给 Cherry Studio 单独建一把 Key，好处是能单独统计这个客户端消耗了多少，随时能禁用，也不影响你在别的工具上的使用。

创建时留意两点：Key 字符串要保存好（一般只完整显示一次）；注意 Key 的分组和权限设置，后面接图像模型会用到。

核心三步：新增 Code0 服务商

下面提到的菜单名，以你当前版本为准（不同版本对”模型服务/供应商”的叫法略有差异），逻辑是一样的。

第一步，新增服务商。 打开设置 → 模型服务（模型服务商），在列表底部找到”添加”入口，新增一个自定义服务商。类型选 OpenAI 兼容（Code0 走的就是 OpenAI 风格接口），名称随意填，列如 Code0。

第二步，填 Base URL 和 Key。 这两项最容易踩坑：

• API 地址 / Base URL：默认填 https://code0.ai/v1
• API 密钥：把你在 Code0 控制台创建的 Key 粘进去

关于 /v1 这个路径带不带，判断很简单：Cherry Studio 的 OpenAI 兼容模式一般需要一个包含 /v1 的完整地址。如果填了之后测试失败，就把 /v1 去掉或补上再试一遍——不同版本对末尾路径的处理不一样，两种写法都试，很快能定位问题。

万一连接超时或节点异常，可以把 Base URL 换成 https://hk.code0.ai（同样注意 /v1 怎么拼），这是排查网络问题时的备用节点。

第三步，添加模型。 地址和 Key 填好后，进到这个服务商下的”模型”区域，手动把要用的模型加进来。这一步的关键是模型 ID 必定要填对。

模型 ID 怎么填才不出错

模型 ID 不能随意写，也不是写”GPT””Claude”这种泛称就行。正确做法是以 Code0 控制台 / 模型列表当前可见的模型 ID 为准，直接复制过来。注意模型 ID 一般区分大小写，多一个空格、连字符错了，都会报”模型不存在”。

几个可以参考的示例（具体能否调用，以模型列表当前可见为准）：

• OpenAI：gpt-5.5、GPT-5.4
• Gemini：gemini-3-pro-preview、Gemini 3 Pro
• Claude：claude-opus-4-8、claude-opus-4-7、claude-sonnet-5、claude-sonnet-4-6、claude-haiku-4-5-20251001

你不用为不同厂商建好几个服务商——同一个 Code0 服务商底下，就能挂载来自多家厂商的模型。

加完之后回到对话界面，在顶部选中刚加的模型，发一句”你好”。能正常回复就说明接入成功了；报错就对照后面的清单排查。

接进来之后，最实用的功能是一问多答

把好几家模型都接进来后，Cherry Studio 有一个很值得用的功能：一问多答。同一个问题，让多个模型一起回答，横向对比。

操作上，在对话界面找到”添加助手/多模型”相关入口（有些版本是在对话上方用模型标签、或用”@”添加多个模型），把想对比的几个模型加进去，发一条消息，就能看到各模型并排给出的回答。判断”同一个 prompt 到底哪个模型更合适”时特别好用，这也是多模型客户端相比单模型工具的核心优势。

图像模型接入：这里有几个专属的坑

文生图模型是多数教程不提的部分，但它偏偏有专属的坑，单独说一下。

配置方式一样，在 Code0 服务商下加对应的模型 ID，列如 gpt-image-2、
gemini-3-pro-image-preview、gemini-2.5-flash-image（以模型列表当前可见为准）。

有个接口差异要特别注意：

• gpt-image-2 / image2 这类模型：调用前先确认这把 Key 的分组选的是 gpt。分组或权限对不上，最常见的报错就是”无可用渠道”。
• Gemini 图片模型：支持设置宽高比、清晰度，也有图片编辑等能力，按需在参数里配置即可。

这里只讲配置和能力，出图效果得看 prompt 和模型本身，不做质量承诺。

常见报错避坑清单

新手阶段碰到的报错，绝大多数都能对号入座。

401 / 鉴权失败 缘由：Key 填错或失效，也可能 Base URL 写错。 处理：核对 Key 有没有完整粘贴、/v1 路径对不对。

无可用渠道 缘由：一般跟 Key 的分组或权限有关，图像模型尤其容易碰上（列如 gpt-image-2 得把分组选成 gpt）。 处理：检查这个模型是不是在你 Key 的可用范围里。

模型不存在 / 无此模型 缘由：模型 ID 拼错、大小写不对，或这个模型不在你的列表里。 处理：对照控制台模型列表重新复制一遍 ID。

连接超时 / 无响应 缘由：多半是网络或节点问题。 处理：把 Base URL 换成 https://hk.code0.ai。

排查顺序提议这样走：先确认 Key 和 Base URL（解决 401）→ 再确认模型 ID（解决模型不存在）→ 最后处理分组和网络。

计费和多 Key 管理，几个关键口径

• 额度展示：Code0 站内用 $ 显示额度和消耗，可以按 1.5 RMB = 1 美元 API 额度这个口径去换算理解。
• 失败不计费：请求失败不产生费用，调试期反复试错的顾虑小许多。
• 充值开票：支持人民币充值，也能开票，个人和团队报销都方便。

Key 的管理上，除了给 Cherry Studio 单独建 Key，还能做多 Key 管理与轮询：给不同工具、不同项目分别建 Key，一来消耗统计得清楚，二来某把 Key 达到限额或出问题时能切换。给每把 Key 设个合理的额度上限，也是控成本、防误用的实用做法。

这套配置思路，其他工具也能复用

Code0 的 Key 不只能给 Cherry Studio 用。只要一个工具支持 OpenAI 兼容接口，配置逻辑就是同一套：换 Base URL、填 Key、把模型名写对。

常见能复用的工具，包括 Claude Code、Cursor、Codex、Gemini CLI、Roo Code、Trae IDE、Dify、Chatbox 等。以命令行或 IDE 类工具为例，一般就是在环境变量或配置项里设 base_url、api_key、model 三个字段，把 base_url 指向 https://code0.ai/v1、填同一把 Key、写上目标模型 ID 就行。搞懂了 Cherry Studio 这套，迁到别的工具几乎不用再额外学什么。

几个常见疑问

菜单名跟教程对不上怎么办？ Cherry Studio 更新挺勤，”模型服务””供应商””模型服务商”这些叫法可能随版本变。按”设置 → 找到模型服务相关入口 → 添加 OpenAI 兼容服务商”这个逻辑走就行，名字不一样不影响路径。

列表里找不到想用的模型？ 以 Code0 控制台 / 模型列表当前可见为准。列表里没有的，说明当前不可用或需要去控制台确认，别凭记忆硬填 ID。

填了 /v1 还是连不上？ 先把 /v1 去掉、加上各试一遍；还不行就换到 https://hk.code0.ai 节点，再回到清单核对 Key 和分组。

一把 Key 同时给几个工具用，会冲突吗？ 不会由于共用而冲突。但从成本统计和风险隔离看，还是提议按工具或项目拆成多把 Key。

按上面的步骤走下来，Cherry Studio 就能变成一个真正的多模型工作台：配一次服务商，多家模型随时切、随时对比。真遇到问题时，回到”Key / Base URL / 模型 ID / 分组”这四个维度挨个排查，绝大多数接入障碍都能自己搞定。想找这类多模型聚合服务时，Code0 是可以了解一下的一个选项。