Cherry Studio 接入词元圈完整教程

Cherry Studio 是一款开源的 AI 客户端工具,支持接入多种 OpenAI 兼容的 API 服务。本文将详细介绍如何将词元圈接入 Cherry Studio,5 分钟完成配置。
Cherry Studio 简介
Cherry Studio 是一款跨平台的桌面 AI 客户端,支持 Windows、macOS 和 Linux。它的核心特点包括:
- 多模型切换:在同一界面内快速切换不同的 AI 模型
- OpenAI 兼容:支持所有兼容 OpenAI API 格式的服务
- 会话管理:支持多轮对话、会话历史、导出等功能
- 本地优先:数据存储在本地,隐私有保障
- 免费开源:完全免费使用,代码开源透明
第一步:下载安装 Cherry Studio
访问 Cherry Studio 官方网站,下载适合你操作系统的版本:
- Windows:下载 .exe 安装包,双击安装即可
- macOS:下载 .dmg 文件,拖入 Applications 文件夹
- Linux:下载 .AppImage 或 .deb 包
安装完成后启动 Cherry Studio,你会看到一个简洁的对话界面。
第二步:配置词元圈 API

2.1 添加供应商
在 Cherry Studio 左侧菜单中找到 「设置」,然后点击 「供应商」 或 「API Providers」。点击 「添加」 按钮,选择 「OpenAI 兼容」 类型。
2.2 填写配置信息
在弹出的配置窗口中,填入以下信息:
| 配置项 | 填写内容 |
|---|---|
| 名称 | 词元圈 或任意名称 |
| API Base URL | https://www.ciyuano.com/v1 |
| API Key | 在词元圈用户中心获取的 API Key |
| 模型 | 手动添加或点击「获取模型列表」 |
2.3 保存并测试
填写完成后点击 「保存」。然后回到对话界面,在顶部模型选择器中选择你刚添加的供应商和模型,发送一条测试消息,确认能正常收到回复。
第三步:选择合适的模型

词元圈目前支持以下主流模型,你可以根据需求选择:
| 模型 | 特点 | 适用场景 | 价格 |
|---|---|---|---|
| DeepSeek V4 | 通用能力强,中英文均衡 | 日常对话、翻译、写作 | 0.5/1 元 |
| MiMo v2.5 PRO | 推理能力强,代码质量高 | 编程、数学、Agent | 免费 |
| GLM-5 | 中文理解出色,知识丰富 | 中文写作、知识问答 | 0.8/1.5 元 |
| Qwen Plus | 长上下文支持好 | 长文档分析、总结 | 0.4/0.8 元 |
进阶配置
添加多个模型
你可以为同一个供应商添加多个模型。在供应商配置中,点击模型列表旁的 「添加」 按钮,输入模型 ID(如 deepseek-v4、mimo-v2.5-pro、glm-5)。
设置系统提示词
在 Cherry Studio 的对话设置中,你可以为不同的对话配置不同的系统提示词(System Prompt)。例如:
- 编程助手:「你是一个专业的编程助手,擅长 Python、JavaScript 等语言。」
- 翻译助手:「你是一个专业的翻译,精通中英互译,保持原文风格。」
- 写作助手:「你是一个写作助手,帮助用户润色文章、生成内容。」
调整参数
在对话设置中,你可以调整以下参数:
- Temperature:控制回复的随机性(0.1 更精确,0.9 更创意)
- Max Tokens:控制最大输出长度
- Top P:控制采样范围
常见问题
Q: 提示「API Key 无效」怎么办?
A: 请确认 API Key 是否正确复制(以 sk- 开头),并确认账户余额是否充足。可以在词元圈用户中心检查 Key 状态。
Q: 连接超时怎么办?
A: 检查网络连接,确认 Base URL 是否正确填写。如果使用代理,请确保代理配置正确。
Q: 支持图片上传吗?
A: 部分模型支持图片输入(如 MiMo v2.5 PRO),需要在模型配置中开启「支持图片」选项。
总结
通过以上步骤,你已经成功将词元圈接入 Cherry Studio。整个过程只需 5 分钟:
- 下载并安装 Cherry Studio
- 添加 OpenAI 兼容供应商,填入词元圈的 API 地址和密钥
- 选择合适的模型,开始对话
Cherry Studio 的界面简洁直观,配合词元圈的多模型支持,你可以随时在不同模型之间切换,找到最适合当前任务的那一个。
下一步:尝试接入其他客户端工具,如 LobeChat、Cursor 等,词元圈的 API 完全兼容 OpenAI SDK,接入方式几乎一样。
📖 相关文章
AI 学习助手完整指南:用 AI 高效学习新知识的 5 种方法
手把手教你用 AI 辅助学习:从概念理解、知识梳理到代码学习、笔记整理、自测巩固,5 个实用场景让你的学习效率翻倍。零基础小白也能快速上手。
教程指南向 AI 提问的 6 个实用技巧:让你的回答质量翻倍
很多人觉得 AI 不够聪明,其实是提问方式需要调整。本文教你 6 个简单实用的 Prompt 提问技巧,从明确目标到迭代优化,让 AI 给出更精准的回答。
教程指南AI 求职助手实用指南:简历优化、求职信撰写、面试准备一站搞定
手把手教你用 AI 优化简历、撰写求职信、准备面试。从 STAR 法则到模拟面试,5 个实用场景让求职效率提升 10 倍,零基础也能快速上手。
💬 评论功能暂未开放,敬请期待