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.nethttps://4router.net/v1

如果你的 Cherry Studio 版本要求填写完整 OpenAI 兼容地址,优先填:

1https://4router.net/v1

如果它要求的是站点根地址,再填:

1https://4router.net

(三) 添加模型

保存之后,进入这个服务商的模型管理页面,把你要用的模型手动加进去。

建议优先按分组加模型:

  • AppCodexgpt-5.4gpt-5.4-mini
  • AppClaudeclaude-opus-4-6claude-sonnet-4-6

如果你在控制台或令牌页面看到了分组选项,通常可以这样理解:

  • AppCodex:给 GPT / Codex 系列模型使用
  • AppClaude:给 Claude 系列模型使用

(四) 推荐操作顺序

  1. 打开 设置
  2. 进入 模型服务
  3. 新增一个 自定义服务商
  4. 按上面的字段填写 4Router
  5. 保存
  6. 进入模型管理,手动添加模型名称
  7. 新建对话并切换到刚添加的模型

(五) 第一次测试

建议先各测一条:

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.nethttps://4router.net/v1 之间切换测试一次。