小马AI 使用文档

主题

Cherry Studio ​

全能的多模型 AI 助手 | 桌面端聊天与绘图客户端

Cherry Studio 是一款开源、免费的多模型 AI 桌面客户端，覆盖 Windows、macOS、Linux 全平台。相比命令行工具，它提供完整的图形界面，更适合日常对话、AI 绘图、知识库问答、翻译等高频场景。配合小马AI的 OpenAI-plan / Claude-plan / default 分组令牌，可接入模型广场中当前已上架的模型。

为什么推荐 ​

Claude Code、Codex 等命令行工具更适合写代码，但当你需要：

  • 和模型自由地聊天讨论问题
  • 用 GPT-Image、DALL·E、Flux 等模型生成图片
  • 建本地知识库让模型基于自己的文档回答
  • 跨模型对比、批量翻译、Prompt 调试

这些场景下，桌面客户端的体验远好于 CLI。Cherry Studio 是目前生态最完整、更新最活跃的开源选择之一。

核心功能 ​

多模型聊天 ​

  • 集成 300+ AI 模型：OpenAI、Claude、Qwen、Mistral 等主流厂商一应俱全
  • 支持 50+ 服务商，包括本地大模型（Ollama、LM Studio）
  • 多会话、多话题并行，每个会话独立上下文
  • 支持联网搜索、文件上传、图片/PDF 解读

AI 绘图 ​

  • 内置 AI 绘图工作台，调用 GPT-Image、DALL·E、Flux、Stable Diffusion 等模型
  • 支持文生图、图生图、参数调节、批量生成
  • 生成结果本地存档，便于回顾与对比

知识库 ​

  • 上传 PDF、Word、Markdown、网页等资料，自动向量化建库
  • 在对话中引用知识库，让模型基于私有数据回答
  • 支持本地 Embedding 或调用云端 Embedding 模型

智能体（Agent） ​

  • 内置 300+ 智能助手：写作、编程、翻译、营销、教育等场景模板
  • 可自定义系统提示词、模型参数，打造个人专属助手

其他亮点 ​

  • 内置 AI 翻译，支持多语言互译与文档翻译
  • 支持 MCP（Model Context Protocol） 工具扩展
  • 数据完全本地存储，隐私安全
  • 完全免费、开源（Apache-2.0）

下载安装 ​

前往官网下载页：https://cherry-ai.com/download，根据系统选择对应安装包。

  • Windows： 下载 .exe 安装程序，双击运行
  • macOS： 下载 .dmg，支持 Intel 与 Apple Silicon
  • Linux： 提供 .AppImage / .deb

一键导入 小马AI ​

小马AI 控制台已内置 Cherry Studio 一键导入入口，无需手动填 API 地址、密钥。

操作步骤：

  1. 打开 小马AI 控制台 → 「API 密钥」页面
  2. 找到要使用的令牌行（按需选择 Claude-plan / OpenAI-plan / default 分组）
  3. 点击行尾的 「…」菜单 → 「聊天」→ 「Cherry Studio」

在 API 密钥页面打开 Cherry Studio 一键导入

  1. 浏览器会弹窗询问「是否打开 Cherry Studio」，点击允许
  2. Cherry Studio 自动跳到「设置 → 模型服务」并预填好 API Key 和 API 地址

前置准备

还没有令牌？先到创建 API 令牌按引导生成；不同分组支持的模型与定价见模型广场。

导入后还要做什么 ​

一键导入只完成了服务商连接，还需要：

  1. 打开服务商右上角启用开关 —— 默认未启用
  2. 添加要使用的模型：点击「+ 添加」或「管理」，手动输入模型 ID，例如：
    • claude-opus-4-7
    • claude-sonnet-4-6
    • gpt-5.5
    • gpt-image-1.5（绘图模型）
    • gpt-image-2（绘图模型）
  3. 回到主界面，顶部模型选择器中即可看到刚才添加的模型

验证配置 ​

  1. 在主界面新建对话，顶部选择刚才添加的模型
  2. 输入 你好，介绍一下你自己，能正常回复即代表配置成功
  3. 如返回 401/403，确认 API Key 与分组是否匹配
  4. 如某个模型不可用，到模型广场确认该模型在你的分组中是否开通

绘图模型教程 ​

如果你主要想用 Cherry Studio 画图，可以继续看：

常见问题 ​

  • 点了菜单浏览器没反应？ 确认本机已安装 Cherry Studio；首次会弹「是否允许打开 Cherry Studio」，要点允许
  • 导入后模型选不到？ Cherry Studio 不会自动拉模型清单，要手动在「管理 / + 添加」里加模型 ID
  • 绘图报错？ 确认所选模型属于 OpenAI-plan 或 default 分组并已开通；部分图像模型仅限指定分组
  • 想换分组？ 在 API 密钥页面用另一个分组的令牌重新「聊天 → Cherry Studio」一次即可，多个服务商可并存切换

小马AI

Copyright © 2026 小马AI