主题
Cherry Studio
Cherry Studio 是图形化客户端。自定义提供商里填 根地址 https://aicode.cat,不要再加 /v1——软件会自己拼 /v1/chat/completions 或 /v1/messages。
先到 创建 API Key 拿一把 Key。模型名以 主站控制台 为准。
| 要接的模型 | 填在哪一栏 | 地址 | Key |
|---|---|---|---|
| GPT / OpenAI | OpenAI | https://aicode.cat | 对应分组的 Key |
| Claude | Anthropic | https://aicode.cat | 必须用 Claude 分组 的 Key |
GPT 和 Claude 要各加一次服务商,不要把两个地址填进同一张表。
Key 的分组决定能勾到哪些模型
Cherry Studio 会把该服务商下你这把 Key 能用的模型列出来(第 4 步的「选择模型」)。列表空、或只有寥寥几个,多半是分组不对:分组里没有的模型不会出现,也调不通。分组与可用模型的关系、6 步排查见 创建 API Key。
1. 下载并打开设置
- 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/...。

点 添加。
接 Claude
再添加一次服务商,把地址填在 Anthropic 栏,同样是 https://aicode.cat。请求路径应显示 https://aicode.cat/v1/messages。
这把 Key 在主站必须属于 Claude 分组,不要用 GPT 分组的 Key 去打 Claude。

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

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

失败先看 常见报错。
Gemini
若还要接 Gemini,在对应栏填 https://aicode.cat/v1beta。上面截图是 GPT / Claude 流程。