最新版 Cherry Studio（开源 AI 桌面客户端）功能介绍及接入阿里云百炼 Coding Plan、Token Plan 教程-阿里云开发者社区

Cherry Studio作为一款开源、跨平台的AI桌面客户端，凭借多模型聚合、本地优先、多模态交互与MCP生态集成等核心优势，成为开发者与内容创作者统一管理AI服务的首选工具。最新版Cherry Studio深度兼容阿里云百炼平台，支持Coding Plan与Token Plan两大订阅方案无缝接入，让用户可在统一界面中高效调用通义千问系列模型，实现编程开发、内容创作、信息处理等全场景AI能力落地。本文将全面拆解Cherry Studio的核心功能，从安装部署、基础配置到自定义工作流，再到阿里云百炼Coding Plan、Token Plan的完整接入流程，提供可直接运行的代码命令与实操步骤，助力用户快速搭建高效、安全、可扩展的个人AI工作台。

一、Cherry Studio核心功能全景解析

Cherry Studio并非简单的AI聊天工具，而是集成多模型管理、本地数据存储、多模态交互、智能工作流与MCP生态的全能AI桌面平台，核心能力覆盖个人办公、开发辅助、内容创作、自动化任务等全场景，彻底解决AI服务碎片化问题。阿里云百炼Coding Plan、Token Plan的完整接入流程，详情👉访问阿里云百炼大模型服务平台页面了解

（一）多模型聚合：一站式管理全球AI服务

Cherry Studio原生支持主流云端模型与本地模型的统一接入，无需在多个应用间切换，即可管理所有AI服务。

云端模型兼容：完美适配阿里云百炼、OpenAI、Anthropic、Google Gemini、DeepSeek等主流云端模型服务，支持一键添加、快速切换，统一调用接口与参数配置。
本地模型支持：深度集成Ollama、LM Studio等本地模型部署工具，支持Llama、Mistral、Qwen等开源模型本地运行，实现数据完全本地存储，隐私安全可控。
模型对比功能：支持同一问题同时调用多个模型生成回复，一键对比不同模型的回答质量、响应速度与成本，帮助用户快速选择最优模型。

（二）本地优先架构：数据自主可控，隐私安全无忧

Cherry Studio采用“本地优先”设计理念，所有对话历史、配置信息、知识库数据默认存储在用户本地设备，无需上传至第三方服务器，从根源避免数据泄露风险。

本地数据存储：对话记录、模型配置、自定义助手等数据全部存储在本地目录，支持手动备份与WebDAV同步，用户完全掌控数据所有权。
离线使用能力：搭配本地部署的开源模型，可实现完全离线运行，无需网络连接即可使用核心AI功能，适合处理敏感文档、内部资料等隐私场景。
数据加密保护：本地数据默认采用AES加密存储，支持设置本地密码，进一步提升数据安全性，防止未授权访问。

（三）多模态交互系统：打破文本交互局限

最新版Cherry Studio全面升级多模态交互能力，支持文本、图像、音频的混合输入输出，实现更自然、高效的人机对话。

图文混合交互：支持上传图片并结合文本指令，实现图片解析、图文创作、UI设计稿转代码等功能，适配设计、开发、内容创作等场景。
音频输入输出：支持语音转文字输入与文字转语音输出，解放双手，提升移动办公与快速交互效率。
多格式内容渲染：内置Markdown、公式、代码高亮、HTML实时预览等渲染能力，支持代码块、表格、流程图等复杂内容展示，提升内容可读性与实用性。

（四）智能助手生态：300+预设+自定义Agent

Cherry Studio内置300+行业专用智能助手，覆盖编程开发、内容写作、翻译、数据分析、设计等领域，同时支持自定义Agent打造专属AI专家团队。

预设助手市场：提供编程助手、写作助手、翻译助手、数据分析助手等分类，一键启用即可使用专业能力，无需复杂配置。
自定义Agent开发：支持通过自然语言定义Agent角色、能力与工作流，可绑定特定模型、配置专属参数、接入自定义工具，打造贴合个人需求的专属AI助手。
Agent协作机制：支持多个Agent协同工作，可配置“需求分析→代码生成→测试校验”等多步骤工作流，自动完成复杂任务。

（五）MCP生态集成：打通AI工具链

基于Model Context Protocol（MCP）协议，Cherry Studio实现与各类AI工具、本地服务、第三方平台的无缝集成，构建完整的AI工作流生态。

MCP工具接入：支持一键接入代码编辑器、文档工具、数据处理工具等MCP兼容服务，实现AI与本地工具的双向交互。
工作流自动化：支持配置“AI生成→工具处理→结果输出”的自动化流水线，例如“文档总结→代码生成→本地保存”，无需人工干预即可完成全流程。
知识沉淀结构化：自动归档所有AI交互记录，按项目、工具、时间维度分类，配合全局搜索功能，让每一次AI辅助成果都成为可复用的知识资产。

（六）跨平台与高度定制化

Cherry Studio支持Windows、macOS、Linux全平台运行，提供一致的原生应用体验，同时支持高度自定义，满足不同用户的个性化需求。

跨平台兼容：三大操作系统原生支持，安装包体积小、启动速度快，资源占用低，适配不同硬件配置。
界面自定义：支持主题切换、布局调整、字体大小设置等，打造专属使用界面。
参数精细化控制：可自定义模型温度、最大Token数、上下文长度、采样策略等参数，精准控制AI生成效果。

二、Cherry Studio安装与基础配置

Cherry Studio提供官网下载、GitHub Releases、包管理器安装等多种方式，适配全平台，以下为详细安装与基础配置流程。

（一）全平台安装方法

1. 官网/ GitHub下载安装（推荐）

# Windows/macOS/Linux通用下载（GitHub Releases）
# 访问 https://github.com/CherryHQ/cherry-studio/releases
# 下载对应系统的安装包（.exe/.dmg/.AppImage）
# 双击安装，按照向导完成部署

2. 包管理器安装（Linux/macOS）

# macOS（Homebrew）
brew install cherry-studio

# Linux（Snap）
sudo snap install cherry-studio

3. 验证安装

安装完成后，启动Cherry Studio，首次打开会进入欢迎界面，提示配置模型服务，此时可先完成基础配置，再接入阿里云百炼。

（二）基础配置：本地设置与模型初始化

本地数据目录设置：进入“设置→通用→数据存储”，选择本地数据存储路径（建议非系统盘），配置自动备份与WebDAV同步参数。
界面与交互设置：调整主题、字体、快捷键、通知等基础参数，优化使用体验。
本地模型配置（可选）：若需使用本地模型，进入“设置→模型服务→Ollama/LM Studio”，配置本地模型地址，一键获取已部署的本地模型列表。
预设助手启用：进入“助手市场”，选择需要的预设助手（如编程助手、写作助手），一键启用并添加到主界面。

三、阿里云百炼平台前置准备：Coding Plan与Token Plan开通

接入Cherry Studio前，需先在阿里云百炼平台开通Coding Plan或Token Plan订阅，并获取专属API Key，以下为详细开通流程。阿里云百炼Coding Plan、Token Plan的完整接入流程，详情👉访问阿里云百炼大模型服务平台页面了解

（一）阿里云百炼账号与基础配置

注册阿里云账号并完成实名认证（个人/企业均可）。
登录阿里云百炼控制台（Model Studio），进入“API Key管理”页面，创建通用API Key（用于Token Plan）或Coding Plan专属API Key。
注意：Coding Plan专属API Key以sk-sp-开头，Token Plan API Key以sk-开头，两者不可混用。

（二）Token Plan订阅开通（通用场景首选）

进入百炼控制台“计费→Token Plan”，选择个人版或团队版，根据需求选择坐席数量与订阅周期（月/季/年）。
完成支付后，在“成员管理”页面生成Token Plan专属API Key，记录Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1。
Token Plan按Credits积分抵扣调用消耗，支持Qwen3.7-Max、Qwen3.7-Plus等全系列模型，适合通用对话、内容创作、多模态交互等场景。

（三）Coding Plan订阅开通（编程场景首选）

进入百炼控制台“计费→Coding Plan”，选择Lite（40元/月，18000次请求）或Pro（200元/月，90000次请求）套餐，新用户可享首月优惠。
获取Coding Plan专属API Key（sk-sp-开头），专属Base URL：https://coding.dashscope.aliyuncs.com/v1。
Coding Plan专为编程场景优化，支持高频代码生成、调试、重构，性价比更高，适合开发者日常使用。

四、Cherry Studio接入阿里云百炼Coding Plan实战

Coding Plan是Cherry Studio编程场景的最优选择，接入后可实现高频、低成本的代码辅助开发，以下为完整配置流程与代码示例。

（一）Cherry Studio可视化配置（推荐）

启动Cherry Studio，点击左下角“设置”图标，进入“模型服务”页面。
点击“添加模型服务”，选择“阿里云百炼Coding Plan”（或自定义添加OpenAI兼容服务）。
填写配置信息：
- 服务名称：阿里云百炼Coding Plan
- API Key：填入Coding Plan专属密钥（sk-sp-xxxx）
- Base URL：https://coding.dashscope.aliyuncs.com/v1
- 协议：OpenAI兼容（Chat Completions）。
点击“测试连接”，验证配置是否成功，成功后点击“保存”。
进入“模型管理”页面，添加支持的模型ID：qwen3.7-plus、qwen3.7-max、qwen3-coder-next等。
返回主界面，在模型选择下拉框中选择Coding Plan对应的模型，即可开始使用。

（二）配置文件手动配置（批量部署）

Cherry Studio的配置文件存储在本地数据目录的config.json中，可手动编辑添加Coding Plan配置：

{
   
  "modelProviders": [
    {
   
      "id": "aliyun-coding-plan",
      "name": "阿里云百炼Coding Plan",
      "type": "openai",
      "apiKey": "sk-sp-你的Coding Plan专属API Key",
      "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
      "models": [
        {
   "id": "qwen3.7-plus", "name": "Qwen3.7-Plus"},
        {
   "id": "qwen3.7-max", "name": "Qwen3.7-Max"},
        {
   "id": "qwen3-coder-next", "name": "Qwen3-Coder-Next"}
      ],
      "enabled": true
    }
  ],
  "defaultModel": "qwen3.7-plus"
}

保存文件后，重启Cherry Studio即可生效。

（三）Coding Plan代码调用示例（Python）

通过Cherry Studio的API接口调用Coding Plan模型，实现代码生成功能：

import requests
import json

# Cherry Studio本地服务地址（默认端口10240）
CHERRY_STUDIO_URL = "http://localhost:10240/v1/chat/completions"

# 请求头
headers = {
   
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-sp-你的Coding Plan专属API Key"
}

# 调用Coding Plan生成Python代码
def generate_code(prompt):
    data = {
   
        "model": "qwen3.7-plus",
        "messages": [
            {
   "role": "system", "content": "你是专业的Python开发助手，擅长编写高效、规范的代码"},
            {
   "role": "user", "content": prompt}
        ],
        "temperature": 0.3,
        "max_tokens": 4096
    }

    response = requests.post(CHERRY_STUDIO_URL, headers=headers, json=data)
    if response.status_code == 200:
        return response.json()["choices"][0]["message"]["content"]
    else:
        return f"请求失败：{response.status_code} - {response.text}"

# 测试：生成FastAPI用户管理接口
if __name__ == "__main__":
    code = generate_code("生成一个FastAPI用户管理接口，包含增删改查功能，使用SQLite数据库，带完整注释")
    print("生成的代码：\n", code)

五、Cherry Studio接入阿里云百炼Token Plan实战

Token Plan适合通用场景，支持全系列通义千问模型，接入后可实现对话、信息处理、多模态交互等功能，以下为完整配置流程。

（一）Cherry Studio可视化配置

进入Cherry Studio“设置→模型服务”，点击“添加模型服务”，选择“阿里云百炼Token Plan”。
填写配置信息：
- 服务名称：阿里云百炼Token Plan
- API Key：填入Token Plan专属密钥（sk-xxxx）
- Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1
- 协议：OpenAI兼容（Chat Completions）。
测试连接成功后保存，进入“模型管理”添加支持的模型ID：qwen3.7-max、qwen3.7-plus、qwq-plus等。
返回主界面选择Token Plan模型，即可开始使用。

（二）配置文件手动配置

编辑config.json文件，添加Token Plan配置：

{
   
  "modelProviders": [
    {
   
      "id": "aliyun-token-plan",
      "name": "阿里云百炼Token Plan",
      "type": "openai",
      "apiKey": "sk-你的Token Plan专属API Key",
      "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
      "models": [
        {
   "id": "qwen3.7-max", "name": "Qwen3.7-Max"},
        {
   "id": "qwen3.7-plus", "name": "Qwen3.7-Plus"},
        {
   "id": "qwq-plus", "name": "QwQ-Plus"}
      ],
      "enabled": true
    }
  ],
  "defaultModel": "qwen3.7-max"
}

重启Cherry Studio生效。

（三）Token Plan多模态调用示例（图文交互）

Token Plan支持Qwen3.7-Plus多模态能力，通过Cherry Studio实现图片解析功能：

import requests
import json
import base64

CHERRY_STUDIO_URL = "http://localhost:10240/v1/chat/completions"
headers = {
   
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-你的Token Plan专属API Key"
}

def analyze_image(image_path, prompt):
    # 读取图片并转为base64
    with open(image_path, "rb") as f:
        img_b64 = base64.b64encode(f.read()).decode("utf-8")

    # 多模态消息结构
    data = {
   
        "model": "qwen3.7-plus",
        "messages": [
            {
   
                "role": "user",
                "content": [
                    {
   "type": "text", "text": prompt},
                    {
   "type": "image_url", "image_url": {
   "url": f"data:image/png;base64,{img_b64}"}}
                ]
            }
        ],
        "temperature": 0.6,
        "max_tokens": 3072
    }

    response = requests.post(CHERRY_STUDIO_URL, headers=headers, json=data)
    if response.status_code == 200:
        return response.json()["choices"][0]["message"]["content"]
    else:
        return f"请求失败：{response.status_code}"

# 测试：解析UI设计稿生成前端代码
if __name__ == "__main__":
    result = analyze_image("./ui_design.png", "根据设计稿生成Vue3组件代码，包含样式与交互逻辑")
    print("解析结果：\n", result)

六、Cherry Studio自定义工作流与MCP工具集成

结合阿里云百炼模型，Cherry Studio可通过MCP协议集成本地工具，打造专属AI工作流，以下为实战案例。

（一）创建“代码开发→本地运行”工作流

进入Cherry Studio“工作流”页面，点击“新建工作流”，命名为“代码开发自动化”。
添加第一步：“AI代码生成”，选择阿里云百炼Coding Plan的qwen3.7-plus模型，配置提示词模板：“生成{语言}代码，实现{功能}，带完整注释”。
添加第二步：“本地代码保存”，配置保存路径与文件名规则，自动将生成的代码保存到本地项目目录。
添加第三步：“本地代码运行”，集成MCP兼容的代码运行工具，自动执行生成的代码并返回结果。
保存工作流，一键触发即可完成“需求→代码→运行”全流程。

（二）MCP工具接入示例（本地文件处理）

通过MCP协议接入本地文件处理工具，实现AI与本地文件的双向交互：

# MCP工具配置（Cherry Studio设置→MCP工具）
# 工具名称：本地文件处理器
# 命令：python3 /path/to/file_processor.py
# 参数：--action {action} --path {path} --content {content}

# file_processor.py 代码示例
import argparse
import os

def process_file(action, path, content=None):
    if action == "read":
        with open(path, "r", encoding="utf-8") as f:
            return f.read()
    elif action == "write":
        with open(path, "w", encoding="utf-8") as f:
            f.write(content)
        return f"文件已保存：{path}"
    elif action == "list":
        return "\n".join(os.listdir(path))
    else:
        return "未知操作"

if __name__ == "__main__":
    parser = argparse.ArgumentParser()
    parser.add_argument("--action", required=True)
    parser.add_argument("--path", required=True)
    parser.add_argument("--content")
    args = parser.parse_args()
    print(process_file(args.action, args.path, args.content))

配置完成后，在Cherry Studio中可通过自然语言指令调用该工具，例如“读取本地README.md文件并总结内容”，AI会自动调用MCP工具完成操作。

七、Cherry Studio+百炼双计划使用优化与常见问题

（一）成本优化策略

场景分流：编程高频场景使用Coding Plan（按调用次数计费，性价比更高）；通用对话、多模态、长文本处理使用Token Plan（按Token计费，灵活可控）。
模型选型：日常任务使用Qwen3.7-Plus（成本更低）；高精度推理、长文档分析使用Qwen3.7-Max（效果更好）。
本地缓存：开启Cherry Studio本地对话缓存，减少重复调用云端模型，降低Token消耗。
参数优化：合理设置max_tokens参数，避免输出截断或过度消耗；编程场景设置低温度（0.1-0.3）提升代码准确性。

（二）性能优化配置

模型并行：同时配置多个模型服务，根据任务类型自动切换，提升响应速度。
本地模型兜底：配置本地模型作为兜底，网络异常时自动切换，保证服务可用性。
工作流缓存：开启工作流结果缓存，重复任务直接使用历史结果，减少AI调用次数。

（三）常见问题排查

API Key认证失败：核对Coding Plan（sk-sp-）与Token Plan（sk-）密钥类型，确保Base URL与密钥匹配，无空格或字符错误。
模型调用失败：检查百炼订阅是否到期，模型ID是否正确，网络是否可访问阿里云API地址。
MCP工具无法调用：核对工具命令路径、参数配置是否正确，本地工具是否有执行权限。
多模态功能异常：确保模型支持多模态能力（如Qwen3.7-Plus），图片格式与大小符合要求。

八、总结

Cherry Studio作为开源AI桌面客户端的标杆产品，以多模型聚合、本地优先、多模态交互与MCP生态为核心，为用户提供了统一、高效、安全的AI服务管理平台。结合阿里云百炼Coding Plan与Token Plan两大订阅方案，用户可在Cherry Studio中无缝接入通义千问系列模型，实现从编程开发到内容创作、从信息处理到自动化任务的全场景AI能力落地。

本文从Cherry Studio核心功能解析、安装部署、基础配置，到阿里云百炼双计划的完整接入流程，再到自定义工作流与MCP工具集成实战，提供了全流程、可落地的操作指南与代码示例。无论是个人用户打造高效AI工作台，还是开发者构建行业专属AI应用，Cherry Studio+阿里云百炼的组合都能提供灵活、可扩展、成本可控的解决方案。通过合理配置模型、优化使用策略，可在保障AI能力的同时，最大化降低使用成本，真正实现AI技术的普惠与高效落地。

最新版 Cherry Studio（开源 AI 桌面客户端）功能介绍及接入阿里云百炼 Coding Plan、Token Plan 教程

一、Cherry Studio核心功能全景解析

（一）多模型聚合：一站式管理全球AI服务

（二）本地优先架构：数据自主可控，隐私安全无忧

（三）多模态交互系统：打破文本交互局限

（四）智能助手生态：300+预设+自定义Agent

（五）MCP生态集成：打通AI工具链

（六）跨平台与高度定制化

二、Cherry Studio安装与基础配置

（一）全平台安装方法

1. 官网/ GitHub下载安装（推荐）

2. 包管理器安装（Linux/macOS）

3. 验证安装

（二）基础配置：本地设置与模型初始化

三、阿里云百炼平台前置准备：Coding Plan与Token Plan开通

（一）阿里云百炼账号与基础配置

（二）Token Plan订阅开通（通用场景首选）

（三）Coding Plan订阅开通（编程场景首选）

四、Cherry Studio接入阿里云百炼Coding Plan实战

（一）Cherry Studio可视化配置（推荐）

（二）配置文件手动配置（批量部署）

（三）Coding Plan代码调用示例（Python）

五、Cherry Studio接入阿里云百炼Token Plan实战

（一）Cherry Studio可视化配置

（二）配置文件手动配置

（三）Token Plan多模态调用示例（图文交互）

六、Cherry Studio自定义工作流与MCP工具集成

（一）创建“代码开发→本地运行”工作流

（二）MCP工具接入示例（本地文件处理）

七、Cherry Studio+百炼双计划使用优化与常见问题

（一）成本优化策略

（二）性能优化配置

（三）常见问题排查

八、总结

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

最新版 Cherry Studio（开源 AI 桌面客户端） 功能介绍及接入阿里云百炼 Coding Plan、Token Plan 教程

一、Cherry Studio核心功能全景解析

（一）多模型聚合：一站式管理全球AI服务

（二）本地优先架构：数据自主可控，隐私安全无忧

（三）多模态交互系统：打破文本交互局限

（四）智能助手生态：300+预设+自定义Agent

（五）MCP生态集成：打通AI工具链

（六）跨平台与高度定制化

二、Cherry Studio安装与基础配置

（一）全平台安装方法

1. 官网/ GitHub下载安装（推荐）

2. 包管理器安装（Linux/macOS）

3. 验证安装

（二）基础配置：本地设置与模型初始化

三、阿里云百炼平台前置准备：Coding Plan与Token Plan开通

（一）阿里云百炼账号与基础配置

（二）Token Plan订阅开通（通用场景首选）

（三）Coding Plan订阅开通（编程场景首选）

四、Cherry Studio接入阿里云百炼Coding Plan实战

（一）Cherry Studio可视化配置（推荐）

（二）配置文件手动配置（批量部署）

（三）Coding Plan代码调用示例（Python）

五、Cherry Studio接入阿里云百炼Token Plan实战

（一）Cherry Studio可视化配置

（二）配置文件手动配置

（三）Token Plan多模态调用示例（图文交互）

六、Cherry Studio自定义工作流与MCP工具集成

（一）创建“代码开发→本地运行”工作流

（二）MCP工具接入示例（本地文件处理）

七、Cherry Studio+百炼双计划使用优化与常见问题

（一）成本优化策略

（二）性能优化配置

（三）常见问题排查

八、总结

热门文章

最新文章

相关电子书

最新版 Cherry Studio（开源 AI 桌面客户端）功能介绍及接入阿里云百炼 Coding Plan、Token Plan 教程