上周把本地 AI 客户端从 ChatBox 换到了 Cherry Studio界面确实好看不少多模型切换也顺手。但配置 Base URL 这步硬是折腾了大半天——官方文档写得太简略网上教程各说各话不少还是过时的截图。所以把自己踩坑到跑通的过程记下来希望帮你省点时间。核心操作打开设置 → 模型服务商 → 选择或新建 Provider → 在「API 地址」栏填入 Base URL如https://api.openai.com/v1或聚合平台地址填入 API Key保存即可。下面展开讲不同场景的配置和踩过的坑。先说结论场景Base URL适合谁OpenAI 官方https://api.openai.com/v1能直连 OpenAI 的用户Anthropic 官方https://api.anthropic.comClaude 用户聚合平台如 ofox.aihttps://api.ofox.ai/v1想一个 Key 用多个模型、免代理直连Azure OpenAIhttps://{resource}.openai.azure.com/openai企业用户本地 Ollamahttp://localhost:11434/v1跑本地模型大多数人卡在两个地方一是不知道 URL 结尾要不要加/v1二是 Provider 类型选错了。下面逐个拆解。环境准备Cherry Studio 版本v1.x 最新版2026 年 6 月我用的是从 GitHub Releases 下的最新包操作系统macOS / Windows 都行配置界面一样API Key至少准备一个官方的或聚合平台的都行打开 Cherry Studio 后点左下角齿轮图标进入「设置」左侧菜单找到「模型服务商」这就是主战场。方案一直接配置 OpenAI / Anthropic 官方地址Cherry Studio 内置了主流服务商的预设OpenAI、Anthropic、Google Gemini 这些点进去就有。操作步骤在「模型服务商」列表找到OpenAI点进去「API 密钥」填你的 Key「API 地址」默认已填好https://api.openai.com/v1不用动点「检查」按钮显示绿色对勾就成了下方「模型列表」点「管理」勾选要用的模型GPT-5、GPT-4o 等Anthropic 稍有不同Base URL 填https://api.anthropic.com注意不带/v1。这是我踩的第一个坑——手贱加了/v1一直报 404。# OpenAI 格式带 /v1 https://api.openai.com/v1 ✅ # Anthropic 格式不带 /v1 https://api.anthropic.com ✅ https://api.anthropic.com/v1 ❌ 会 404方案二配置聚合平台一个 Key 用多个模型这是我现在日常在用的方案原因很简单同时用 GPT-5 写代码、Claude Opus 4.6 做长文档分析、DeepSeek V3 跑中文任务分别管三个 Key 太烦了。我目前用的是 ofox.ai一个 AI 模型聚合平台一个 API Key 可以调用 GPT-5、Claude Opus 4.6、Gemini 3、DeepSeek V3、Qwen 3、GLM5 等 50 模型兼容 OpenAI API 协议支持支付宝付款按量计费。Cherry Studio 配置步骤在「模型服务商」页面点左下角号新建服务商名字随便取我写的「ofox聚合」Provider 类型选OpenAI因为兼容 OpenAI 协议API 地址填https://api.ofox.ai/v1API 密钥填你在 ofox.ai 拿到的 Key点「检查」绿色对勾就 OK手动添加模型点「管理」→「添加」模型 ID 填实际的模型名# 常用模型 ID 示例根据平台文档填 gpt-5 claude-opus-4-20250918 gemini-3-pro deepseek-chat qwen-max glm-5Base URL: api.ofox.ai/v1Cherry Studioofox.ai 聚合网关GPT-5Claude Opus 4.6Gemini 3DeepSeek V3GLM5 / Qwen 3配好之后在聊天界面切模型下拉菜单直接选不用来回切 Provider。方案三接本地 OllamaOllama 默认启动后监听localhost:11434。# Base URL 填这个 http://localhost:11434/v1API Key 随便填个字符串就行Ollama 不校验比如填ollama。然后手动添加 pull 下来的模型名比如llama3.3、qwen3:8b。有一点要注意如果 Ollama 跑在 WSL 或 Docker 里localhost可能不通得换成实际 IP比如http://172.17.0.1:11434/v1。踩坑记录坑 1URL 结尾的/v1到底加不加没有统一答案取决于服务商OpenAI 协议兼容的OpenAI 官方、聚合平台、Ollama加/v1Anthropic 官方不加Azure OpenAI不加/v1路径格式也完全不同我的经验先加/v1试报 404 就去掉。坑 2检查通过但聊天报错遇到过「检查」按钮显示绿色发消息却报model not found。原因是模型 ID 写错了——Cherry Studio 的检查只验证 Key 是否有效不验证模型是否存在。解决办法去服务商的文档或控制台确认准确的模型 ID别凭记忆瞎写。比如 Claude 的模型 ID 不是claude-4.6而是claude-opus-4-20250918这种带日期的格式。坑 3新建 Provider 后模型列表为空Cherry Studio 对内置服务商会自动拉模型列表对自定义 Provider 不会。得手动添加模型这个交互不太明显我一开始以为是 Bug。坑 4流式输出卡住有一次配了个 Provider普通请求没问题开了流式输出就卡在那不动。最后发现是代理软件拦截了 SSE 长连接关掉对应域名的拦截规则就好了。用低延迟直连的聚合平台没这个问题不过看个人网络环境。坑 5多个 Provider 的模型重名同时配了 OpenAI 官方和聚合平台两边都有gpt-5聊天时下拉菜单会出现两个同名选项很容易选错。建议给自定义 Provider 的模型加个前缀比如ofox/gpt-5一眼分清。完整配置验证脚本不确定 Base URL 和 Key 是否正确可以先用命令行验证排除 Cherry Studio 本身的问题# 验证 OpenAI 兼容接口curl-shttps://api.ofox.ai/v1/chat/completions\-HAuthorization: Bearer YOUR_API_KEY\-HContent-Type: application/json\-d{ model: gpt-5, messages: [{role: user, content: 说一个程序员笑话}], max_tokens: 100 }|python3-mjson.tool返回了正常的 JSON 响应有choices字段说明 URL 和 Key 没问题那就是 Cherry Studio 端的配置有误再逐项排查。# Python 验证脚本fromopenaiimportOpenAI clientOpenAI(api_keyyour-key,base_urlhttps://api.ofox.ai/v1# 换成你实际用的 Base URL)respclient.chat.completions.create(modelgpt-5,messages[{role:user,content:Hello}],max_tokens50)print(resp.choices[0].message.content)跑通了再回 Cherry Studio 配心里有底。小结配置本身不复杂核心就三步选对 Provider 类型、填对 URL注意/v1、填对模型 ID。但每步都有坑尤其是模型 ID官方文档更新经常跟不上模型发布节奏。我现在的用法本地跑个 Ollama 处理不敏感的日常任务需要强模型时切到聚合平台调 GPT-5 或 Claude Opus 4.6。Cherry Studio 的多 Provider 管理在这个场景下比 ChatBox 顺手虽然偶尔有些小毛病够用了。有问题评论区聊踩到新坑会更新。
Cherry Studio 怎么设置 Base URL？2026 最完整的配置教程 + 踩坑实录
上周把本地 AI 客户端从 ChatBox 换到了 Cherry Studio界面确实好看不少多模型切换也顺手。但配置 Base URL 这步硬是折腾了大半天——官方文档写得太简略网上教程各说各话不少还是过时的截图。所以把自己踩坑到跑通的过程记下来希望帮你省点时间。核心操作打开设置 → 模型服务商 → 选择或新建 Provider → 在「API 地址」栏填入 Base URL如https://api.openai.com/v1或聚合平台地址填入 API Key保存即可。下面展开讲不同场景的配置和踩过的坑。先说结论场景Base URL适合谁OpenAI 官方https://api.openai.com/v1能直连 OpenAI 的用户Anthropic 官方https://api.anthropic.comClaude 用户聚合平台如 ofox.aihttps://api.ofox.ai/v1想一个 Key 用多个模型、免代理直连Azure OpenAIhttps://{resource}.openai.azure.com/openai企业用户本地 Ollamahttp://localhost:11434/v1跑本地模型大多数人卡在两个地方一是不知道 URL 结尾要不要加/v1二是 Provider 类型选错了。下面逐个拆解。环境准备Cherry Studio 版本v1.x 最新版2026 年 6 月我用的是从 GitHub Releases 下的最新包操作系统macOS / Windows 都行配置界面一样API Key至少准备一个官方的或聚合平台的都行打开 Cherry Studio 后点左下角齿轮图标进入「设置」左侧菜单找到「模型服务商」这就是主战场。方案一直接配置 OpenAI / Anthropic 官方地址Cherry Studio 内置了主流服务商的预设OpenAI、Anthropic、Google Gemini 这些点进去就有。操作步骤在「模型服务商」列表找到OpenAI点进去「API 密钥」填你的 Key「API 地址」默认已填好https://api.openai.com/v1不用动点「检查」按钮显示绿色对勾就成了下方「模型列表」点「管理」勾选要用的模型GPT-5、GPT-4o 等Anthropic 稍有不同Base URL 填https://api.anthropic.com注意不带/v1。这是我踩的第一个坑——手贱加了/v1一直报 404。# OpenAI 格式带 /v1 https://api.openai.com/v1 ✅ # Anthropic 格式不带 /v1 https://api.anthropic.com ✅ https://api.anthropic.com/v1 ❌ 会 404方案二配置聚合平台一个 Key 用多个模型这是我现在日常在用的方案原因很简单同时用 GPT-5 写代码、Claude Opus 4.6 做长文档分析、DeepSeek V3 跑中文任务分别管三个 Key 太烦了。我目前用的是 ofox.ai一个 AI 模型聚合平台一个 API Key 可以调用 GPT-5、Claude Opus 4.6、Gemini 3、DeepSeek V3、Qwen 3、GLM5 等 50 模型兼容 OpenAI API 协议支持支付宝付款按量计费。Cherry Studio 配置步骤在「模型服务商」页面点左下角号新建服务商名字随便取我写的「ofox聚合」Provider 类型选OpenAI因为兼容 OpenAI 协议API 地址填https://api.ofox.ai/v1API 密钥填你在 ofox.ai 拿到的 Key点「检查」绿色对勾就 OK手动添加模型点「管理」→「添加」模型 ID 填实际的模型名# 常用模型 ID 示例根据平台文档填 gpt-5 claude-opus-4-20250918 gemini-3-pro deepseek-chat qwen-max glm-5Base URL: api.ofox.ai/v1Cherry Studioofox.ai 聚合网关GPT-5Claude Opus 4.6Gemini 3DeepSeek V3GLM5 / Qwen 3配好之后在聊天界面切模型下拉菜单直接选不用来回切 Provider。方案三接本地 OllamaOllama 默认启动后监听localhost:11434。# Base URL 填这个 http://localhost:11434/v1API Key 随便填个字符串就行Ollama 不校验比如填ollama。然后手动添加 pull 下来的模型名比如llama3.3、qwen3:8b。有一点要注意如果 Ollama 跑在 WSL 或 Docker 里localhost可能不通得换成实际 IP比如http://172.17.0.1:11434/v1。踩坑记录坑 1URL 结尾的/v1到底加不加没有统一答案取决于服务商OpenAI 协议兼容的OpenAI 官方、聚合平台、Ollama加/v1Anthropic 官方不加Azure OpenAI不加/v1路径格式也完全不同我的经验先加/v1试报 404 就去掉。坑 2检查通过但聊天报错遇到过「检查」按钮显示绿色发消息却报model not found。原因是模型 ID 写错了——Cherry Studio 的检查只验证 Key 是否有效不验证模型是否存在。解决办法去服务商的文档或控制台确认准确的模型 ID别凭记忆瞎写。比如 Claude 的模型 ID 不是claude-4.6而是claude-opus-4-20250918这种带日期的格式。坑 3新建 Provider 后模型列表为空Cherry Studio 对内置服务商会自动拉模型列表对自定义 Provider 不会。得手动添加模型这个交互不太明显我一开始以为是 Bug。坑 4流式输出卡住有一次配了个 Provider普通请求没问题开了流式输出就卡在那不动。最后发现是代理软件拦截了 SSE 长连接关掉对应域名的拦截规则就好了。用低延迟直连的聚合平台没这个问题不过看个人网络环境。坑 5多个 Provider 的模型重名同时配了 OpenAI 官方和聚合平台两边都有gpt-5聊天时下拉菜单会出现两个同名选项很容易选错。建议给自定义 Provider 的模型加个前缀比如ofox/gpt-5一眼分清。完整配置验证脚本不确定 Base URL 和 Key 是否正确可以先用命令行验证排除 Cherry Studio 本身的问题# 验证 OpenAI 兼容接口curl-shttps://api.ofox.ai/v1/chat/completions\-HAuthorization: Bearer YOUR_API_KEY\-HContent-Type: application/json\-d{ model: gpt-5, messages: [{role: user, content: 说一个程序员笑话}], max_tokens: 100 }|python3-mjson.tool返回了正常的 JSON 响应有choices字段说明 URL 和 Key 没问题那就是 Cherry Studio 端的配置有误再逐项排查。# Python 验证脚本fromopenaiimportOpenAI clientOpenAI(api_keyyour-key,base_urlhttps://api.ofox.ai/v1# 换成你实际用的 Base URL)respclient.chat.completions.create(modelgpt-5,messages[{role:user,content:Hello}],max_tokens50)print(resp.choices[0].message.content)跑通了再回 Cherry Studio 配心里有底。小结配置本身不复杂核心就三步选对 Provider 类型、填对 URL注意/v1、填对模型 ID。但每步都有坑尤其是模型 ID官方文档更新经常跟不上模型发布节奏。我现在的用法本地跑个 Ollama 处理不敏感的日常任务需要强模型时切到聚合平台调 GPT-5 或 Claude Opus 4.6。Cherry Studio 的多 Provider 管理在这个场景下比 ChatBox 顺手虽然偶尔有些小毛病够用了。有问题评论区聊踩到新坑会更新。
