返回AI 通道
Cherry Studio · 国内一键接入

Cherry Studio 国内一键 deeplink 接入指南 · AI 通道

Cherry Studio 是 CherryHQ 开源的桌面 AI 客户端,内置 Chat、Agent、知识库三大模块,支持 Claude / GPT / Gemini / 国产模型几十家 provider。AI 通道在 dashboard 帮你生成 cherrystudio://providers/api-keys deeplink —— 点一下,桌面 app 自动注入一个 provider,一条配置覆盖 Claude / GPT / Gemini 三家(走 type=new-api 按模型名自动路由协议),不用一个一个添加。

一键接入 · 30 秒把 AI 通道导进 Cherry Studio

前提:Cherry Studio 桌面端已安装(从 GitHub Releases 下载)。然后登录 AI 通道 dashboard,点 Cherry Studio 卡片 → 选分组 → 点 deeplink → 浏览器跳到 Cherry Studio 自动填好。不用手动加 provider、不用查协议路径

  1. 1

    装 Cherry Studio + 注册 AI 通道

    Cherry Studio 从 GitHub Releases 下 macOS / Windows / Linux 安装包,启动一次让 OS 注册 cherrystudio:// 协议。AI 通道邮箱注册即可,微信/支付宝充值最低 ¥10。

  2. 2

    Dashboard 点 Cherry Studio 卡片

    选你想用的分组(Claude / CC Max / Codex / Gemini 任一)。后端实时为该分组拉取/创建 API key。Cherry Studio 用 type=new-api,所以一个 provider entry 同时对外暴露这个分组里所有模型(按模型名自动选 OpenAI / Anthropic / Gemini 协议)。

  3. 3

    点"在 Cherry Studio 中打开"

    cherrystudio://providers/api-keys?v=1
      &data=<base64({
        "id": "aitongdao",
        "name": "AI 通道",
        "type": "new-api",
        "baseUrl": "https://ai.aitongdao.com",
        "apiKey": "sk-xxxxxx"
      })>

    浏览器跳到 Cherry Studio,自动新增一条名为"AI 通道"的 provider。之后在 Chat / Agent / 知识库任意模块,选模型时就能看到 Claude Opus 4.7、GPT-5.4、Gemini 2.5 Pro 等全部可用模型。

为什么用 AI 通道接 Cherry Studio

  • 一条 provider 配置,三家模型全包

    Cherry Studio 的 type=new-api provider 会按模型名自动路由协议:claude-opus-4-7 → Anthropic、gpt-5.4 → OpenAI、gemini-2.5-pro → Gemini 原生。一条配置覆盖三家,不用分别添加 Anthropic provider、OpenAI provider、Gemini provider 三次。

  • 不用碰任何 config 文件 / 不用记 endpoint

    传统 Cherry Studio 配置:你得知道 Anthropic endpoint 不带 /v1、OpenAI 带 /v1、Gemini 走 /v1beta,还要对每个 provider 填 model name list。AI 通道 deeplink 全部自动化,你只需要点一下。

  • Chat / Agent / 知识库全模块通用

    这一条 provider 不仅给 Chat 用,也给 Agent(自动化任务)、知识库(RAG 嵌入)用。意味着同一把 key 同一余额,跨 Cherry Studio 全部功能。

  • 按 1 RMB ≈ 1 USD 计价 · 跨分组单独折扣

    Claude 0.7x(约 1 折)、 CC Max 2.5x(约 3.7 折)、 Codex 0.35x(约 0.5 折)、 Gemini 0.8x(约 1.2 折)。共用一个余额,余额永不过期。

deeplink 没反应?或者想手动添加 provider
  1. A

    检查 Cherry Studio 是否注册了协议

    首次安装后必须启动一次,OS 才会注册 cherrystudio:// 协议处理器。如果没启动过,deeplink 会被浏览器当成无效链接。

  2. B

    手动添加 provider(不用 deeplink)

    Cherry Studio 设置 → Providers → "添加自定义" → 填:

    名称:    AI 通道
    类型:    new-api(或 OpenAI 兼容)
    Base URL: https://ai.aitongdao.com
    API Key:  sk-xxxxxx

    new-api 类型可以让 Cherry Studio 按模型名自动选协议。如果你的 Cherry Studio 版本太老没有 new-api 选项,选 OpenAI 兼容也能用,但 Claude 和 Gemini 模型可能要走 OpenAI shim 路径(无伤大雅)。

  3. C

    多个分组分别添加 provider

    如果你同时想用 Claude 分组和 Codex 分组(分开计费),可以重复 deeplink 流程,选不同分组生成不同 provider。Cherry Studio 里会出现两条 "AI 通道" entry,在 Chat 顶部切换。

常见问题 FAQ

Cherry Studio 是开源的吗?数据安全吗?

是。源码在 github.com/CherryHQ/cherry-studio。Cherry Studio 本身不上传任何对话数据,所有对话本地存储。AI 通道生成的 deeplink 包含你的 API key,只在你浏览器和 Cherry Studio 之间传输,不经过 AI 通道服务器。

跟直接在 Cherry Studio 里手动加 OpenAI/Anthropic 有什么区别?

手动加你需要分别处理三家厂商的注册、付款、海外卡问题。AI 通道帮你代办了这一切,只需要邮箱注册 + 微信/支付宝充值。而且 AI 通道一条 new-api provider 覆盖三家,你不用记三个 endpoint、三套 model name list。

Agent 模式和知识库都能用吗?

能。这条 provider 注册后是全局可用的,Chat / Agent / 知识库三个模块都能选这个 provider 的模型。Agent 自动化任务和知识库的嵌入(embeddings)调用也走同一把 key,从同一余额扣费。

支持的模型列表会自动更新吗?

会。Cherry Studio 的 new-api 类型会请求 /v1/models 端点拿当前可用模型列表,AI 通道这个 endpoint 会返回当前分组下所有模型(随我们后端模型上下架自动同步)。重启 Cherry Studio 或在 provider 设置点"刷新模型"就拿到最新列表。

支持图片 / 文件输入吗?

支持(取决于模型本身)。Claude / GPT / Gemini 的多模态输入通过 OpenAI 协议或对应原生协议直通,Cherry Studio 在 Chat 输入框拖拽图片即可。Gemini 还支持视频和 PDF 输入。

价格相对官方贵多少?

不贵 —— AI 通道按 1 RMB ≈ 1 USD 计价(不是按汇率折算成 ¥7),倍率即真实折扣。当前实时汇率 1 USD ≈ 6.84 RMB。具体单价见 价格页

能不能跨设备同步 Cherry Studio 配置?

Cherry Studio 本身有云同步选项(走 WebDAV 等),但默认不同步 API key(避免泄露)。建议每台机器独立运行 deeplink 导入。

国内用 Cherry Studio 需要翻墙吗?

不需要。Cherry Studio 本地运行,对话、Agent 结果、知识库索引全部存在本地硬盘;deeplink 从 aitongdao.com(国内 ICP 备案域名)直接唤起桌面 app,AI 模型请求走 ai.aitongdao.com 首尔节点国内直连。Windows / macOS / Linux 三平台桌面端都免翻墙,连 embeddings 向量化也走同一国内 endpoint。

我有多个中转账号或想同时用多个分组,怎么用 Cherry Studio 切换?

Cherry Studio 支持任意多个 new-api 类型的 provider 并存。反复走 deeplink 流程可以给不同分组(Claude / Codex / Gemini 等)或不同账号建立独立 provider entry,一个 provider 覆盖该分组下所有模型。Chat 窗口顶部下拉菜单一键切换 provider,Agent 和知识库模块也能按 provider 指定。多账号场景用起来跟多模型一样无缝,团队也能按账号隔离计费。

Cherry Studio 可用分组价格 · 实时数据

AI 通道按 1 RMB ≈ 1 USD 计价 —— 倍率就是官方折扣,不要再 × 汇率(那样会算贵)。当前实时汇率 1 USD ≈ 6.84 RMB:

  • Claude 分组 · 倍率 0.7x · 折合官方约 1 折
    💰 Claude Opus 4.7 / Sonnet 4.6 / Haiku 4.5 全系,1M 上下文 + 高缓存,日常编码首选
  • CC Max 分组 · 倍率 2.5x · 折合官方约 3.7 折
    🌟 Claude 官方 Max 满血,1M 上下文 + 超高缓存,Claude Code 重度用户首选
  • Codex 分组 · 倍率 0.35x · 折合官方约 0.5 折
    🚀 GPT-5 / 5.1 / 5.2 / 5.4 + Codex 全系,编码用量最省
  • Gemini 分组 · 倍率 0.8x · 折合官方约 1.2 折
    ✨ Gemini 2.5 Pro / 3 Pro / 3 Flash 全系,大上下文 + 多模态

完整模型清单和单价见 价格页

开始用 Cherry Studio(AI 通道一键导入)

装 Cherry Studio → 注册 AI 通道 → 充 ¥10 → 选 Cherry Studio 卡片 → 点 deeplink → 完成。