Cherry Studio 接入教程

Cherry Studio 是一款功能强大的桌面端 AI 对话客户端，支持 Windows / macOS / Linux，界面美观操作简单。

前置条件

1. 前往 一元模型控制台 获取 API Key

1. 下载安装

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

2. API 配置（关键步骤）

打开设置 (Ctrl+, / Cmd+,) → Providers (模型服务商)。

配置 Claude 模型

• API Key: 填入密钥（令牌分组选 cc7）
• API URL: https://timesniper.club/v1
• 添加模型名：claude-opus-4-6、claude-sonnet-4-5

配置 GPT 模型

• 使用 gpt 分组的令牌
• 添加模型名：gpt-4o

⚠️ 端点类型务必选择 OpenAI-Response，否则可能无法正常使用！ 不同模型需要使用对应分组的令牌（Claude → cc7，GPT → gpt）。

3. 使用

在主界面切换服务商和模型即可对话。支持拖入图片进行多模态交互。

---

常见问题与异常处理 (FAQ)

错误	原因	解决方案
401 Unauthorized	API Key 错误或为空	前往 一元模型控制台 重新获取密钥
404 Not Found	接口地址格式错误	确认 Base URL 是否正确（大部分需要 https://timesniper.club/v1）
429 Too Many Requests	请求频繁或额度耗尽	等待冷却或在充值页面充值
连接超时 / Network Error	网络或代理冲突	检查代理/VPN，确认 URL 无空格
SSE 流式输出乱码	端点类型不匹配	将端点类型改为 OpenAI 或 OpenAI-Response

提示: 如果依然无法解决，请携带完整报错截图到客服群中寻求帮助。