← 幫助中心 · 桌面圖形客戶端

用 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`	日常主力，不確定選哪個就用它
`newcclm-fast`	回郵件、改文案、整理資料、日常提問
`newcclm-coding`	複雜分析、讀長文檔、寫代碼
`newcclm-free`	免費檔位，試用

不要填 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 配置 →