Cherry Studio
功能较全的桌面客户端，适合需要管理多个模型、多助手场景。
| 系统 | 安装包 |
|---|---|
| Windows (x64 / ARM64) | setup.exe 安装版，或 portable.exe 免安装版 |
| macOS (Intel / Apple Silicon) | 按处理器架构选 .dmg；首次打开被拦截时到「隐私与安全性」允许 |
| Linux (x86_64 / ARM64) | Debian/Ubuntu 用 .deb，Fedora/RHEL 用 .rpm，其他发行版用 .AppImage |
配置
三个系统步骤一致。
-
启动后点 选择其他服务商
-
左下角点 添加
-
填写：
字段 填什么 提供商名称 TokenRoute（可自定义）供应商类型 OpenAI API Key 你的 API Key API 地址 https://api.smartwan.com -
点 获取模型列表
-
点右侧 一键添加所有模型，或手动挑需要的
-
回 首页，在默认助手的模型选择器里选一个 TokenRoute 模型
Cherry Studio 会自动识别模型支持的能力类型；识别不准时点 ⚙️ 手动调整。
验证
首页选好模型后发送：
你好，请回复：Cherry Studio 配置成功
遇到问题
| 现象 | 原因 |
|---|---|
| 获取模型列表失败 | API 地址或 Key 填错；确认地址是 https://api.smartwan.com，不带 /v1 |
| 添加了模型但对话报错 | 检查账户额度，以及该模型是否在此 Key 的可用范围内 |
| 模型能力识别不对 | 点 ⚙️ 手动开启图片、工具等能力 |
更多见常见问题。