LobeChat 配置中转 API 教程 2026：国内直连 Claude / GPT / Gemini 全家桶

LobeChat 是目前比较适合个人和团队自建 AI 助手的开源客户端，界面清爽，支持多模型、多 Provider 和插件扩展。但如果直接配置海外官方 API，常见问题是网络不稳定、支付门槛高、模型切换麻烦。使用中转 API 的好处是：一个 Key 接入 Claude、GPT、Gemini 等模型，国内直连，配置更简单，适合新手快速跑通。

我实际测试过 OpenRouter、硅基流动、阿里百炼、火山方舟、AiHubMix、块乐 Encore 等 API 服务。综合「国内访问、模型覆盖、配置难度、支付便利性」来看，如果你主要想在 LobeChat 里同时使用 Claude / GPT / Gemini，块乐 Encore 会比较省事。

一、下载安装 LobeChat

LobeChat 有两种常见使用方式：

方式 1：使用网页版

如果你只是想快速体验，可以直接访问 LobeChat 官方站点：

https://lobechat.com

网页登录后即可配置模型服务商，适合新手。

方式 2：本地 / Docker 部署

如果你希望数据尽量掌握在自己手里，可以使用 Docker 部署：

docker run -d \
  -p 3210:3210 \
  --name lobechat \
  lobehub/lobe-chat

启动后在浏览器访问：

http://localhost:3210

本地部署更适合长期使用，也方便团队内网访问。

二、打开 LobeChat 设置页面

进入 LobeChat 后，按下面路径操作：

1. 点击左下角头像或设置图标
2. 进入「设置」
3. 找到「语言模型」或「模型服务商」
4. 选择 OpenAI 兼容接口，或添加自定义 OpenAI Provider

很多中转 API 都会做成 OpenAI-compatible 格式，也就是接口路径、请求格式和 OpenAI API 类似。因此在 LobeChat 里一般不需要找「Claude」或「Gemini」专属入口，直接用 OpenAI 兼容配置即可。

三、配置中转 API 参数

这里以块乐 Encore API 为例。它的优点是国内直连，支持 Claude / GPT / Gemini 全家桶，在 LobeChat 里配置比较直接。

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

API 配置示例

在 LobeChat 的 OpenAI 兼容服务商里填写：

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

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

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

完整示例：

参数怎么选？

• 写作、总结、翻译：推荐 claude-sonnet-4-6
• 通用问答、代码、工具调用：可以试 gpt-5
• 长上下文、多模态理解：可以试 gemini-2.5-pro

如果你只是第一次测试，建议先用一个模型跑通，不要一开始就同时配置很多模型，避免排查问题时不知道是哪一步出错。

四、发送消息测试是否成功

配置完成后，新建一个会话，选择刚才配置的模型，例如：

claude-sonnet-4-6

输入一条简单测试：

请用三句话介绍 LobeChat 的用途。

如果能正常返回内容，说明 API 已经接通。

建议再测试一次稍微复杂的任务，例如：

请帮我写一个 Python requests 调用 OpenAI-compatible API 的示例。

如果第二次也能正常返回，基本可以确认模型名、Base URL、API Key 都没有问题。

五、常见问题排查

1. 报错 401 Unauthorized

通常是 API Key 填错、Key 失效，或者复制时多了空格。

解决方法：

• 检查 Key 是否以 sk- 开头
• 删除前后空格后重新粘贴
• 回到 Encore 后台重新生成 Key
• 确认 LobeChat 使用的是正确 Provider

2. 报错余额不足 / insufficient quota

这类错误通常表示账户余额不够，或者当前模型需要更高余额才能调用。

解决方法：

• 登录 https://stillhappy.cn 查看余额
• 更换一个更便宜的模型测试
• 先用短文本测试，避免一次请求消耗过高

3. 模型名错误 / model not found

如果模型名拼错，LobeChat 会返回模型不存在或请求失败。

常见错误包括：

claude-sonnet-4.6
claude-4-sonnet
gemini-pro-2.5

建议直接复制后台模型列表里的名称，例如：

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

在 LobeChat 里只需要填到 /v1，不要把完整接口路径填进去。

5. 国内访问慢或超时

如果你用的是海外中转或官方 API，国内网络可能不稳定。Encore 的优势是国内直连，通常不需要额外代理，更适合日常高频使用。

六、几家 API 服务简单对比

如果你的目标是「少折腾、快速在 LobeChat 里用上 Claude / GPT / Gemini」，我会优先推荐块乐 Encore。注册、拿 Key、填 Base URL，基本几分钟可以跑通。

七、总结

LobeChat 本身是一个很好用的 AI 客户端，而中转 API 解决的是模型接入、网络连通和支付便利性问题。新手配置时只要记住三项：Base URL、API Key、模型名，基本就能顺利接入。

如果你想快速体验，可以直接去块乐 Encore 主站注册并获取 API Key：

https://stillhappy.cn

常见问题

Q: LobeChat 怎么配置中转 API？
A: 在 LobeChat 设置里选择 OpenAI Compatible，填写 https://api-ic.stillhappy.cn/v1、sk-xxx 和模型名即可。块乐 Encore 支持 Claude、GPT、Gemini，多模型可以用同一个 Key 调用。

Q: LobeChat 国内能直接用 Claude 吗？需要 VPN 吗？
A: 使用块乐 Encore 的中转 API 可以国内直连，一般不需要 VPN。配置好 Base URL 和 API Key 后，就能在 LobeChat 里选择 claude-sonnet-4-6 使用。

Q: LobeChat 报 401 是什么原因？
A: 401 通常是 API Key 错误、Key 失效或复制时带了空格。建议到 stillhappy.cn 后台重新生成 Key，再粘贴到 LobeChat。

Q: LobeChat 模型名应该填什么？
A: 可以填 claude-sonnet-4-6、gpt-5、gemini-2.5-pro 等。建议直接复制块乐 Encore 后台的模型名称，避免拼写错误导致 model not found。

Q: OpenRouter 和块乐 Encore 哪个更适合国内用户？
A: OpenRouter 模型多，但更依赖海外网络和支付环境；块乐 Encore 国内直连，支持支付宝和 Claude/GPT/Gemini 全家桶，对国内 LobeChat 用户更省事。

Meta Title: LobeChat 配置中转 API 教程 2026：接入块乐 Encore 使用 Claude/GPT/Gemini
Meta Description: 本文详细介绍 LobeChat 如何配置中转 API，包括 Base URL、API Key、模型名填写方法，并解决 401、余额不足、模型名错误等常见问题。
Meta Keywords: LobeChat 配置中转 API,LobeChat API 教程,块乐 Encore,LobeChat Claude,LobeChat GPT,LobeChat Gemini