> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cherry Studio AI对话客户端配置指南

> Cherry Studio配置老张API教程，使用GPT、Claude、Gemini等200+AI模型

## 应用简介

Cherry Studio 是一款功能强大的 AI 对话客户端，支持多种大语言模型。通过 老张API，您可以在 Cherry Studio 中使用各种主流 AI 模型。

## 快速集成

### 1. 获取 API 密钥

访问 [老张API控制台](https://api2.laozhang.ai) 获取您的 API 密钥。

### 2. 配置步骤

<img src="https://mintcdn.com/laozhangai-edd05f2c/_loZ0Jy0ZI__xJ9z/images/cherry-studio-config.png?fit=max&auto=format&n=_loZ0Jy0ZI__xJ9z&q=85&s=f5cd06c526e809392ab0468c60537e5e" alt="Cherry Studio OpenAI兼容配置界面" width="2282" height="1696" data-path="images/cherry-studio-config.png" />

按照上图所示，完成以下配置步骤：

1. 打开 Cherry Studio 应用
2. 点击左侧的设置图标进入设置页面
3. 选择"模型服务"选项
4. 在模型提供商列表中创建自定义渠道【老张API】
5. 填写配置信息：
   * **API 地址**：`https://api2.laozhang.ai`（图中红框标注的也行）
   * **API 密钥**：输入您从老张API控制台获取的密钥
6. 点击底部的"➕ 添加"按钮保存配置

<Info>
  **配置要点**

  * API地址务必使用：`https://api2.laozhang.ai`
  * API密钥可在老张API控制台的"API密钥"页面获取
  * 建议先测试连接确保配置正确
</Info>

### 3. 添加模型

完成基础配置后，按照上图右侧的模型选择界面添加所需模型：

1. 在模型搜索框中查找所需模型（如 `claude-opus-4-7`、`gpt-5.5` 或 `gemini-3.1-pro-preview`）
2. 点击模型名称旁的图标来选择或配置模型
3. 根据需要启用或禁用不同的模型变体：
   * 标准版本（如 `gpt-5.5`、`claude-sonnet-4-6`）
   * 思维链版本（如 `claude-opus-4-7-thinking`）
4. 可以通过右侧按钮进行详细配置

## 支持的模型

根据上图显示，Cherry Studio 通过 老张API 支持以下主流模型：

### 最新推荐模型

| 模型系列                       | 模型 ID                    | 特点                                |
| -------------------------- | ------------------------ | --------------------------------- |
| **OpenAI GPT-5.5**         | `gpt-5.5`                | OpenAI 最新旗舰，适合复杂专业任务              |
| **Claude Opus 4.7**        | `claude-opus-4-7`        | Anthropic 当前最强模型，适合编程 Agent 和复杂推理 |
| **Claude Sonnet 4.6**      | `claude-sonnet-4-6`      | 平衡性能与成本，适合日常开发和长文本                |
| **Gemini 3.1 Pro Preview** | `gemini-3.1-pro-preview` | Google 最新 Pro 预览模型，适合多模态和长上下文     |
| **Gemini 3 Flash Preview** | `gemini-3-flash-preview` | 快速响应版本，适合日常对话和批量任务                |

### 经典稳定模型

| 模型系列                     | 模型 ID                      | 适用场景         |
| ------------------------ | -------------------------- | ------------ |
| **Claude Opus Thinking** | `claude-opus-4-7-thinking` | 复杂推理，思维分析    |
| **Gemini 2.5 Pro**       | `gemini-2.5-pro`           | 稳定生产，多模态长上下文 |
| **GPT-4.1 Mini**         | `gpt-4.1-mini`             | 轻量任务，成本敏感场景  |

<Tip>
  **模型选择建议**

  * 多模态任务：推荐 Gemini 2.5 Pro
  * 日常对话：推荐 GPT-5.5 或 Claude Sonnet 4.6
  * 长文本处理：推荐 Gemini 3.1 Pro Preview 或 Claude Opus 4.7
  * 复杂推理：推荐带 `-thinking` 后缀的 Claude 模型
</Tip>

## 高级功能

### 图片支持

如果使用支持图片的模型（如 GPT-4V）：

1. 在设置中开启"图片"选项
2. 选择支持视觉的模型
3. 在对话中上传图片

### 流式输出

Cherry Studio 默认支持流式输出，提供更好的体验。

## 故障排除

### 连接失败

* 检查 API 密钥是否正确
* 确认 API 地址：`https://api2.laozhang.ai`
* 验证网络连接状态

### 模型不可用

* 确认账户余额充足
* 检查模型是否在订阅计划内
* 尝试其他模型

## 使用技巧

1. **合理选择模型**：根据任务需求选择合适的模型
2. **定期更新**：关注新模型的发布
3. **监控使用**：通过 老张API 控制台查看使用情况

需要更多帮助？请访问 [老张API官网](https://api2.laozhang.ai)。