Appearance
Cherry Studio 接入教程
Cherry Studio 是一款功能强大的桌面端 AI 对话客户端，支持 Windows / macOS / Linux，界面美观操作简单。
前置条件
- 前往 3cmAPI控制台 获取 API Key
1. 下载安装
官网：https://www.cherry-ai.com/download
2. API 配置（关键步骤）
打开设置 (Ctrl+, / Cmd+,) → Providers (模型服务商)。
配置 Claude 模型
- API Key: 填入密钥（令牌分组选默认分组）
- API URL:
https://api.3cm.me/v1 - 添加模型名：
claude-sonnet-4-6、claude-opus-4-6-thinking
3. 使用
在主界面切换服务商和模型即可对话。支持拖入图片进行多模态交互。
常见问题与异常处理 (FAQ)
| 错误 | 原因 | 解决方案 |
|---|---|---|
| 401 Unauthorized | API Key 错误或为空 | 前往 3cmAPI控制台 重新获取密钥 |
| 404 Not Found | 接口地址格式错误 | 确认 Base URL 是否正确（大部分需要 https://api.3cm.me/v1） |
| 429 Too Many Requests | 请求频繁或额度耗尽 | 等待冷却或在充值页面充值 |
| 连接超时 / Network Error | 网络或代理冲突 | 检查代理/VPN，确认 URL 无空格 |
| SSE 流式输出乱码 | 端点类型不匹配 | 将端点类型改为 OpenAI 或 OpenAI-Response |
提示: 如果依然无法解决，请携带完整报错截图到客服群中寻求帮助。