主题
LobeChat 接入
LobeChat 是开源（Apache 2.0）的现代化 AI 聊天应用，插件生态强，适合自部署给团队用。本页覆盖网页版和自部署两种接入方式。
一分钟版本
设置 → 语言模型 → OpenAI → 代理地址 https://shuro.vip/v1 → 填 Key → 自定义模型列表加 Shuro 的模型 ID。
前置条件
一个 Shuro API Key — 没有？看 获取 API Key。
场景一：网页版（lobechat.com）
打开 lobechat.com，无需部署直接用。
- 头像 → 「设置」
- 「语言模型」 → 「OpenAI」
- 填：
| 字段 | 值 |
|---|---|
| API Key | <您的 API Key> |
| API 代理地址 | https://shuro.vip/v1 |
- 「模型列表」中删掉用不到的默认模型，自定义添加 Shuro 的模型 ID（见下文）
- 部分版本提供「连通性检查」按钮，点一下验证
代理地址要带 /v1
LobeChat 走 OpenAI 协议，代理地址必须带 /v1（和 GUI 聊天客户端 通用规则一致）。
场景二：自部署（Docker）
bash
docker run -d -p 3210:3210 \
-e OPENAI_API_KEY="<您的 API Key>" \
-e OPENAI_PROXY_URL="https://shuro.vip/v1" \
-e CUSTOM_MODELS="+claude-opus-4-7,+claude-sonnet-4-6,+gpt-5.5" \
lobehub/lobe-chat打开 http://localhost:3210 即可用。
变量说明：
| 变量 | 作用 |
|---|---|
OPENAI_PROXY_URL | OpenAI 协议 Base URL，指向 https://shuro.vip/v1 |
OPENAI_API_KEY | 您的 Shuro API Key |
CUSTOM_MODELS | 模型列表：+id 添加、-id 隐藏、-all 清空默认再逐个 + |
想要干净的模型列表可以这样写：
bash
-e CUSTOM_MODELS="-all,+claude-opus-4-7,+claude-sonnet-4-6,+claude-haiku-4-5-20251001,+gpt-5.5,+gpt-5.4"团队部署
自部署 + 一把 Shuro Key，团队成员打开网页就能用，不用人手一个账号。给不同项目分 Key 便于对账，见 Key 分组管理。
模型 ID
手动添加时照抄以下 ID（别用 claude-3.5-sonnet 这类官方旧写法）：
claude-opus-4-7
claude-sonnet-4-6
claude-haiku-4-5-20251001
gpt-5.5
gpt-5.4全部 9 款模型的倍率与上下文长度见 支持的模型。
验证
任选一个刚添加的模型，发一句「回复 pong」。收到回复即链路打通。
常见问题
401 / Invalid token
Key 写错或没生效；代理地址漏了 /v1 也会连不上。排查步骤见 401 排查。
模型未找到
模型 ID 拼错，或 CUSTOM_MODELS 忘了 + 前缀。对照 支持的模型。
请求超时 / 转圈
改了环境变量不生效
Docker 环境变量在容器启动时读取，改完要 docker rm 后重新 docker run（或 docker compose up -d --force-recreate）。
相关页面
- GUI 聊天客户端总览 — ChatBox / NextChat / Cherry Studio 一页配齐
- Cherry Studio 接入
- 计费与倍率