上周有个朋友在群里问我："Cherry Studio 那个 API 地址到底填什么？我填了官方的地址一直报 401。"说实话这个问题我去年刚用 Cherry Studio 的时候也卡了半小时，主要是它的设置界面改版过几次，网上很多教程截图都是旧版的，跟着做反而更懵。

直接回答：Cherry Studio 的 API 地址填写位置在「设置 → 模型服务商」里，点击对应服务商卡片进去后有个 Base URL 输入框。如果你用 OpenAI 官方就填 https://api.openai.com/v1，如果用聚合平台就填对应平台给你的地址，比如 https://api.ofox.ai/v1 或 https://openrouter.ai/api/v1。Key 填在旁边的 API Key 框里，保存后在对话界面选对应模型就能用了。

先说结论

场景	Base URL 填什么	注意事项
OpenAI 官方	https://api.openai.com/v1	需要代理环境
Anthropic 官方	https://api.anthropic.com	协议不同，要选 Anthropic 服务商
聚合平台（OpenRouter）	https://openrouter.ai/api/v1	5.5% 手续费
聚合平台（ofox.ai）	https://api.ofox.ai/v1	0% 加价，对齐官方价格
Azure OpenAI	你自己的 endpoint	格式是 https://xxx.openai.azure.com/

环境准备

• Cherry Studio 版本：v1.2.x 或以上（2026 年 4 月最新是 v1.2.7）
• 操作系统：Windows / macOS / Linux 都行
• 一个有效的 API Key

如果你还没装 Cherry Studio，去 GitHub releases 页面下载对应系统的安装包。macOS 用户注意 Apple Silicon 要下 arm64 版本，别下错了 x64 的——我第一次就下错了，打开巨慢还以为是 bug。

方案一：接入 OpenAI 兼容接口

最常见的场景。Cherry Studio 底层走的是 OpenAI SDK 格式，所以任何兼容 OpenAI API 格式的服务都能接。

步骤

1. 打开 Cherry Studio，点左下角齿轮图标进「设置」
2. 左侧菜单找到「模型服务商」
3. 你会看到一排预置的服务商卡片（OpenAI、Anthropic、Google 等），点击你要配置的那个
4. 填入两个字段：
   - API Key：你的密钥
   - Base URL：接口地址

# 示例配置（以聚合平台为例）
Base URL: https://api.ofox.ai/v1
API Key: sk-xxxxxxxxxxxxxxxx

1. 点「检查连接」按钮，弹出绿色 ✓ 就说明通了
2. 回到对话界面，顶部模型选择器里选你要用的模型

实测结果

配好之后测了一下，选 Claude Sonnet 4.6 发了一条消息，首 token 响应大概 1.2 秒，后续流式输出很顺滑。没啥问题。

方案二：接入 Anthropic 原生协议

这里有个坑。如果你想用 Claude 系列模型，Cherry Studio 支持两种方式：

• 走 OpenAI 兼容格式（大部分聚合平台都支持）
• 走 Anthropic 原生协议

区别在于：原生协议支持 Claude 的一些特有功能，比如 extended thinking、PDF 输入等。

步骤

1. 设置 → 模型服务商 → 找到「Anthropic」卡片（不是 OpenAI 那个）
2. Base URL 填：https://api.anthropic.com（官方）或你聚合平台的 Anthropic 兼容地址
3. API Key 填 Anthropic 格式的 key（sk-ant- 开头）

graph TD
 A[Cherry Studio 对话界面] --> B{选择哪个服务商?}
 B -->|OpenAI 兼容| C[Base URL: xxx/v1]
 B -->|Anthropic 原生| D[Base URL: api.anthropic.com]
 B -->|Google Gemini| E[Base URL: generativelanguage.googleapis.com]
 C --> F[支持 GPT/Claude/Gemini/DeepSeek 等]
 D --> G[仅 Claude 系列, 支持原生特性]
 E --> H[仅 Gemini 系列]

实测结果

用 Anthropic 原生协议接 Claude Opus 4.7，extended thinking 功能正常触发。但如果你只是日常聊天写代码，走 OpenAI 兼容格式就够了，没必要折腾原生协议。

方案三：自定义服务商（适合小众平台）

如果你用的平台不在预置列表里，Cherry Studio 支持添加自定义服务商。

1. 设置 → 模型服务商 → 拉到最下面 → 点「添加自定义服务商」
2. 填名称（随便写，给自己看的）
3. 填 Base URL 和 Key
4. 手动添加模型名称（这一步容易忘！不加模型名的话对话界面选不到）

模型名称要跟 API 实际支持的 model id 一致，比如 gpt-5.5、claude-sonnet-4.6、deepseek-v4 这种。填错了会报 model_not_found 错误。

踩坑记录

坑 1：Base URL 末尾的 /v1 到底要不要加

这个是问得最多的。答案：看平台。

• OpenAI 官方：要加 /v1 → https://api.openai.com/v1
• 有些聚合平台本身地址就带了 /v1，你再加一个就变成 /v1/v1 了，直接 404

我之前就犯过这个错，报错信息长这样：

Error: Request failed with status code 404
{"error":{"message":"Invalid URL (GET /v1/v1/chat/completions)","type":"invalid_request_error"}}

看到 /v1/v1 就知道是重复了。删掉一个就好。

坑 2：填了地址但模型列表是空的

Cherry Studio 有些版本不会自动拉取模型列表，需要你手动点一下「获取模型列表」按钮。如果点了还是空的，大概率是 Key 填错了或者网络不通。

先用 curl 测一下：

curl https://api.ofox.ai/v1/models \
 -H "Authorization: Bearer sk-你的key"

如果返回 JSON 模型列表就说明 Key 没问题，是 Cherry Studio 客户端的 bug。这时候手动在「模型管理」里添加你要用的模型 id 就行。

坑 3：Anthropic 的 Key 填到 OpenAI 服务商里

报错会是 401 Unauthorized，因为两边的 Key 格式和验证方式不一样。Anthropic 的 key 是 sk-ant-xxx 开头，OpenAI 的是 sk-xxx。如果你用的聚合平台统一了 Key 格式，那就无所谓，都填 OpenAI 兼容那个服务商就行。

完整代码验证

不放心的话，可以先用 Python 脚本验证你的 Key 和地址是否正常，再去 Cherry Studio 里配：

from openai import OpenAI

client = OpenAI(
 api_key="sk-你的key",
 base_url="https://api.ofox.ai/v1"
)

response = client.chat.completions.create(
 model="claude-sonnet-4.6",
 messages=[{"role": "user", "content": "说一句话测试连通性"}],
 max_tokens=50
)

print(response.choices[0].message.content)

跑通了就说明 Key 和地址都没问题，直接把同样的值填进 Cherry Studio 就行。

小结

Cherry Studio 配 API 地址这事不复杂，就三步：进设置、选服务商、填地址和 Key。容易踩的坑主要是 /v1 重复、Key 格式搞混、模型列表没手动刷新这几个。

我目前自己日常用的配置是一个聚合平台的地址挂在 OpenAI 兼容服务商下面，Claude、GPT、DeepSeek V4 预览版都能从一个入口调，切模型不用来回改地址。折腾一次之后基本就不用再动设置了。