AI 通道 Cherry Studio 是 CherryHQ 开源的桌面 AI 客户端,内置 Chat、Agent、知识库三大模块,支持 Claude / GPT / Gemini / 国产模型几十家 provider。在 AI 通道 dashboard 复制 Base URL 和一把 API Key,在 Cherry Studio 里添加一个 new-api 自定义服务商粘贴进去 —— 一条配置覆盖 Claude / GPT / Gemini 三家(按模型名自动路由协议),不用一个一个添加。
前提:Cherry Studio 桌面端已安装(从 GitHub Releases 下载)。然后登录 AI 通道 dashboard,复制 Base URL 和一把 API Key,在 Cherry Studio 里加一个 new-api 自定义服务商 —— 一条配置就覆盖 Claude / GPT / Gemini 三家,不用一个一个添加。
Cherry Studio 从 GitHub Releases 下 macOS / Windows / Linux 安装包。AI 通道邮箱注册即可,微信/支付宝充值最低 ¥10。
登录后在「自定义接入」里复制 Base URL(https://ai.aitongdao.com),在「令牌管理」里创建并复制一把 API Key(sk-…)。一把 Key 覆盖你账号下所有分组的模型。
设置 → 模型服务 → 添加 → 类型选 new-api(或 OpenAI 兼容),把上一步的两个值填进去:
名称: AI 通道
类型: new-api(或 OpenAI 兼容)
Base URL: https://ai.aitongdao.com
API Key: sk-xxxxxx用 new-api 类型时一条服务商即按模型名自动选 OpenAI / Anthropic / Gemini 协议。之后在 Chat / Agent / 知识库任意模块,选模型就能看到 Claude Opus 4.7、GPT-5.4、Gemini 2.5 Pro 等全部可用模型。
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 三次。
传统 Cherry Studio 配置:你得知道 Anthropic endpoint 不带 /v1、OpenAI 带 /v1、Gemini 走 /v1beta,还要对每个 provider 填 model name list。用 AI 通道 的 new-api 服务商,一条 Base URL + Key 全自动按模型名选协议,你只需要复制粘贴。
这一条 provider 不仅给 Chat 用,也给 Agent(自动化任务)、知识库(RAG 嵌入)用。意味着同一把 key 同一余额,跨 Cherry Studio 全部功能。
Claude 0.7x(约 1 折)、 CC Max 2.5x(约 3.7 折)、 Codex 0.6x(约 0.9 折)、 Gemini 2.5x(约 3.7 折)。共用一个余额,余额永不过期。
如果你的 Cherry Studio 版本太老,添加服务商时没有 new-api 类型,选 OpenAI 兼容 也能用,Base URL / API Key 填法一样。只是 Claude 和 Gemini 模型会走 OpenAI shim 路径(无伤大雅);升级到新版即可拿回按模型名自动选协议。
如果你想把 Claude 分组和 Codex 分组分开计费,可以在 Cherry Studio 里重复"添加自定义服务商",各填一条(同样的 Base URL,各自的 Key / 名称)。Cherry Studio 里会出现两条 "AI 通道" entry,在 Chat 顶部切换。
是。源码在 github.com/CherryHQ/cherry-studio。Cherry Studio 本身不上传任何对话数据,所有对话本地存储。你在 dashboard 复制的 API key 只填进你本机的 Cherry Studio,AI 通道不会替你保存或转发这把 key。
手动加你需要分别处理三家厂商的注册、付款、海外卡问题。AI 通道帮你代办了这一切,只需要邮箱注册 + 微信/支付宝充值。而且 AI 通道一条 new-api provider 覆盖三家,你不用记三个 endpoint、三套 model name list。
能。这条 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.79 RMB。具体单价见 价格页。
Cherry Studio 本身有云同步选项(走 WebDAV 等),但默认不同步 API key(避免泄露)。建议每台机器独立填一次 Base URL + Key。
可以。Cherry Studio 本地运行,对话、Agent 结果、知识库索引全部存在本地硬盘;你在 aitongdao.com(国内 ICP 备案域名)dashboard 复制配置,AI 模型请求走 ai.aitongdao.com 首尔节点国内直连。Windows / macOS / Linux 三平台桌面端都可在国内网络使用,连 embeddings 向量化也走同一国内 endpoint。
Cherry Studio 支持任意多个 new-api 类型的 provider 并存。在 Cherry Studio 里重复"添加自定义服务商",给不同分组(Claude / Codex / Gemini 等)或不同账号各填一条 new-api 服务商,一个服务商覆盖该分组下所有模型。Chat 窗口顶部下拉菜单一键切换 provider,Agent 和知识库模块也能按 provider 指定。多账号场景用起来跟多模型一样无缝,团队也能按账号隔离计费。
AI 通道按 1 RMB ≈ 1 USD 计价 —— 倍率就是官方折扣,不要再 × 汇率(那样会算贵)。当前实时汇率 1 USD ≈ 6.79 RMB:
完整模型清单和单价见 价格页。