---
url: https://limapi.com/docs/agents/cherry-studio.md
---
# Cherry Studio

Cherry Studio 是一款开源的 AI 桌面客户端，支持同时管理多个服务商与模型，适合日常对话、翻译、写作等场景。通过 OpenAI 兼容端点即可接入 LimAPI。

## 安装 Cherry Studio

前往 [Cherry Studio 下载页面](https://www.cherry-ai.com/download)，根据操作系统（macOS / Windows / Linux）下载安装包并完成安装。

## 配置接入凭证

1. 打开 Cherry Studio，点击右上角 **设置** 按钮，进入「模型服务」栏。
2. 点击 **添加**，填写供应商名称（如 `LimAPI`），提供商类型选择 **OpenAI**。
3. 填入以下配置：

| 配置项 | 填写内容 |
|--------|----------|
| API 密钥 | [Portal](https://limapi.com/) 创建的 API Key（`sk-` 开头） |
| API 地址 | `https://limapi.com/api/v1` |
| 模型 | 在「模型 ID」中填入平台支持的模型，如 `qwen3.8-max`、`claude-sonnet-4-6` |

::: tip 查询可用模型
不确定填什么模型时，调用 `GET /api/v1/models` 或在 Portal「模型广场」查看完整列表与定价。
:::

## 验证配置

在模型 ID 填入需要使用的模型，点击 **添加**。返回对话界面，在顶部切换到 `LimAPI` 供应商，输入任意问题，模型正常返回响应即配置成功。

## 常见问题

### 报错 The value of the enable\_thinking parameter is restricted to True

**原因**：所选模型仅支持在思考模式下运行，但客户端未开启思考模式。

**解决方案**：在模型设置中开启「思考模式」（或换用非强制思考的模型）。

### 提示 401 / Incorrect API key

* 确认 API Key 复制完整、无首尾空格；
* 确认 API 地址填写为 `https://limapi.com/api/v1`（注意末尾的 `/v1`）。

### 想同时使用 Anthropic 协议模型？

Cherry Studio 亦可添加 **Anthropic** 类型供应商，API 地址填 `https://limapi.com/api/anthropic`，即可在同一客户端中切换两大协议的模型。