配置教程 · 截至 2026-11-22

Cherry Studio 配置 Claude API:2.2.3 的服务商与 API 地址

截至 2026-11-22,Cherry Studio 2.2.3 的配法是:左下角齿轮进 Settings → Model Provider → 列表底部 + Add Provider → Add Custom Provider,填服务商名字与 cr_ 开头的 API key,Anthropic 那一栏 Base URL 填 https://api.qcode.cc/api(不带 /v1,Cherry 会拼成 https://api.qcode.cc/api/v1/messages),点 Add 后勾 claude-sonnet-5-5;GPT 用同一把 key 再建一个服务商,OpenAI 栏填 https://api.qcode.cc/openai。2026-11-21 在 Windows 11(英文界面)上按这套配法实测,收到回复 Hello!。

更新于 2026-11-22

把这个工具接到 QCode 端点:一把 key 调 Claude、GPT 与国产模型。

#2.2.3 界面#Anthropic 栏#OpenAI 栏#cr_ 一把 key

四个先记住的值

2.2.3

没有服务商类型下拉

2.2.3 的 Add Custom Provider 弹窗按协议填栏:Claude 填 Anthropic 栏,GPT 与国产模型填 OpenAI 栏,旧教程里那个类型下拉在 2.2.3 已经没有。

/api

Anthropic 栏的根地址

填 https://api.qcode.cc/api,Cherry 自己拼成 https://api.qcode.cc/api/v1/messages;服务商详情页的 Anthropic preview 一行显示的就是这个完整路径。

/openai

OpenAI 栏的根地址

填 https://api.qcode.cc/openai,拼成 https://api.qcode.cc/openai/v1/chat/completions;More options 里的 OpenAI Responses 填同一地址,只服务 GPT。

cr_

一把 key 两个服务商

整个流程不需要 Cherry Studio 账号,欢迎页点 Set up later 就能进主界面;同一把 cr_ 开头的 key 建两个服务商,分别填 Anthropic 栏与 OpenAI 栏。

旧版本与 2.2.3 的差别

在 Cherry Studio 2.2.3 里添加服务商,弹窗标题是 Add Custom Provider,里面已经没有任何「提供商类型」下拉:协议由你填哪一栏 Base URL 决定,Claude 填 Anthropic 栏就是 Anthropic 协议,GPT 与国产模型填 OpenAI 栏就是 OpenAI 协议。

一个服务商只说一种协议,所以要同时用 Claude 与 GPT,就是同一把 cr_ key 建两个服务商。Claude 只能走 Anthropic 栏:QCode 的 OpenAI 端点对 Claude 模型回 model_not_available_on_endpoint。旧版本把设置里这一页叫 Model Services,2.2.3 英文界面叫 Model Provider;添加服务商的入口就在主界面左下角齿轮打开的这一页里。

2.2.3 里与这条配法相关的三处界面

  1. 12.2.3 稳定版于 2026-11-19 发布,英文下载页写的是 Stable Release · 11/19/2026。
  2. 2点 Add 后 Cherry 立刻向 Base URL 下的 /models 拉取模型列表,并弹出标题为 QCode · Choose models 的窗口,2.2.3 没有「获取模型列表」按钮;之后要重新拉,在服务商详情页点 Sync models。
  3. 3服务商详情页有 Model Check 按钮,可以用来试模型。

三个时间点:发布、第一条回复、第二个服务商

2026-11-19

Cherry Studio 2.2.3 稳定版发布,英文下载页把它写成 Stable Release · 11/19/2026 · Changelog;本次配置用的就是这个版本。

2026-11-21

在 Windows 11 英文界面上装好 2.2.3:Anthropic 栏填 https://api.qcode.cc/api,勾选 claude-sonnet-5-5,发 Say hello in one short sentence,收到 Hello!。

2026-11-21

同一把 cr_ key 再建第二个服务商 QCode OpenAI,OpenAI 栏填 https://api.qcode.cc/openai,不手写 /v1,勾 GPT-6.2 Sol 后模型正常入库。

已核实 vs 三处容易配错的地方

已核实(2026-11-21 实测与 docs 教程原文)

  1. 1地址:Anthropic 栏 https://api.qcode.cc/api 拼成 /api/v1/messages,OpenAI 栏 https://api.qcode.cc/openai 拼成 /openai/v1/chat/completions,两处都只填根地址,不带 /v1、不带尾斜杠。
  2. 2模型:Anthropic 端点拉到的 ID 是 claude-sonnet-5-5、claude-sonnet-5、claude-opus-5-5、claude-haiku-5-5;OpenAI 端点拉到 gpt-6.2-sol、gpt-6.2-astra,国产模型如 glm-5.3。
  3. 3拉列表:点 Add 后自动拉取,弹窗标题 QCode · Choose models,之后要重拉用详情的 Sync models;失败时弹窗里有 Add model manually、红色提示 Failed to pull models 与 Retry。
  4. 4协议边界:OpenAI 端点对 Claude 模型回 model_not_available_on_endpoint,国产模型在 Anthropic 端点也能答,Agent 功能要求服务商走 Anthropic 协议。
  5. 5账号:全程不需要 Cherry Studio 账号,也不需要模型厂商账号,欢迎页点 Set up later 即可。
  6. 6界面名:2.2.3 英文界面是 Model Provider、+ Add Provider、Sync models,旧版是 Model Services、+ Add a provider、sync models。

三处容易配错的地方

  1. 1类型:2.2.3 没有类型下拉,把根地址填进 Anthropic 栏就是在用 Anthropic 协议。
  2. 2/v1:Cherry 会自己拼 /v1/messages,手写 /v1 会变成 /api/v1/v1/messages,每个请求返回 404。
  3. 3账号:不需要 Cherry 账号,也不需要厂商账号,欢迎页点 Set up later,key 用控制台那把 cr_ 开头的。

API 地址怎么填:Anthropic 栏 vs OpenAI 栏

Anthropic 栏:接 Claude,国产模型也能答

Base URL 填 https://api.qcode.cc/api,预览路径 https://api.qcode.cc/api/v1/messages,能用的模型 ID 是 claude-sonnet-5-5、claude-sonnet-5、claude-opus-5-5、claude-haiku-5-5;docs 写明国产模型在 Anthropic 端点也能答,Agent 功能也要求服务商走 Anthropic 协议。

OpenAI 栏:接 GPT 与国产模型

Base URL 填 https://api.qcode.cc/openai,预览路径 https://api.qcode.cc/openai/v1/chat/completions,能用的模型 ID 是 gpt-6.2-sol、gpt-6.2-astra,国产模型如 glm-5.3;Claude 在这一栏会被拒,More options 里的 OpenAI Responses 填同一地址、只服务 GPT。

九步:从下载到第一条回复

  1. 1打开 cherryai.com/download,默认选中的就是 Windows · x64,点 Download Windows Standard,下载到的是 Cherry-Studio-2.2.3-win-x64-setup.exe,约 286 MiB。
  2. 2双击安装,英文向导只有 4 屏:Choose Installation Options、Choose Install Location、Installing、Completing Cherry Studio Setup;干净系统上第一次会先为 VC++ 运行库弹一次用户账户控制,发布者显示 Microsoft Corporation,装法是 per-user,不再需要管理员权限。
  3. 3启动后欢迎页点 Set up later,不进任何登录流程。
  4. 4点主界面左下角齿轮进 Settings,找到 Model Provider,点服务商列表最底部的 + Add Provider。
  5. 5在 Add Custom Provider 里,Provider Name 填一个名字(如 QCode),API Key 粘 cr_ 开头的 key,Anthropic 那一栏 Base URL 填 https://api.qcode.cc/api,只填根地址、不带 /v1。
  6. 6点 Add,Cherry 立刻拉模型并弹出 QCode · Choose models,勾 Claude Sonnet 5.5(行右侧灰字是 ID claude-sonnet-5-5)后点 Add selected models;随后弹出 QCode · Verify and enable 小窗,Cherry 用选中的模型发一次测试请求,完成后点 Done。
  7. 7回到聊天窗口,顶部模型按钮从 Select Model 变成 Claude Sonnet 5.5 | QCode,发一句 Say hello in one short sentence,收到 Hello! 就通了。
  8. 8可选:再点 + Add Provider 建第二个服务商,用同一把 cr_ key,这次 OpenAI 那一栏 Base URL 填 https://api.qcode.cc/openai,同样不带 /v1,勾 GPT-6.2 Sol。
  9. 9之后要在服务商详情页点 Sync models 重新拉列表,或用 Model Check 试模型;想确认请求到了 QCode,在 probe.qcode.cc 粘同一把 key 看流量。

QCode 侧:一把 cr_ key、两个服务商

协议由请求路径决定,key 不区分协议:同一把 cr_ 开头的 key,Anthropic 栏填 https://api.qcode.cc/api 走 Claude,OpenAI 栏填 https://api.qcode.cc/openai 走 GPT 与国产模型;把地址里的 api.qcode.cc 换成 asia.qcode.cc 或 us.qcode.cc,路径与 key 都不动。

按 token 计费,各模型单价见 /models。不想包月?按量包 ¥26 起买一笔额度,7 天内用完为止;已有个人套餐的用户额度不够时买加油包。想知道请求有没有到 QCode,在 probe.qcode.cc 粘同一把 key 看流量。

Cherry Studio 配置步骤与地址对照

docs 的 Cherry Studio 接入文档有完整的配置步骤、地址对照表和常见报错排查。下面两张图是配好之后的两个服务商卡片:第一张看 Anthropic 栏的根地址与预览路径,第二张看第二个服务商 OpenAI 栏的地址和列表里的 GPT-6.2 Sol。

英文界面:服务商 QCode 的 Anthropic API Host 为 https://api.qcode.cc/api,预览 https://api.qcode.cc/api/v1/messages,模型 Claude Sonnet 5.5。
核对第一步:Anthropic 栏的 API Host 应是 https://api.qcode.cc/api,下面一行预览显示 https://api.qcode.cc/api/v1/messages(英文界面)。
英文界面:第二个服务商 QCode OpenAI 的 API Host 为 https://api.qcode.cc/openai(不带 /v1),模型是 GPT-6.2 Sol。
核对第二步:第二个服务商的 API Host 是 https://api.qcode.cc/openai,不带 /v1,模型是 GPT-6.2 Sol(英文界面)。

Cherry Studio 2.2.3,Windows 11,2026-11-21 实测;截图为英文界面,界面文字随版本变化,以你手上的版本为准。

常见问题

Cherry Studio 2.2.3 里找不到「提供商类型」下拉,怎么选 Anthropic?

2.2.3 不需要再选类型:在 Add Custom Provider 弹窗里把 https://api.qcode.cc/api 填进 Anthropic 那一栏 Base URL,就是在用 Anthropic 协议,Claude 模型只能走这一栏。填成 OpenAI 栏的话,QCode 的 OpenAI 端点对 Claude 模型回 model_not_available_on_endpoint。旧教程里那个「提供商类型」下拉在 2.2.3 已经没有了。

Cherry Studio 的 API 地址要不要加 /v1?

不要加。只填根地址:Anthropic 栏 https://api.qcode.cc/api,OpenAI 栏 https://api.qcode.cc/openai,不带 /v1、也不带尾斜杠。Cherry 会自己拼 /v1/messages 或 /v1/chat/completions,手写 /v1 会拼成 /api/v1/v1/messages,每个请求都返回 404。docs 另有一条:地址末尾加 # 会关闭自动拼接,只给需要固定完整路径的服务商用,QCode 的地址用不到它。

报 model_not_available_on_endpoint 或每个请求都 404 怎么办?

这两种报错指向两个不同的错。model_not_available_on_endpoint 是模型放错了栏:Claude 模型被填进 OpenAI 栏,QCode 的 OpenAI 端点不服务 Claude,把根地址挪到 Anthropic 栏 https://api.qcode.cc/api 就好。每个请求都 404 时,先查 Base URL 里是不是手写了 /v1(Cherry 会拼成 /api/v1/v1/messages),把 Base URL 改回根地址 https://api.qcode.cc/api;改完在服务商详情页对一眼 Anthropic preview 那一行,路径对了才算通。

用 Cherry Studio 接 QCode 需要 Cherry 账号或 Anthropic 账号吗?

都不需要,只要一把 cr_ 开头的 QCode key。docs 写明全程不需要注册 Cherry Studio 账号,欢迎页点 Set up later 就能进主界面,配置全在本机。另有一处容易误会:Cherry 自动给会话起名用的是内置的 CherryAI 模型,未登录时会弹 Failed to auto-generate conversation name,这条提示跟 QCode 的回复无关。

为什么只发了一句 hello 就用了几万 token?

因为第一条对话在 Cherry Support 里,它是应用预置的 Agent,每条消息都带一段很长的系统提示,所以连一句 hello 也可能花掉几万 token。日常聊天改成在顶部点 Add Agent,新建一个普通助手并选 QCode 的模型。

点 Add 后提示 Failed to pull models、模型列表是空的怎么办?

先点弹窗里的 Retry 重试;还失败就核对 Base URL 是不是根地址(不带 /v1、不带尾斜杠),再用弹窗里的 Add model manually 手填模型 ID,Claude 填 claude-sonnet-5-5,GPT 填 gpt-6.2-sol。之后要重新拉列表,在服务商详情页点 Sync models。想确认请求到底有没有到 QCode,在 probe.qcode.cc 粘同一把 key 看流量。

来源

QCode 文档 Cherry Studio 接入教程(英文版,Windows,截图更新于 2026-11);2026-11-21 在 Windows 11 英文界面上的实测;Cherry Studio 英文官网下载页(2.2.3,2026-11-19 稳定版)。

在 Cherry Studio 里把 Claude 与 GPT 都接上

注册账号生成 cr_ key,Anthropic 栏填 https://api.qcode.cc/api,OpenAI 栏填 https://api.qcode.cc/openai;按 token 计费,各模型单价见 /models。

不确定从哪开始?

先试一周

小包 ¥26($30 额度,7 天)

每天都用

体验版 ¥63/月,每天 $5 额度;每 $1 额度只要 ¥0.42,中包约 ¥0.79