上周有个朋友在群里问我：「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
最基础的场景，直接填官方地址。
步骤：
- 打开 Cherry Studio，点击左下角设置图标（齿轮）
- 左侧菜单找到「模型服务商」
- 找到OpenAI（默认就有），点进去
- 填写两个字段：
API Key: sk-proj-xxxxxxxxxxxxxxxxxxxx Base URL: https://api.openai.com/v1- 点右上角「检查」按钮，验证连通性
- 勾选你需要的模型（GPT-5、GPT-4o 等）
- 保存，回到对话页面，顶部选模型就能用了
注意：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 协议，配置方式和方案一几乎一模一样：
步骤：
- 设置 → 模型服务商 → 点击「添加服务商」
- 选择「OpenAI Compatible」类型
- 名字随便写，我填的「ofox聚合」
- 填写：
API Key: 你在 ofox.ai 控制台拿到的 Key Base URL: https://api.ofox.ai/v1- 点击「检查」验证连通
- 手动添加模型名称（下面会讲怎么加）
添加模型的方法：
点「管理」或「添加模型」按钮，手动输入模型 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 的也可以直连：
- 设置 → 模型服务商 → 找到Anthropic
- 填写：
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：
- ofox聚合（OpenAI Compatible）—— 日常用，一个 Key 切所有模型
- Ollama 本地—— 跑一些本地小模型做测试
管理最简单，也不用操心各家 API 的鉴权差异和 Key 过期问题。
小结
Core 就三件事：
- 选对 Provider 类型（OpenAI Compatible 能覆盖 90% 的场景）
- Base URL 填到
/v1，不多不少 - 模型名称必须精确匹配 API 服务端
搞定这三点基本不会出问题。还是报错的话，八成是 Key 复制带了隐藏字符，先去纯文本编辑器里检查一遍。
有问题评论区聊，我看到都会回。
 指南 第六章：记忆与状态管理)
