Cherry Studio
Cherry Studio 桌面端接入教程。
Cherry Studio 适合把多个模型统一接到一个桌面客户端里管理。对于大多数普通用户,这是最省事的一种接入方式。
更新基准:本文示例按
2026-04-10当前平台公开模型与分组编写。
(一) 接入前准备
- 一个可用的
sk-...令牌 - 至少一个你准备使用的模型名称
- 已安装的 Cherry Studio 客户端
如果你还没有安装客户端,可以先下载 Cherry Studio:
(二) 添加 4Router 服务商
打开 Cherry Studio 后,新增一个自定义服务商,按下面填写:
| 字段 | 建议值 |
|---|---|
| 服务商名称 | 4Router |
| 协议 / 类型 | OpenAI |
| API Key | 你的 sk-... |
| API 地址 | https://4router.net 或 https://4router.net/v1 |
如果你的 Cherry Studio 版本要求填写完整 OpenAI 兼容地址,优先填:
1https://4router.net/v1
如果它要求的是站点根地址,再填:
1https://4router.net
(三) 添加模型
保存之后,进入这个服务商的模型管理页面,把你要用的模型手动加进去。
建议优先按分组加模型:
AppCodex:gpt-5.4、gpt-5.4-miniAppClaude:claude-opus-4-6、claude-sonnet-4-6
如果你在控制台或令牌页面看到了分组选项,通常可以这样理解:
AppCodex:给 GPT / Codex 系列模型使用AppClaude:给 Claude 系列模型使用
(四) 推荐操作顺序
- 打开
设置 - 进入
模型服务 - 新增一个
自定义服务商 - 按上面的字段填写
4Router - 保存
- 进入模型管理,手动添加模型名称
- 新建对话并切换到刚添加的模型
(五) 第一次测试
建议先各测一条:
1模型:gpt-5.4
2请只回复:4Router one 已连接
1模型:claude-opus-4-6
2请只回复:4Router AppClaude 已连接
如果这两条都能正常返回,说明你的桌面端配置和分组权限都基本没有问题。
(六) 如果你主要使用 Claude
如果你想把 Claude 模型单独拆成一个服务商,也可以再新增一个 Anthropic 类型入口:
| 字段 | 建议值 |
|---|---|
| 服务商名称 | 4Router Claude |
| 协议 / 类型 | Anthropic |
| API Key | 你的 sk-... |
| API 地址 | https://4router.net |
大多数情况下没有必要单独拆第二个入口,直接用上面的 OpenAI 方式就够了。
(七) 常见问题
- 模型列表为空:通常不是接口坏了,而是你还没有在 Cherry Studio 里把模型手动添加进去。
- 提示鉴权失败:重新复制
sk-...,确认前后没有空格。 - Claude 模型不可用:先检查你的令牌是否包含
AppClaude分组可用范围。 - GPT 模型不可用:先检查你的令牌是否包含
AppCodex分组可用范围。 - 某个模型不能用:请确认该模型对你的账户是否可用。
- 填了地址还是报错:优先在
https://4router.net和https://4router.net/v1之间切换测试一次。