Skip to content

Cherry Studio ​

Cherry Studio 是图形化客户端。自定义提供商里填 根地址 https://aicode.cat,不要再加 /v1——软件会自己拼 /v1/chat/completions 或 /v1/messages。

先到 创建 API Key 拿一把 Key。模型名以 主站控制台 为准。

要接的模型填在哪一栏地址Key
GPT / OpenAIOpenAIhttps://aicode.cat对应分组的 Key
ClaudeAnthropichttps://aicode.cat必须用 Claude 分组 的 Key

GPT 和 Claude 要各加一次服务商,不要把两个地址填进同一张表。

Key 的分组决定能勾到哪些模型

Cherry Studio 会把该服务商下你这把 Key 能用的模型列出来(第 4 步的「选择模型」)。列表空、或只有寥寥几个,多半是分组不对:分组里没有的模型不会出现,也调不通。分组与可用模型的关系、6 步排查见 创建 API Key。

1. 下载并打开设置 ​

官网:https://www.cherry-ai.com/

  • Windows:下载 .exe 按向导安装
  • macOS:下载 .dmg 拖到 Applications
  • Linux:下载 .AppImage 或 .deb / .rpm

打开后点左下角齿轮进入设置。

打开设置

2. 添加服务商 ​

左侧保持「模型服务」,把中间列表滚到底,点 + 添加服务商。

添加服务商

3. 填名称、Key 和地址 ​

提供商名称可填 aicodecat。API 密钥用仪表盘里刚复制的 Key,点复制图标复制,不要手动框选(容易漏字符或带上换行)。

接 GPT ​

端点用 OpenAI 这一栏,地址填:

文本
https://aicode.cat

填完后下方应显示请求路径 https://aicode.cat/v1/chat/completions。不要改成 https://aicode.cat/v1,会拼成 /v1/v1/...。

填写 OpenAI 地址和 Key

点 添加。

接 Claude ​

再添加一次服务商,把地址填在 Anthropic 栏,同样是 https://aicode.cat。请求路径应显示 https://aicode.cat/v1/messages。

这把 Key 在主站必须属于 Claude 分组,不要用 GPT 分组的 Key 去打 Claude。

填写 Anthropic 地址

点 添加。

4. 勾选模型 ​

弹出「选择模型」后点 全选,再点 添加所选模型。

全选模型

5. 看到添加成功即可用 ​

出现「添加所选模型 / 验证 … / 启用服务商」都打勾,点 完成。在对话里选刚加的模型,发一句「回复 ok」。

添加成功

失败先看 常见报错。

Gemini

若还要接 Gemini,在对应栏填 https://aicode.cat/v1beta。上面截图是 GPT / Claude 流程。