上周有个朋友在群里问我：「Cherry Studio 怎么配第三方 API 地址？官方文档写得太简略了，我填了 Base URL 但一直报错。」我当时随口说了几句，结果群里好几个人接着问，才发现踩这个坑的人还真不少。正好我自己从去年开始就一直在用 Cherry Studio 当主力聊天客户端，各种 Base URL 配过不下十来个，今天把完整的配置流程和踩坑经验一次性写清楚。

Cherry Studio 设置 Base URL 的核心步骤：打开设置 → 模型服务商 → 选择或新增 Provider → 填写 API Key 和 Base URL → 保存后在对话中选择对应模型即可。 整个过程不到 2 分钟，但有几个细节搞错了就会一直 400/401 报错，下面详细展开。

先说结论

配置项	正确示例	常见错误
Base URL 格式	https://api.xxx.com/v1	末尾多加了 /chat/completions
API Key	sk-xxxxxxx	复制时多了空格或换行符
模型名称	gpt-5、claude-sonnet-4-20250514	随便填、拼写错误
Provider 类型	OpenAI Compatible	选错了导致请求格式不对

记住一个原则：Cherry Studio 底层走的是 OpenAI 兼容协议，Base URL 只填到 /v1 就够了，后面的路径它会自己拼。

环境准备

• Cherry Studio 版本：v1.x 最新版（2026 年目前更新很勤，建议用最新的）
• 操作系统：Windows / macOS / Linux 都行
• 一个可用的 API Key（官方的或者第三方聚合平台的都行）

方案一：配置 OpenAI 官方 API

最基础的场景，直接填官方地址。

步骤：

1. 打开 Cherry Studio，点击左下角 设置图标（齿轮）
2. 左侧菜单找到 「模型服务商」
3. 找到 OpenAI（默认就有），点进去
4. 填写两个字段：

API Key: sk-proj-xxxxxxxxxxxxxxxxxxxx
Base URL: https://api.openai.com/v1

5. 点右上角 「检查」 按钮，验证连通性
6. 勾选你需要的模型（GPT-5、GPT-4o 等）
7. 保存，回到对话页面，顶部选模型就能用了

注意： Base URL 填 https://api.openai.com/v1，不要写成 https://api.openai.com/v1/chat/completions，Cherry Studio 会自动补全后面的路径。

方案二：配置第三方聚合 API（省事）

说实话我现在基本不直接连各家官方了。我日常要在 GPT-5、Claude Opus 4.6、Gemini 3、DeepSeek V3 之间来回切，每个单独配一个 Provider 管理起来烦死了，各家鉴权方式还不一样。

我目前用聚合 API 平台，一个 Key 打天下。这里以 ofox.ai 为例，它兼容 OpenAI 协议，配置方式和方案一几乎一模一样：

步骤：

1. 设置 → 模型服务商 → 点击 「添加服务商」
2. 选择 「OpenAI Compatible」 类型
3. 名字随便写，我填的「ofox聚合」
4. 填写：

API Key: 你在 ofox.ai 控制台拿到的 Key
Base URL: https://api.ofox.ai/v1

5. 点击 「检查」 验证连通
6. 手动添加模型名称（下面会讲怎么加）

添加模型的方法：

点「管理」或「添加模型」按钮，手动输入模型 ID：

gpt-5
claude-sonnet-4-20250514
gemini-3-pro
deepseek-v3
qwen-3-turbo
glm-5

每输一个回车确认，最后保存。回到对话页，顶部下拉就能看到这些模型了。

ofox.ai 是一个 AI 模型聚合平台，一个 API Key 可以调用 GPT-5、Claude Opus 4.6、Gemini 3 等 50+ 模型，低延迟直连无需代理，支持支付宝付款。配完之后在 Cherry Studio 里切模型就跟切频道一样，不用反复改 Base URL。

方案三：配置 Anthropic Claude（原生协议）

Cherry Studio 也内置了 Anthropic 的 Provider，有 Claude 官方 Key 的也可以直连：

1. 设置 → 模型服务商 → 找到 Anthropic
2. 填写：

API Key: sk-ant-xxxxxxxxxxxxxxxxxxxx
Base URL: https://api.anthropic.com

注意这里和 OpenAI 不一样，Anthropic 的 Base URL 不需要加 /v1。 Cherry Studio 针对 Anthropic Provider 做了适配，会自动用 Anthropic 协议格式发请求。

特别容易踩的坑——在 Anthropic Provider 下填 https://api.anthropic.com/v1 反而会 404。

整体调用流程

Cherry Studio 内部会根据 Provider 类型自动拼接不同的请求路径和格式。这就是为什么选对 Provider 类型特别重要。

踩坑记录

坑 1：Base URL 末尾的斜杠问题

❌ https://api.ofox.ai/v1/ （多了一个 /）
✅ https://api.ofox.ai/v1 （没有末尾斜杠）

有些版本的 Cherry Studio 会把末尾斜杠拼成 https://api.xxx.com/v1//chat/completions，双斜杠直接 404。永远不要在 Base URL 末尾加 /。

坑 2：API Key 复制带了隐藏字符

有次从网页控制台复制 Key，粘贴到 Cherry Studio 死活验证不过。后来把 Key 先粘到记事本里看了一眼，末尾有个 \n 换行符。建议先粘到纯文本编辑器里检查一下再填。

坑 3：模型名称必须精确匹配

Cherry Studio 在「OpenAI Compatible」模式下不会自动拉取模型列表（部分版本开始支持了，但不一定好使），需要手动填模型 ID。

这个 ID 必须和 API 服务端支持的完全一致：

✅ gpt-5
❌ GPT-5 （大小写错了）
❌ gpt5 （少了横杠）

✅ claude-sonnet-4-20250514
❌ claude-4-sonnet （顺序错了）

填错了不会报语法错误，而是返回 model not found。第一次遇到还以为是 Key 有问题，排查了半天。

坑 4：开了代理导致 SSL 错误

本机开着代理工具，Cherry Studio 有时候会报 SSL 证书错误。可以在设置里找到「代理设置」，选「不使用代理」或者把代理工具设为直连模式。用聚合平台的好处就是延迟本来就低（ofox.ai 大概 300ms 左右），不需要额外折腾网络。

我的配置方案

折腾了一圈之后，我现在 Cherry Studio 里就保留了两个 Provider：

1. ofox聚合（OpenAI Compatible）—— 日常用，一个 Key 切所有模型
2. Ollama 本地—— 跑一些本地小模型做测试

管理最简单，也不用操心各家 API 的鉴权差异和 Key 过期问题。

小结

Core 就三件事：

1. 选对 Provider 类型（OpenAI Compatible 能覆盖 90% 的场景）
2. Base URL 填到 /v1，不多不少
3. 模型名称必须精确匹配 API 服务端

搞定这三点基本不会出问题。还是报错的话，八成是 Key 复制带了隐藏字符，先去纯文本编辑器里检查一遍。

有问题评论区聊，我看到都会回。