Cherry Studio

Cherry Studio 是免费开源的桌面 AI 聊天客户端，支持 Windows / macOS / Linux。不用写代码，装好点几下就能用。

如果你是完全的新手，从这一页开始最合适。

先下载安装

到 GitHub Releases 下载对应系统的安装包：

系统	下载哪个
Windows	`.exe` 安装包
macOS	`.dmg`
Linux	`.AppImage` 或 `.deb`

装好打开，就进入下面的配置。

配置（5 步）

好消息

Cherry Studio 内置了 New API 服务商，而我们的系统就是这一系。选它的话，一个地址就能同时用上对话、联网搜索和 Claude 格式接口，不用为每种协议单独配一遍。

1. 先拿到 API Key

打开 https://api.wxiai.com/token，登录后点「新建令牌」，复制那串 sk- 开头的字符。

2. 打开设置

点 Cherry Studio 界面左下角的齿轮图标，进入设置。

3. 找到 New API

在设置里选 「模型服务」，然后在左侧服务商列表里找到 「New API」。

4. 填两个东西

填什么	填成什么
API 密钥	你刚复制的 `sk-...`
API 地址	`https://api.wxiai.com`

API 地址不要带 /v1

	填写内容
正确	`https://api.wxiai.com`
错误	`https://api.wxiai.com/v1`
错误	`https://api.wxiai.com/v1/chat/completions`

Cherry Studio 会自己补上 /v1/chat/completions。你多填了就会变成 /v1/v1/... 或更长的路径，直接报错。

5. 加模型 + 打开开关

点 「获取模型列表」，让它自动拉一份；拉不到就点 「+」 手动输入模型 ID（比如 grok-4.6）。
点 「检测」 按钮，确认能连通。
把右上角的启用开关打开（绿色圆点）。

第 3 步最容易忘

「配置填好了但聊天界面里找不到模型」——九成是忘记打开启用开关。回头看一眼右上角那个开关。

开始聊天

回到聊天界面，在模型选择器里就能选到刚添加的模型，直接开始对话。

Cherry Studio 还有一些现成的好处：

多模型同时回答：同一个问题让几个模型一起答，对比效果。
知识库：上传 PDF / Word，让 AI 基于你的文档回答。
300+ 预设助手：翻译、写作、编程等场景，开箱即用。

出问题了看这里

现象	原因	怎么办
检测失败	Key 或地址填错	Key 重新复制一遍（注意别带空格）；地址只留 `https://api.wxiai.com`
模型列表是空的	自定义服务商不会自动全选模型	点「+」手动输入模型 ID，名字用 `GET /v1/models` 查到的
配好了但聊天界面看不到模型	启用开关没开	回设置打开右上角开关
`401`	Key 无效	重新建一个令牌
`404`	地址填多了	只填根地址，不带 `/v1`
`429`	请求太频繁	降低频率，或联系客服提升并发

进阶：想用图像生成？

我们的图像能力（grok-imagine-image 系列）是独立的接口路径。Cherry Studio 的图像生成需要在服务商配置里单独填「图像生成 Base URL」。

这块我还没实测过，如果你要用，建议先用图像生成 API 文档里的 curl 命令确认能出图，再回客户端配置。

Cherry Studio

先下载安装 ​

配置（5 步） ​

1. 先拿到 API Key ​

2. 打开设置 ​

3. 找到 New API ​

4. 填两个东西 ​

5. 加模型 + 打开开关 ​

开始聊天 ​

出问题了看这里 ​

进阶：想用图像生成？ ​

相关页 ​