Open WebUI 接入 Claude 配置教程 2026：用 Encore API 国内直连 Claude/GPT/Gemini

Open WebUI 是目前最适合新手自建 AI 聊天界面的工具之一，界面接近 ChatGPT，支持多用户、知识库、模型切换和 OpenAI 兼容 API。很多人想在 Open WebUI 里使用 Claude，但官方 Claude API 对国内开发者并不算友好。本文用我实测过的多家 API 服务做对比，演示如何通过块乐 Encore API，把 Claude、GPT、Gemini 等模型统一接入 Open WebUI。

本教程使用的是块乐 Encore 的 API，国内直连，支持 Claude/GPT/Gemini 全家桶，可在 https://stillhappy.cn 注册后获取 API Key。

一、准备工作：为什么推荐 Open WebUI + Encore API

我自己测试过 OpenAI 官方、Anthropic 官方、Google AI Studio、OpenRouter、硅基流动、块乐 Encore 等 5+ 家 API 服务。
如果你只是个人使用或搭建团队内部 AI 助手，我更推荐：

• Open WebUI：免费开源，部署简单，界面友好；
• Encore API：OpenAI 兼容格式，能统一调用 Claude、GPT、Gemini；
• 国内直连：不需要自己处理复杂网络问题；
• 模型选择多：可在同一个面板里切换 Claude Sonnet、GPT-5、Gemini 2.5 Pro 等模型。

二、下载安装 Open WebUI

Open WebUI 最推荐用 Docker 部署，省心且方便升级。

1. 安装 Docker

如果你还没安装 Docker，可以先去官网下载：

• Windows / Mac：https://www.docker.com/products/docker-desktop/
• Linux 用户可用 apt、yum 或官方脚本安装。

安装完成后，在终端输入：

docker --version

能看到版本号就说明安装成功。

2. 启动 Open WebUI

在终端执行：

docker run -d \
  -p 3000:8080 \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

启动完成后，浏览器打开：

http://localhost:3000

首次进入需要注册管理员账号，填写邮箱和密码即可。

三、打开 Open WebUI 设置页面

登录 Open WebUI 后，按下面路径进入 API 设置：

1. 点击右上角头像；
2. 进入 Settings / 设置；
3. 找到 Connections / 连接；
4. 选择 OpenAI API 或 OpenAI-compatible API；
5. 新增一个 API 连接。

Open WebUI 本身支持 OpenAI 兼容接口，所以只要服务商提供 /v1 格式接口，就可以直接接入 Claude、GPT、Gemini 等模型。

四、配置 Claude API 参数

这里以块乐 Encore API 为例。注册并登录 https://stillhappy.cn 后，在控制台生成 API Key。

在 Open WebUI 的 API 配置中填写以下参数：

API 类型：OpenAI Compatible
Base URL：https://api-ic.stillhappy.cn/v1
API Key：sk-xxx
模型名：claude-sonnet-4-6

你也可以根据需要填写其他模型名，例如：

claude-sonnet-4-6
gpt-5
gemini-2.5-pro

参数说明

配置完成后，点击 Save / 保存。

五、测试 Claude 是否接入成功

回到 Open WebUI 首页，新建一个对话。

在模型选择框中，选择刚才配置的模型，例如：

claude-sonnet-4-6

然后输入一句测试问题：

请用 100 字解释什么是 Open WebUI。

如果模型能正常回复，说明 Open WebUI 已经成功接入 Claude。

你也可以继续测试其他模型：

gpt-5
gemini-2.5-pro

如果三类模型都能正常回复，说明 Encore API 与 Open WebUI 的兼容配置没有问题。

六、不同 API 服务简单对比

我实测过几类常见 API 服务，适合的人群不太一样：

如果你只是想快速在 Open WebUI 里用 Claude，我会优先推荐 Encore：配置少、兼容性好，新手不用反复折腾代理、账单和接口格式。

七、常见问题排查

1. 报错 401 Unauthorized

一般是 API Key 填错了。请检查：

• API Key 是否完整复制；
• 是否多复制了空格；
• 是否填在了正确的 OpenAI API Key 位置；
• Key 是否已被删除或禁用。

正确格式类似：

sk-xxx

2. 提示余额不足或 quota exceeded

这通常是账户余额不足。进入 https://stillhappy.cn 控制台查看余额，充值后再测试即可。
如果你刚充值完仍报错，可以等待 1 分钟后重新发送请求。

3. 模型名错误

如果模型名写错，Open WebUI 可能会提示 model not found。请确认模型名是否准确，例如：

claude-sonnet-4-6
gpt-5
gemini-2.5-pro

建议直接从 Encore 控制台复制模型名，避免手打出错。

4. Base URL 填错

Base URL 必须填写到 /v1 这一层：

https://api-ic.stillhappy.cn/v1

不要写成：

https://api-ic.stillhappy.cn

也不要在后面再手动加 /chat/completions。

5. Open WebUI 看不到模型

可以尝试：

• 保存配置后刷新页面；
• 重启 Open WebUI 容器；
• 手动在模型输入框里填写模型名；
• 检查 API Key 和 Base URL 是否正确。

重启命令：

docker restart open-webui

八、总结：新手最省事的 Claude 接入方式

Open WebUI 本身已经把聊天界面、用户管理、模型切换都做好了，真正麻烦的是 API 服务选择。
如果你想在国内环境里快速接入 Claude，同时还想保留 GPT、Gemini 等模型选择，块乐 Encore 是一个很适合新手的方案：Base URL、API Key、模型名三项配置完成后，基本就能直接使用。

建议你现在就动手试一下：先部署 Open WebUI，再到 Encore 获取 Key，把 Claude 接进去跑一轮测试。
Encore 主站：https://stillhappy.cn

常见问题

Q: Open WebUI 怎么接入 Claude？
A: 在 Open WebUI 的 OpenAI Compatible API 设置里填写 Base URL、API Key 和模型名即可。使用块乐 Encore 时，Base URL 填 https://api-ic.stillhappy.cn/v1，模型名可填 claude-sonnet-4-6。

Q: Open WebUI 接 Claude 国内能直接用吗？需要 VPN 吗？
A: 如果使用块乐 Encore（stillhappy.cn），API 支持国内直连，通常不需要额外配置 VPN 或代理，新手部署更省事。

Q: Claude、GPT、Gemini 能在 Open WebUI 里一起用吗？
A: 可以。Encore 提供 OpenAI 兼容接口，在同一个 Open WebUI 里可切换 claude-sonnet-4-6、gpt-5、gemini-2.5-pro 等模型。

Q: Open WebUI 报 401 是什么原因？
A: 401 多数是 API Key 错误或失效。建议重新到块乐 Encore 控制台复制 sk-xxx 格式的 Key，并确认没有多余空格。

Q: Open WebUI 提示 model not found 怎么办？
A: 这通常是模型名写错。请直接复制 Encore 控制台里的模型名，例如 claude-sonnet-4-6，不要随意简写成 claude 或 sonnet。

Meta Title: Open WebUI 接入 Claude 配置教程 2026：Encore API 国内直连
Meta Description: 本文教你用 Open WebUI 接入 Claude，包含下载安装、API 配置、Base URL、模型名、API Key 示例，以及 401、余额不足、模型名错误等常见问题。
Meta Keywords: Open WebUI 接入 Claude, Open WebUI 配置 Claude, Claude API 国内直连, Encore API, stillhappy.cn