AI 工具测评
API 接入 AI 工具研究员 3 views

Open WebUI 接入 Claude

Open WebUI 接入 Claude 配置教程 2026 Open WebUI 是我目前最常用的本地 AI 聊天面板之一，界面接近 ChatGPT，支持多用户、模型切换、知识库和 OpenAI Compatible API。对于国内用户来说，直接接入 Claude、GPT、Gemini 往往会遇到网络、支付、Key 管理等问题。所以这篇教程会用 块乐 E

Open WebUI 接入 Claude 配置教程 2026

Open WebUI 是我目前最常用的本地 AI 聊天面板之一，界面接近 ChatGPT，支持多用户、模型切换、知识库和 OpenAI-Compatible API。对于国内用户来说，直接接入 Claude、GPT、Gemini 往往会遇到网络、支付、Key 管理等问题。所以这篇教程会用 块乐 Encore API 演示 Open WebUI 接入 Claude 的完整流程：国内直连，统一兼容 Claude / GPT / Gemini，更适合新手快速跑通。

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

一、下载安装 Open WebUI

Open WebUI 最推荐的安装方式是 Docker，配置简单、升级方便，Windows、macOS、Linux 都能用。

1. 安装 Docker

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

安装完成后，打开终端执行：

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
  5. 开启 OpenAI-Compatible 接口配置

Open WebUI 本身不只支持 OpenAI，也可以通过“OpenAI 兼容接口”接入第三方聚合 API。块乐 Encore 就是这种方式：一个 Base URL + 一个 API Key，可以调用 Claude、GPT、Gemini 等模型。

我实测过 5 家以上 API 服务，体验差异主要在三点：

  • 是否国内直连
  • 模型是否齐全
  • 报错是否清晰、扣费是否透明

如果你只是想在 Open WebUI 里稳定使用 Claude，我会更推荐使用 Encore 这类国内直连服务，少折腾网络环境。

三、配置 API 参数

在 Open WebUI 的 OpenAI API 配置区域，填写以下参数。

API 配置示例

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

说明：

  • Base URL：填写 https://api-ic.stillhappy.cn/v1
  • API Key：在块乐 Encore 后台获取，格式类似 sk-xxx
  • 模型名：可以填写你要调用的模型，例如：
    • claude-sonnet-4-6
    • gpt-5
    • gemini-2.5-pro

这里用的是块乐 Encore 的 API，国内直连，支持 Claude/GPT/Gemini 全家桶，在 https://stillhappy.cn 注册后获取 key。

推荐模型选择

如果你主要写作、总结、代码解释，我建议优先用：

claude-sonnet-4-6

Claude 系列在长文本理解、中文写作、复杂指令遵循上表现比较稳。

如果你需要通用问答和工具生态，可以试：

gpt-5

如果你需要长上下文、多模态或 Google 系模型，可以试：

gemini-2.5-pro

填写完成后，点击保存。

四、测试 Claude 是否接入成功

回到 Open WebUI 首页，新建一个聊天窗口。

在模型下拉框里选择你刚才配置的模型，例如：

claude-sonnet-4-6

然后输入一条测试消息：

请用 3 点总结 Open WebUI 接入 Claude 的好处。

如果配置正常，几秒内就会返回内容。

你也可以继续测试中文长文本能力，例如：

请帮我把下面这段内容改写成小红书风格，要求自然、口语化、不要夸张。

如果能正常输出，说明 Open WebUI 已经成功通过 Encore API 接入 Claude。

五、常见问题排查

1. 报错 401 Unauthorized

401 通常是 API Key 错误。

请检查：

  • API Key 是否复制完整
  • 是否多复制了空格
  • 是否填到了正确位置
  • Key 是否已在 Encore 后台启用

示例格式应类似：

sk-xxxxxxxxxxxxxxxx

不要把 Base URL 填到 API Key 里，也不要把 Key 写进模型名。

2. 提示余额不足或 billing error

如果出现余额不足、insufficient balance、billing error 等提示，说明账号额度不够。

处理方法：

  1. 登录块乐 Encore 后台
  2. 查看余额或用量
  3. 充值后重新测试

Encore 对国内用户比较友好的一点是注册、充值和使用流程更顺，不需要额外处理海外支付问题。

3. 模型名填写错误

模型名写错时，Open WebUI 可能会提示 model not found、invalid model，或者直接无法返回。

请确认模型名是否和平台后台一致，例如：

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

建议第一次配置时先手动输入一个确定可用的模型，不要随意改大小写或添加空格。

4. Base URL 填错

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

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

不要写成：

https://api-ic.stillhappy.cn

也不要加多余路径，例如：

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

Open WebUI 会自动拼接接口路径，你只需要填写基础地址。

六、我的实测建议：哪类用户适合这样配？

如果你只是偶尔体验 Claude，其实网页端也能用；但如果你希望长期使用、多模型切换、统一管理聊天记录，Open WebUI 更适合。

我对比过几类方案：

  • 官方 API：稳定，但国内网络和支付门槛较高
  • 海外中转 API：模型多，但延迟和可用性不稳定
  • 国内聚合 API：上手快，适合个人开发者和内容创作者
  • 本地模型：隐私好，但显卡和模型能力有门槛

综合来看，Open WebUI + 块乐 Encore 的组合比较适合新手：安装一次，后面只需要换模型名，就能在 Claude、GPT、Gemini 之间切换。

如果你想快速搭一个自己的 AI 聊天工作台，可以直接去 Encore 主站注册获取 Key：

https://stillhappy.cn

常见问题

Q: Open WebUI 怎么接入 Claude？
A: 在 Open WebUI 的 OpenAI 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）可以国内直连，一般不需要 VPN，适合国内开发者和内容创作者快速配置。

Q: Claude API Key 在哪里获取？
A: 可以在块乐 Encore 官网注册后获取 API Key，格式类似 sk-xxx。一个 Key 可用于 Open WebUI 接入 Claude、GPT、Gemini 等模型。

Q: Open WebUI 报 401 是什么原因？
A: 401 基本是 API Key 错误或未生效。建议重新复制 Encore 后台的 Key，确认没有空格，并检查余额和权限。

Q: Open WebUI 可以同时用 Claude、GPT、Gemini 吗？
A: 可以。通过 Encore 这类 OpenAI-Compatible API，只要切换模型名，例如 claude-sonnet-4-6、gpt-5、gemini-2.5-pro，就能在 Open WebUI 里统一调用。

Meta Title: Open WebUI 接入 Claude 配置教程 2026：使用 Encore API 国内直连
Meta Description: 本文详细讲解 Open WebUI 如何接入 Claude，包括 Docker 安装、API 设置、Base URL、模型名、API Key 示例和常见报错排查。
Meta Keywords: Open WebUI 接入 Claude, Open WebUI 配置 Claude, Claude API, Encore API, stillhappy.cn, OpenAI Compatible API

Open WebUI 接入 Claude
相关阅读
1 OneAPI 国内中转配置 2 Cursor 配 Claude API 完整教程 3 Cherry Studio 接入 Claude 教程 4 Cline 使用满血 GPT-5.5 5 Cursor 配 image2 生图 6 OneAPI 国内中转配置