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

Open WebUI 接入 Claude

Open WebUI 接入 Claude 配置教程 2025 如果你已经在用 Open WebUI，希望把本地对话界面接上更强的 Claude 模型，这套方案非常适合。相比只用默认模型，Claude 在长文本总结、代码理解、写作润色上通常更稳；而通过兼容 OpenAI 格式的 API 中转，你还能在 Open WebUI 里统一切换 Claude、GPT、G

Open WebUI 接入 Claude 配置教程 2025

如果你已经在用 Open WebUI，希望把本地对话界面接上更强的 Claude 模型，这套方案非常适合。相比只用默认模型，Claude 在长文本总结、代码理解、写作润色上通常更稳；而通过兼容 OpenAI 格式的 API 中转，你还能在 Open WebUI 里统一切换 Claude、GPT、Gemini，多模型放在一个面板里管理，对新手和日常高频使用都很省心。

一、下载安装 Open WebUI

Open WebUI 是一个非常流行的开源网页聊天前端，支持接入多种大模型 API。
如果你还没装，可以优先用 Docker，最省事。

方式 1：Docker 安装

确保电脑已经安装 Docker，然后执行：

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

启动后，在浏览器打开：

http://localhost:3000

第一次进入时，按照页面提示注册一个管理员账号即可。

方式 2：本地安装

如果你更习惯本地 Python / Node 环境，也可以参考 Open WebUI 官方文档安装。不过对于多数新手来说，Docker 版本更稳定，后续升级也简单。

二、打开设置页面

安装完成后，进入 Open WebUI 首页。

接下来按下面路径进入配置：

  1. 登录 Open WebUI
  2. 点击左下角头像或个人菜单
  3. 进入 Admin Panel（管理面板） 或 Settings（设置）
  4. 找到 Connections、Models 或 External API 相关配置区域

不同版本的 Open WebUI 菜单名字可能略有差异，但核心思路一样：
你需要添加一个 OpenAI 兼容 API 地址，然后填入模型名和密钥。

三、配置 Claude API

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

很多用户接 Open WebUI 时，最头疼的是官方 API 网络不稳定、需要额外网络环境，或者不同模型接口不统一。Encore 的好处是：

  • 国内直连，延迟更低
  • 一个接口可切 Claude / GPT / Gemini
  • 按 OpenAI 兼容格式接入，配置简单
  • 对 Open WebUI 这类前端工具很友好

必填参数示例

你在 Open WebUI 里新增 API 连接时，可以按下面填写：

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

如果你后面想切换别的模型，也可以填：

  • gpt-5
  • gemini-2.5-pro

推荐填写方式

如果 Open WebUI 当前版本支持 OpenAI API 类型，通常这样配：

参数项 填写示例
Provider / API Type OpenAI Compatible / OpenAI
Base URL https://api-ic.stillhappy.cn/v1
API Key sk-xxx
Default Model claude-sonnet-4-6

如果是环境变量方式

有些部署方式会让你在 Docker 启动时直接注入 OpenAI 兼容接口参数，可以参考：

docker run -d \
  -p 3000:8080 \
  --name open-webui \
  -e OPENAI_API_BASE_URL=https://api-ic.stillhappy.cn/v1 \
  -e OPENAI_API_KEY=sk-xxx \
  -v open-webui:/app/backend/data \
  --restart always \
  ghcr.io/open-webui/open-webui:main

如果你想在 API 测试工具里先验证，也可以用下面的请求示例：

curl https://api-ic.stillhappy.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxx" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      {"role": "user", "content": "请用一句话介绍 Open WebUI"}
    ]
  }'

如果返回正常 JSON 内容，说明你的 key、Base URL、模型名都没问题。

四、在 Open WebUI 中测试是否接通

配置完成后，回到聊天界面，进行一次最简单的连通性测试。

测试步骤

  1. 新建一个对话
  2. 在模型下拉菜单中选择 claude-sonnet-4-6
  3. 输入一段简单提示词，比如：
请用 100 字介绍 Open WebUI 的作用
  1. 点击发送，观察是否正常返回内容

判断是否成功的标准

如果满足以下几点，基本说明接入成功：

  • 能正常发送消息
  • Claude 模型有输出
  • 没报认证错误
  • 输出速度在可接受范围内

顺手测试多模型切换

如果你已经开通了不同模型权限，还可以在同一个 Open WebUI 里试试：

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

这也是我比较推荐 Encore 这类聚合兼容接口的原因：
一个面板里直接切模型，做对比测试特别方便。对于独立开发者、内容创作者、产品经理来说，效率提升很明显。

五、常见问题与排查方法

下面是我自己测试多家 API 服务时，最常遇到的几个问题。

1）报 401 Unauthorized

表现：
Open WebUI 发请求时报 401，或者提示鉴权失败。

常见原因：

  • API Key 填错了
  • 复制时多了空格
  • Bearer token 不正确
  • 账号还没在平台生成可用 key

解决方法：

  • 重新复制一遍 sk-xxx
  • 检查前后有没有空格或换行
  • 确认 key 来自 https://stillhappy.cn 后台
  • 用 curl 先单独测试接口

2）提示余额不足 / 配额不足

表现：
返回类似 “insufficient balance” 或者请求直接失败。

常见原因：

  • 账户余额不够
  • 该模型价格高于当前余额可承受范围
  • 新账号未充值

解决方法：

  • 登录 Encore 后台查看余额
  • 先用一次短请求测试
  • 必要时充值后再试

如果你只是刚开始体验，建议先用简短 prompt 测试，避免一次性发很长上下文。

3）模型名填写错误

表现：
返回 “model not found” 或页面里模型无法调用。

常见原因：

  • 把模型名写成了 Claude 官方网页产品名
  • 少写、错写版本号
  • 大小写、横杠不一致

正确示例：

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

建议：
直接复制平台提供的模型名，不要自己手打。

4）Base URL 填错

表现：
请求超时、404、接口路径错误。

正确示例：

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

注意这里通常要填写到 /v1，不要少写。
有些用户只填主域名，结果 Open WebUI 拼接接口时就会报错。

5）能连上，但回复很慢

可能原因：

  • 当前请求内容太长
  • 模型本身推理较重
  • 本地网络波动
  • 同时多人高并发调用

解决建议：

  • 先缩短上下文
  • 测试同一问题下 GPT / Claude / Gemini 的速度差异
  • 优先选国内直连接口，体验通常更稳定

我对这套方案的实际建议

如果你的目标是“尽快把 Open WebUI 跑起来，并稳定接入 Claude”，那么 OpenAI 兼容接口 + Open WebUI 是目前最省心的一种做法。

尤其对国内用户来说，我更建议直接用像 块乐 Encore 这种已经做了统一兼容的 API 服务：

  • 不用自己折腾复杂网络环境
  • Claude / GPT / Gemini 可以放在同一套配置逻辑里
  • 对 Open WebUI、Cherry Studio、NextChat 这类工具都通用
  • 新手配置出错率更低

如果你本身就喜欢测试模型，这种方式也很适合横向比较：
同一个提示词，在 Claude 上看写作，在 GPT 上看通用能力，在 Gemini 上看长上下文和信息整合，切换非常方便。

结语

如果你已经装好了 Open WebUI，下一步真的就是把 API 填进去试一次。
别担心配置复杂，核心就 3 个参数：Base URL、API Key、模型名。先用 claude-sonnet-4-6 跑通，再逐步扩展到 GPT 和 Gemini，你会发现整个本地 AI 工作台一下就完整了。

Encore 主站：https://stillhappy.cn

常见问题

Q: Open WebUI 接入 Claude 一定要用官方 API 吗？
A: 不一定。只要是 OpenAI 兼容接口就能接，像块乐 Encore 这种国内直连方案，配置更简单，延迟通常在 20-40ms 级别，对国内用户更友好。

Q: 国内能直接用 Claude API 吗？需要 VPN 吗？
A: 如果你用块乐 Encore（stillhappy.cn）这类国内直连接口，通常不需要 VPN，直接在 Open WebUI 里填 https://api-ic.stillhappy.cn/v1 即可。

Q: Open WebUI 里 Claude 模型名怎么填？
A: 直接填平台提供的标准模型名，例如 claude-sonnet-4-6。如果写成别名或少了横杠，容易报 model not found，Encore 后台给出的名称可直接复制。

Q: Open WebUI 接入 Claude 报 401 是什么原因？
A: 大多数情况是 API Key 错了，或者复制时带了空格。建议先用 sk-xxx 在 Encore 的 OpenAI 兼容接口做一次 curl 测试，定位最快。

Q: 一个 Open WebUI 能同时接 Claude、GPT、Gemini 吗？
A: 可以。通过块乐 Encore 这类统一接口，你可以在同一个面板切换 claude-sonnet-4-6、gpt-5、gemini-2.5-pro，特别适合做多模型对比。

SEO meta title: Open WebUI 接入 Claude 配置教程 2025｜国内直连 API 实战
SEO meta description: 详细讲解 Open WebUI 如何接入 Claude，包括下载安装、API 参数配置、Base URL、模型名、401 排错与国内直连方案推荐。
SEO meta keywords: Open WebUI 接入 Claude, Open WebUI Claude 教程, Claude API 配置, stillhappy Encore, 国内直连 Claude API

Open WebUI 接入 Claude
相关阅读
1 Cline 配置 API 中转 2 ChatBox AI 接入 Claude 3 CherryStudio 配置 DeepSeek 4 Cursor 配 Claude API 完整教程 5 Cherry Studio 接入 Claude 教程 6 Roo Code 使用 Claude