Cherry Studio 配置 Claude / GPT / DeepSeek API 指南
截至 2026-10-07，Cherry Studio 接 Claude API 的配法是：设置 → 模型服务 → 「+ 添加服务商」，类型选 Anthropic，API 地址只填根地址 https://api.qcode.cc/api，不带 /v1。GPT 以及 DeepSeek 等国产模型选 OpenAI 类型、地址填 https://api.qcode.cc/openai，两边填同一把 cr_ 密钥。本页按 QCode 文档与 Cherry Studio 官方文档逐条整理步骤、模型 ID 与常见报错。
更新于 2026-10-07
配置前先记住四件事
Claude 选的服务商类型
API 地址填 https://api.qcode.cc/api。QCode 文档写明 Claude 不能走 OpenAI 类型，Cherry Agent 也需要 Anthropic 协议的端点。
GPT 与国产模型的类型
API 地址填 https://api.qcode.cc/openai，Cherry 会自动拼成 /openai/v1/chat/completions。
API 地址怎么填
只填根地址，不带 /v1 与路径；手写 /v1 会被拼成 /v1/v1。确需关闭自动拼接时，在地址末尾加 #。
一把密钥两种类型通用
两种类型都填控制台创建的同一把 cr_ 密钥。Cherry 也支持一个服务商填多把密钥轮询使用，多把之间用英文逗号隔开。
Cherry Studio 接自定义 API 的思路
截至 2026-10-07，在 Cherry Studio 里接 Claude、GPT 或 DeepSeek，都是在设置 → 模型服务里添加一个自定义服务商：Claude 选 Anthropic 类型、填 https://api.qcode.cc/api，GPT 与国产模型选 OpenAI 类型、填 https://api.qcode.cc/openai。Cherry Studio 是开源的桌面客户端（社区版采用 AGPL-3.0 协议），支持 Windows、Mac 与 Linux；官方文档称内置 60+ 家服务商，不在列表里的服务只要提供 OpenAI 兼容、Anthropic 兼容等协议，都能作为自定义服务商添加。QCode 文档写明它没有账号体系、纯本地配置，不需要 Cherry Studio 账号，也不需要任何模型厂商账号。
Cherry Studio 最近几版（截至 2026-10-07）
截至 2026-10-07，GitHub Releases 上最新的正式版是 v2.1.4，发布于 2026-09-30（UTC）。它的发布说明写着「Add Claude Sonnet 5.5 and Opus 5.5 with thinking controls and native web-tool eligibility」，并加入了 OpenAI 与 OpenAI Codex 下的 GPT-6.1 Sol 支持。v2.1.3（2026-09-24）写明添加模型后会自动校验并启用服务商；v2.1.0（2026-09-18）加入了 DeepSeek V4.1 Flash。这些是 Cherry 内置模型目录的更新；接 QCode 时，模型 ID 仍按 QCode 文档填、以 /models 为准。QCode 的 Cherry Studio 文档是依据 v2.0.14 的官方文档核实的，界面标签可能随版本不同。
版本与文档时间线
Cherry Studio v2.0.14 发布；QCode 的 Cherry Studio 接入文档就是依据这一版的官方文档核实的。这一版起，出错时显示服务商给出的具体信息，不再只是「400 null」这类笼统错误。
QCode 的 Cherry Studio 接入文档更新并最后核实；同日 Cherry Studio v2.1.0 发布，内置目录加入 DeepSeek V4.1 Flash。
Cherry Studio v2.1.4 发布（UTC），内置目录加入 Claude Sonnet 5.5 与 Opus 5.5；截至 2026-10-07，它是 GitHub 上最新的正式版。
已确认 vs 文档没写的
已确认（文档原文逐字可核）
以下都能在 QCode 文档、Cherry Studio 官方文档或 GitHub 发布说明里逐字核到：Claude 走 Anthropic 类型、地址 https://api.qcode.cc/api；GPT 与国产模型走 OpenAI 类型、地址 https://api.qcode.cc/openai；两种类型用同一把 cr_ 密钥；API 地址只填根地址，末尾加 # 才关闭拼接；Claude 填进 OpenAI 类型会被拒并报 model_not_available_on_endpoint；OpenAI Responses 这个端点在 QCode 只服务 GPT 系；Cherry Agent 需要 Anthropic 协议端点（QCode 与 Cherry 官方两处都写）；服务商要打开启用开关，只有加入列表的模型才会出现在模型选择器里；v2.1.4 于 2026-09-30 发布。
文档没写或没核实的
三件事本页不下结论：① QCode 文档按 v2.0.14 核实，它自己也提醒设置页标签有 Model Services / Model Provider 两种写法，「获取模型列表」在有的版本显示为「同步模型」；v2.1.4 的界面本页没有实测，以你的客户端为准。② QCode 的 Cherry Studio 文档只给了国产模型走 OpenAI 类型这一种配法，其它组合文档没写，本页也不写。③ 图片生成与图片编辑有独立的 Base URL 配置项，QCode 文档写明未在该页验证 Cherry 侧行为。
选哪种服务商类型
Anthropic 对 OpenAI
看模型家族：Claude 只能走 Anthropic 类型（https://api.qcode.cc/api），QCode 的 OpenAI 端点对 Claude 直接拒绝；GPT 与 GLM、Kimi、DeepSeek、Qwen 这些国产模型走 OpenAI 类型（https://api.qcode.cc/openai）。另一条分界是 Agent：QCode 与 Cherry 官方文档都写明 Cherry Agent 需要 Anthropic 协议端点，想在应用里用 Agent，就配 Anthropic 类型。
OpenAI 对 OpenAI Responses
两者的 API 地址都填 https://api.qcode.cc/openai，区别在能调的模型：QCode 文档写明 Responses 这个端点只服务 GPT 系，Claude 与国产模型不可用。只接 GPT 时两种都行；要同时用 DeepSeek 等国产模型，选 OpenAI 类型。
六步接上 Claude（再加 GPT 与 DeepSeek）
① 打开设置 → 模型服务，点列表下方的「+ 添加服务商」，在「添加自定义提供商」弹窗里给它起个名字。② 类型选 Anthropic，API 地址填 https://api.qcode.cc/api，API 密钥填控制台创建的 cr_ 密钥。③ 点「获取模型列表」，或点「+」手动加模型 ID，例如 claude-sonnet-5；只有加入列表的模型才会出现在模型选择器里。④ 打开服务商右上角的启用开关，点「检测」并选一个模型，测试是否接通。⑤ 要接 GPT 与国产模型：类型选 OpenAI，API 地址填 https://api.qcode.cc/openai，密钥填同一把 cr_ 密钥，模型 ID 如 gpt-6-sol、deepseek-v4.1-flash、glm-5.3。⑥ 在任一聊天窗口选中新配的模型发一句话；看不到回复，先核对类型与地址是否匹配。
在 QCode 上
在 QCode 上，一把 cr_ 密钥（控制台创建）不区分协议，协议由请求路径决定：claude-sonnet-5、claude-sonnet-5-5、claude-opus-5-5 走 Anthropic 类型 https://api.qcode.cc/api；gpt-6-sol、gpt-5.6-terra 与 deepseek-v4.1-flash、glm-5.3、kimi-k3、qwen3.8-max 走 OpenAI 类型 https://api.qcode.cc/openai。三个接入域业务能力一致，同一把 key 都能用：北美与欧洲可用 us.qcode.cc（洛杉矶），中国大陆网络文档建议换成 asia.qcode.cc，路径不变。按 token 计费，各模型单价见 /models；每次请求都能在 probe.qcode.cc 输入 key 查看。
常见问题
Cherry Studio 里接 Claude 该选哪种服务商类型？
选 Anthropic。API 地址填 https://api.qcode.cc/api，密钥填你的 cr_ 密钥，再加模型 ID（如 claude-sonnet-5）或获取模型列表。QCode 文档写明 Claude 模型只能走 Anthropic 端点，不能走 OpenAI 类型。Cherry 自带的 Anthropic 服务商默认地址是 https://api.anthropic.com；QCode 文档给出的做法是另外添加一个自定义服务商。
报 model_not_available_on_endpoint 是什么意思？
说明协议选错了，不是密钥有问题。把 Claude 模型放进 OpenAI 类型，QCode 会返回 Model 'claude-sonnet-5' is not available on this endpoint. 这类错误；文档写明这个校验发生在鉴权之前，即使密钥无效也先报它。反过来，密钥错报的是 Invalid API key。解决办法：Claude 改用 Anthropic 类型、地址 https://api.qcode.cc/api。
API 地址要不要带 /v1 或末尾斜杠？
都不要。只填根地址，Cherry Studio 会按你选的类型自动拼接路径；手写 /v1 会被拼成 /v1/v1。QCode 接入点文档对 BASE_URL 的通用说法也是不要带尾部斜杠，否则会拼成 //v1/messages 导致 404。确实要用完整地址时，在末尾加 #，Cherry 就不再自动拼接，只用你填的地址。
填了 key 还是没法对话，或者模型选不到？
先查三处：服务商右上角的启用开关是否打开（不打开，模型不会出现在选择列表里）；模型是否已加入列表（只有加入列表的模型才会出现在模型选择器里）；类型与地址是否匹配。Cherry 官方常见问题还建议确认默认模型选的是该服务商下实际可用的模型，并用「检测」按钮测试；检测失败就查模型列表里有没有填错的 ID。别靠直接 curl https://api.qcode.cc/api 来判断：那样拿到的是一个 HTML 介绍页（HTTP 200），既不是报错，也不能说明路径可用。请求记录可在 probe.qcode.cc 输入 key 查看。
Cherry Agent 能用 QCode 的 Claude 吗？
能，按 Anthropic 类型配置即可。QCode 文档写明 Cherry Agent 功能需要支持 Anthropic 协议的端点，想用应用内的 Agent 能力，就按 Anthropic 类型、https://api.qcode.cc/api 配置；Cherry 官方的 Anthropic 页也写着 Agent 需要 Anthropic 协议端点。如果 Agent 提示必须启用 API 网关，点提示里的「启用并启动」，或到设置 → API 网关手动启动。
GPT 和 DeepSeek 用哪种类型、填什么模型 ID？
选 OpenAI 类型，API 地址填 https://api.qcode.cc/openai，密钥用同一把 cr_ 密钥。模型 ID 可填 gpt-6-sol、gpt-5.6-terra，或 deepseek-v4.1-flash、glm-5.3、kimi-k3、qwen3.8-max，当前在售型号以 /models 为准。也可以选 OpenAI Responses 类型，地址相同，但这个端点在 QCode 只服务 GPT 系，DeepSeek 等国产模型和 Claude 都不可用。
信息来源
配置步骤、服务商类型与地址：QCode 文档的 Cherry Studio 接入页（更新于 2026-09-18）与接入点与 API 格式页（更新于 2026-09-25，含哪些模型走哪个端点、报错原文与三个接入域），均于 2026-10-07 抓取。Cherry Studio 侧的界面与规则：Cherry Studio 官方文档（docs.cherryai.com.cn，旧域名 docs.cherry-ai.com 现 301 跳转到这里）的自定义服务商、模型服务设置、Anthropic、全部 Provider 快速参考与常见问题页，同日抓取。版本与平台：Cherry Studio GitHub 仓库的 README 与 Releases（v2.0.14 至 v2.1.4 的发布说明），同日抓取。
相关阅读
Claude Code 自定义端点配置
两个环境变量、settings.json 写法与 apiKeyHelper。
Cline 接 OpenAI 兼容 API 指南
在 Cline 里填三项配置接上 QCode。
怎么判断一个 AI API 中转值不值得用
四个可以自己动手做的检查。
本页步骤与引语核对于 2026-10-07，以 QCode 文档、Cherry Studio 官方文档与 GitHub 发布说明为准，上游调整不另行通知。客户端界面标签随版本变化，以你手上的版本为准；模型可用性以 /models 为准。