Cherry Studio 自带模型吗?为什么要配 API?

不自带。它只是个装在本地的对话客户端,负责界面和会话管理,模型能力要你自己接一个 OpenAI 兼容的 API 进去。所以「用它调 Claude」实际要解决的是去哪拿一个能调 Claude 的 API、以及怎么填进去。

API 地址填什么?为什么我总是连不上?

填到 /v1 这一层,例如 https://cocodot.co/api/ai/v1 —— 末尾漏了 /v1 是最高频的失败原因。也不要把完整的 /chat/completions 路径填进去,客户端会自己拼接。如果 /v1 没问题还失败,依次查 Key 是否填错(401)、余额是否为 0、模型代号是否正确。

模型 ID 要手动一个个输入吗?

不用。配好提供商后点「获取模型」这类按钮,客户端会从服务端拉取当前所有可用型号,勾选即可。这样既不会拼错,也不会用到已下架的型号。想提前看有哪些,可以直接 curl https://cocodot.co/api/ai/v1/models,这个列表接口公开、不需要 Key。

国内怎么给这个 API 充值?

用支持人民币充值的 OpenAI 兼容中转即可,支付宝小额充值,控制台创建 Key。注意没有免费额度,余额大于 0 才能调用。建议第一次只充一点点把链路跑通,确认调用和计费都正常再加量。

能在一个客户端里同时用 Claude、GPT 和 Gemini 吗?

可以,而且是这种接法最实用的一点:同一个提供商下挂多个模型,对话时随时切,一个 Key、一份余额通用,不用为每家分别开户。建议按任务切——日常用中档、复杂推理用旗舰、简单整理用便宜的小型号,这是最直接的省钱方式。

用 Cherry Studio 还是直接写代码调?

看用途。日常写东西、问问题、整理资料用 Cherry Studio 很顺手,而且对话数据存在本地。但它是对话工具不是编程工具——要在项目里调 API 或做代码辅助,直接用 OpenAI SDK 改 base_url 和 api_key 两个参数更直接,填的是同一套地址和 Key。

接入更新于 2026-08

Cherry Studio 接入 Claude / GPT API 教程:逐步配置 + 报错对照(2026)

在 Cherry Studio 里加一个自定义提供商,人民币充值就能调 Claude / GPT / Gemini。含逐步配置、模型列表一键拉取(不用手打代号)、以及连不上时的逐条排查。

一句话结论:Cherry Studio 是个桌面对话客户端,自己不提供模型,你得给它接一个 API。它支持添加「OpenAI 兼容」的自定义提供商,所以可以接一个支持人民币充值的中转,一份余额在同一个客户端里调 Claude、GPT、Gemini 和国产模型。配置只有两个字段要填对:API 地址(末尾必须带 `/v1`,漏了会连不上,这是最高频的错误)和 API 密钥。填完之后别急着手打模型代号——客户端一般能直接从服务端把可用模型列表拉下来,点一下就全有了,既不会拼错也不会用到已下架的型号。另外要知道它的定位:它是对话客户端,不是编程工具,适合日常写东西、问问题、整理资料;要在代码里调 API 或做编程辅助,直接用 SDK 或编程类工具更顺手。

1. 先搞清楚 Cherry Studio 是什么

这一点先说明白,能避免很多预期落差:Cherry Studio 本身不提供模型,它只是个「壳」——一个装在你电脑上的对话客户端,负责界面、会话管理、提示词管理这些事,模型能力要靠你自己接一个 API 进去。所以「Cherry Studio 怎么用 Claude」这个问题,实际要解决的是「去哪拿一个能调 Claude 的 API,以及怎么填进去」。它的优点是对话数据存在你自己电脑上、界面顺手、能同时挂多个提供商随时切换;定位上它是对话工具不是编程工具,适合日常写作、问答、整理资料。要做代码补全或者在项目里调 API,用编程类工具或直接写 SDK 更合适,别指望它替代那一类。

2. 准备一个能用的 API(国内路径)

接进去的 API 需要满足两个条件:OpenAI 兼容(Cherry Studio 按这个标准对接)和国内能付得进钱。官方渠道的障碍通常在绑卡——要一张能过风控的海外卡,国内发行的卡常被拒。省事的路径是用支持人民币充值的兼容中转:以 cocodot 为例,注册账号、支付宝小额充值(注意没有免费额度,余额大于 0 才能调用)、在 AI API 控制台勾选条款创建一个 Key,几分钟就能拿到接入所需的两样东西——接入地址和 Key。建议第一次只充一点点,先把整条链路跑通确认没问题,再按需加量,这比一上来充一大笔稳妥得多。

3. 逐步配置(两个字段而已)

打开 Cherry Studio,进入设置 → 模型服务(提供商),新增一个提供商,类型选 OpenAI 兼容那一类,然后填两个字段:① API 地址填 `https://cocodot.co/api/ai/v1`——末尾这个 `/v1` 必须带上,漏了是最高频的失败原因;② API 密钥填你在控制台创建的那个 Key。填完保存。注意这里有个常见误解:有些人以为要把完整的 `/chat/completions` 路径填进去,其实不用——客户端会自己在 `/v1` 后面拼接具体接口路径,你只需要给到 `/v1` 这一层。保存之后先别急着聊天,下一步把模型列表拉进来。

4. 模型别手打,让它自己拉

这是能省事又能避错的一步。配置好提供商之后,面板上一般有「获取模型」/「拉取模型列表」这类按钮,点一下,客户端会去请求服务端的标准模型列表接口,把当前所有可用型号一次性拉进来,你只要在列表里勾选想用的即可。这比手动输入模型 ID 好在两处:一是不会拼错(代号大多是没有语义的短字符串,手打极易出错),二是拉到的一定是当前在售的型号,不会用到已经下架的。想提前看看有哪些型号,这个列表接口是公开的、不需要 Key,可以先在浏览器或终端里看一眼: ```bash curl https://cocodot.co/api/ai/v1/models ``` 拉取失败通常还是地址或 Key 的问题,回上一节核对这两个字段。

5. 连不上、报错时按这个顺序排查

别乱试,按顺序核这四项。① 地址末尾有没有 `/v1`——这一条能解决大半的「连不上」和 404;② Key 有没有填错,报 401 或鉴权失败基本就是它,重新从控制台复制一次,注意别把前后空格带进去;③ 余额是不是 0——这类平台没有免费额度,余额为零调用会直接失败,和配置无关;④ 模型代号对不对,报「模型不存在」就回上一节用「获取模型」重新拉一次列表,别继续用手打的那个。还有一类情况是请求很慢或超时:模型响应本来就比普通网页慢,长回答尤其明显,客户端里如果有超时设置可以调长一些。

6. 一份余额,多个模型随时切

接好之后有个很实用的用法:同一个提供商下挂着多个模型,对话时随时切换。因为都走同一套接口、同一个 Key、同一份余额,你不需要为每家厂商分别开户充值。实际用起来的节奏通常是:日常问答和写东西用一个顺手的中档模型,遇到需要仔细推理或处理长文档的问题再切到旗舰型号,简单的格式整理、翻译、分类就用便宜的小型号。这种「按任务切模型」的习惯是省钱最直接的方式——很多人的开销是因为不管什么问题都用最贵的那个模型。切换成本几乎为零,养成习惯就行。

7. 几个使用上的提醒

① 对话数据存在本地是 Cherry Studio 的优点,但也意味着换电脑要自己迁移,重要的会话记得导出备份。② Key 等于你的余额支配权,别把配置截图带 Key 发到群里或论坛求助——要发先打码。③ 不同用途建议建不同的 Key,一旦某个 Key 需要吊销,不会影响其他地方。④ 先小额跑通再加量,第一次调用成功后去控制台确认计费正常,确认这条链路完全通了再充更多。⑤ 要在代码里调 API 或做编程辅助,别用对话客户端绕,直接用 OpenAI SDK 改 `base_url` 和 `api_key` 两个参数更直接,填的是同一套地址和 Key。

配置项对照 + 出错时先看哪一个

配置项	填什么	填错的症状
提供商类型	选 OpenAI 兼容那一类	类型选错会导致请求格式对不上
API 地址	https://cocodot.co/api/ai/v1	漏了 /v1 → 连不上 / 404
API 密钥	控制台创建的 Key	填错 → 401 鉴权失败
模型列表	点「获取模型」自动拉取	手打代号容易拼错或用到已下架型号
余额	先支付宝小额充值	余额为 0 → 调用直接失败(无免费额度)