← 帮助中心 · 桌面图形客户端

用 Cherry Studio 连接 Newcclm

Cherry Studio 是桌面上的聊天客户端，有中文界面。它支持自定义 OpenAI 兼容服务商，加一条就能用上我们的档位。

重要：不要改内置的 OpenAI 提供方。 新建一个自定义提供方，否则 Cherry Studio 会按官方 OpenAI 的规则去请求，连不上我们。

1. 添加自定义提供方

打开 设置 → 模型服务，找到列表最下面的 「添加」，名称填 Newcclm，提供商类型选 OpenAI（它只是协议格式，不代表厂商）。

填这几个值

API 地址https://sccclm.com/v1

API 密钥你的 sk-* 密钥

模型名称newcclm-fast

个别版本的 Cherry Studio 会自动补路径。 如果填入 https://sccclm.com/v1 后报 404，试着只填 https://sccclm.com。两个都试一下，哪个通用哪个。

2. 添加模型

在刚建好的 Newcclm 提供方下面点 「添加模型」，模型 ID 填我们的档位名。两个都加上，用的时候在下拉里切：

模型 ID	什么时候用
`newcclm-fast`	回邮件、改文案、整理资料、日常提问
`newcclm-coding`	复杂分析、读长文档、写代码

不要填 gpt-4o、claude-*、deepseek-* 这类名字。 我们只认自己的档位名，填别的会报模型不存在。

3. 不要这样配

下面几个是最常见的错法：

不要改内置的 OpenAI / DeepSeek 提供方

内置条目的地址是写死的。改了地址但没改「提供商类型」，客户端可能仍按内置规则发请求。正确做法是新建一个提供方。

不要在地址后面加 /chat/completions

# 错误
https://sccclm.com/v1/chat/completions

# 正确
https://sccclm.com/v1

不要叠加 /v1

# 错误 —— 会变成 /v1/v1/...
https://sccclm.com/v1/v1

不要把密钥填进系统提示词或对话里

密钥只填在设置页的「API 密钥」字段。

4. 测一下

配置完成后在 Cherry Studio 里发一句「你好」。能回就通了。如果报错，先在终端里跑这条，用来分清是密钥问题还是客户端设置问题：

curl https://sccclm.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"newcclm-fast","messages":[{"role":"user","content":"你好"}]}'

结果	说明问题在哪
这条能通，客户端不通	客户端设置问题，看第 1、3 节
这条也不通	密钥或网络问题，和 Cherry Studio 无关

还是不行？

把这三样发给我们：

1. 设置页里 API 地址那一栏的截图（密钥打码）
2. Cherry Studio 报的完整错误
3. 上面那条 curl 的输出

← 返回帮助中心 · Chatbox 配置 →