Cherry Studio 接入 CCSub：添加自定义提供商和 API 地址填写
Cherry Studio 接第三方 API：设置 → 模型服务 → 添加服务商，OpenAI 地址填 https://www.ccsub.net/api/v1，Anthropic 填 https://www.ccsub.net。讲清 /v1 自动补全和 # 结尾规则。
复制即用的配置
把下面三项填进工具里即可。API Key 在控制台「API 密钥」页面创建。
- OpenAI 地址
https://www.ccsub.net/api/v1（已含 /v1，不会再重复补）- Anthropic 地址
https://www.ccsub.net（会自动补成 /v1/messages）- API 密钥
sk-你的CCSub密钥- 模型
claude-sonnet-5（点「同步模型」自动拉取）
model 可填 claude-sonnet-5 等，全部可用型号 ID 见 型号列表。 还没有 Key？ 先注册账号。
配置步骤速览
- 1
创建 CCSub API Key
注册 CCSub，在控制台「API 密钥」页面创建 sk- 开头的 Key。
- 2
添加服务商
打开 Cherry Studio，进入 设置 → 模型服务，点「添加服务商」，在「添加自定义提供商」里填提供商名称 CCSub 和 API 密钥。
- 3
填写端点地址
在端点设置里，OpenAI 填 https://www.ccsub.net/api/v1，Anthropic 填 https://www.ccsub.net；对照下方「请求路径」预览确认地址正确。
- 4
同步模型并检测
保存后在提供商页面点「同步模型」拉取型号列表，再点「检测」测试连通。
- 5
开始对话
新建对话，选择 CCSub 下的型号，例如 claude-sonnet-5，发一句话后到 CCSub「使用记录」核对。
Cherry Studio 是一款开源的桌面 AI 客户端，支持 Windows、macOS 和 Linux。它的 2.x 版本里，一个「提供商」可以同时填 OpenAI 和 Anthropic 两种端点地址，用同一把 Key。接 CCSub 唯一需要弄清楚的，是它会自动在地址后面补 /v1。
添加 CCSub 提供商（2.x 版本）
- 打开 设置 → 模型服务，点 「添加服务商」。
- 在弹出的 「添加自定义提供商」 里填写：
- 提供商名称
CCSub- API 密钥
sk-你的CCSub密钥- 端点设置 → OpenAI
https://www.ccsub.net/api/v1请求路径预览应为 /api/v1/chat/completions- 端点设置 → Anthropic
https://www.ccsub.net请求路径预览应为 /v1/messages
- 每个端点输入框下面都有一行 「请求路径：…」 预览，填完对照一下，和上表一致就没问题。第一个填写的端点会标上「默认」，想换可以点「设为默认」。
- 保存后在提供商页面点 「同步模型」，Cherry Studio 会从 CCSub 拉取型号列表；再点 「检测」 测试连通。
「更多设置」里还有 OpenAI Responses、Gemini 和图片生成的端点，接 CCSub 对话用不到，可以不填。
地址自动补 /v1 的规则
这是 Cherry Studio 最容易踩坑的地方，而且规则在版本更新中变过：
- 一般情况
自动补 /v1先去掉末尾的 /，再补上 /v1- 路径里已有版本号
不补例如 /api/v1、/v1，原样保留- 以 # 结尾
不补界面提示：在末尾添加 # 以禁用自动附加的 API 版本
按这个规则，https://www.ccsub.net/api/v1 路径里已经有 /v1，不会被重复添加；https://www.ccsub.net 会被补成 /v1，同样能用。两者最终都能访问 CCSub。
「/ 结尾忽略 v1」是旧规则。 Cherry Studio 1.6 及更早版本的界面提示是「/ 结尾忽略 v1 版本」，很多老教程还这么写。1.7 起提示里已经去掉了这一条。现在末尾的 / 会被直接去掉、照样补 /v1。如果你照老教程写了 https://www.ccsub.net/v1/，结果是 /v1/chat/completions，依然正确；但写成 https://www.ccsub.net/v1/v1 之类就会 404。
旧版 Cherry Studio（1.x）
1.x 版本添加提供商时有一个 「提供商类型」 下拉，选 OpenAI 或 Anthropic，地址按上面的填法写即可。获取型号的入口是 「管理」→「获取模型列表」，「API 密钥」「API 地址」「检测」这几个名字和 2.x 一样。
开始使用
新建一个对话，在顶部的型号选择里找到 CCSub 下的型号。model 可填 claude-sonnet-5 等，全部可用型号 ID 见 型号列表。发一句话后，到 CCSub 控制台的「使用记录」里能看到这次请求和扣费。
如果你同时还在用 Claude Code、Codex 这类命令行工具，可以用 CC Switch 统一管理它们的供应商配置；想在 VS Code / JetBrains 里使用，可以看 Continue 接入教程。
常见报错和排查
检测失败，提示 404
原因：地址里的 /v1 重复了（例如填了 https://www.ccsub.net/v1/v1），或者把 /chat/completions 也写进了地址。
处理：OpenAI 地址只填到 https://www.ccsub.net/api/v1，看「请求路径」预览是不是 /api/v1/chat/completions。
同步模型拿不到列表 / 返回网页
原因：地址拼出来的 /models 路径不对，请求落到了网站页面上。
处理：OpenAI 地址用 https://www.ccsub.net/api/v1，型号列表会从 /api/v1/models 拉取。
401 authentication_error: Invalid or disabled API key
原因：API 密钥粘贴时带了空格，或者 Key 在 CCSub 控制台已禁用。
处理：重新粘贴 Key，在控制台确认它是启用状态。
402 insufficient_balance
原因：账户余额不足，或月卡当日额度已用完。
处理：到 /zh/purchase 充值；月卡额度北京时间 0 点重置。
常见问题
地址末尾加 / 还能跳过 v1 吗？
不能了。这是旧版本（1.6 及以前）的规则，现在的版本会先去掉末尾的 /，再自动补 /v1。只有地址路径里已经有 /v1 这类版本号，或者以 # 结尾时，才不会自动补。网上的旧教程还在写「/ 结尾忽略 v1」，按新规则来即可。
OpenAI 地址填 https://www.ccsub.net 行不行？
可以，会被补成 https://www.ccsub.net/v1/chat/completions，同样能用。CCSub 文档统一写 https://www.ccsub.net/api/v1，路径里已有 /v1，Cherry Studio 不会重复添加。
# 结尾是什么意思？
在地址末尾加 # 表示「按我填的原样用，不要自动补版本号」。如果写成完整的接口地址加 #（例如 .../chat/completions#），就会直接请求这个完整地址。接 CCSub 一般用不到。
旧版 Cherry Studio（1.x）怎么配？
1.x 版本在「提供商类型」下拉里选 OpenAI 或 Anthropic，地址填法和本文相同；获取型号用「管理」→「获取模型列表」，检测按钮同样叫「检测」。
model 应该填什么？
点「同步模型」会从 CCSub 拉取全部型号 ID，也可以手动添加 claude-sonnet-5 等 ID，完整列表见 CCSub 型号列表页。
