# LobeChat — настройка

> **Последняя проверка**: 2026-10-13 · 📄 По официальной документации (LobeHub v2.2.19)

## Кратко

| Параметр | Подробности |
|---|---|
| Доступные модели | Claude ✅ (провайдер Anthropic + Proxy URL) · GPT ✅ · китайские модели ✅ (провайдер OpenAI + Proxy URL) · Gemini ❌ (QCode не предоставляет семейство Gemini — используйте Claude, GPT или китайскую модель) |
| Протокол и Proxy URL | Anthropic Messages: `https://api.qcode.cc/api` · OpenAI-совместимый: `https://api.qcode.cc/openai/v1` |
| Где настраивать | App Settings → AI Providers; у выбранного провайдера — API key, **Proxy URL** и **Check** |
| Свой сервер | переменные окружения `ANTHROPIC_PROXY_URL` и `OPENAI_PROXY_URL` вместо полей интерфейса |
| Официальная документация | [AI Model Providers](https://lobehub.com/docs/usage/providers) |

Приложение сегодня выпускается под именем **LobeHub**: обзорная страница сама указывает, что мульти-модельная идея "began with LobeChat's multi-model support". Под этим брендом живут документация, desktop-сборки, образ `lobehub/lobehub` и open-source Community Edition, так что по запросу LobeChat вы попадёте на LobeHub.

## Какой протокол

| Какие модели нужны | Какой провайдер включить | Proxy URL |
|---|---|---|
| Claude (`claude-sonnet-5`, `claude-opus-5`, `claude-haiku-5-5`) | **Anthropic** | `https://api.qcode.cc/api` |
| GPT (`gpt-6-sol`, `gpt-5.6-terra`) | **OpenAI** | `https://api.qcode.cc/openai/v1` |
| Китайские модели (`deepseek-v4.1-flash`, `glm-5.3`, `qwen3.8-max`, `kimi-k3`) | **OpenAI** | `https://api.qcode.cc/openai/v1` |

🔴 **Никогда не вызывайте Claude через провайдер OpenAI.** QCode отдаёт Claude только на Anthropic-эндпоинте; идентификатор `claude-*` на OpenAI-совместимом эндпоинте отвергается, а `gpt-*` не работает на Anthropic-эндпоинте. Один ключ QCode (`cr_…`) подходит для обоих полей.

Вводите Proxy URL ровно как в таблице: **без слэша на конце** и не вставляйте в это поле полный путь запроса вроде `/v1/chat/completions` — LobeHub определяет его как "the provider API base URL or a compatible endpoint". Нужен ли для Anthropic дополнительный сегмент пути, документация не поясняет, поэтому вводите адрес так, как его выдаёт QCode. См. [Эндпоинты и пути API](/docs/getting-started/endpoints-and-api-paths).

## Установка

Сначала выберите форму запуска — от неё зависит, где лежит ключ.

- **Desktop или веб** — официальная формулировка: "Download the macOS, Windows, or Linux app from the official download page"; desktop собран на Electron, а в браузере достаточно "Open LobeHub in a modern browser". Ключ и Proxy URL вводятся в интерфейсе, см. ниже.
- **Свой сервер, один Docker-образ** (официальная команда; переменные вынесены в env-файл):

```bash
docker run -it -d -p 3210:3210 --network pg --env-file lobehub.env --name lobehub lobehub/lobehub
```

- **Свой сервер, Docker Compose** (официальный скрипт, затем compose):

```bash
mkdir lobehub && cd lobehub
bash <(curl -fsSL https://lobe.li/setup.sh) -l en
docker compose up -d
```

Если desktop-приложение должно работать с вашим собственным экземпляром, документация по desktop требует, чтобы "your self-hosted instance version is 1.83.6 or higher to support desktop" подключение: нажмите значок Wi-Fi в правом верхнем углу, введите адрес экземпляра, затем Connect. В том же документе требуется, чтобы экземпляр перед подключением был "correctly configured with the OIDC-related environment variables". Серверный релиз, по которому проверена эта страница, — v2.2.19 (опубликован 2026-10-07); 1.83.6 — это номер из документа про desktop, тот же ли он, страница не утверждает.

Значит, на этой странице два пути: **облако и desktop используют поля интерфейса**, **свой сервер — переменные окружения**.

## Настройка

LobeHub прямо пишет, что набор полей зависит от провайдера: "Open App Settings → AI Providers, then select the provider you want to configure. The available fields depend on the provider". Документированная последовательность: "Select a provider from the list and turn on its switch", затем "Enter the credentials shown on the page. Most cloud providers use an API key", затем "If Proxy URL is available, enter the provider API base URL or a compatible endpoint", затем "Select Check to test the connection", затем "Enable a model in the model list. You can also fetch or add models when those actions are available." И добавлено: "Your changes are saved automatically. You can then select the provider and model in the Agent settings."

Две оговорки. Во-первых, формулировка условная — *If Proxy URL is available* — поэтому страница не утверждает, что такое поле есть у каждого провайдера; матрицы «облако против desktop» по доступности полей LobeHub тоже не публикует. Если в вашей сборке у Anthropic или OpenAI нет поля Proxy URL, этот гайд не поможет перенаправить адрес. Во-вторых, облако и desktop не противоположности: "The desktop app can use Cloud services and cloud models."

### Claude: провайдер Anthropic

Шаги официальной страницы Anthropic, в её порядке:

1. "Open App Settings → AI Providers, select Anthropic, and enable the provider"
2. "Enter the API key. If you use a proxy, enter its proxy URL" — ваш ключ QCode (`cr_…`), Proxy URL `https://api.qcode.cc/api`
3. "Select Check to test the connection"
4. "Enable the Claude models you need, then select one in the Agent settings"

Идентификаторы берите из списка QCode: `claude-sonnet-5` на каждый день, `claude-sonnet-5-5`, для сложных задач `claude-opus-5` или `claude-opus-5-5`, для лёгких `claude-haiku-5-5`; также доступны `claude-sonnet-4-6`, `claude-haiku-4-5-20251001`, `claude-fable-5`, `claude-fable-5-1`. Страница покрывает только встроенные провайдеры Anthropic и OpenAI; у LobeHub есть гайды и по другим производителям, и здесь они не проверялись.

### GPT и китайские модели: провайдер OpenAI

Та же схема, по шагам официальной страницы OpenAI:

1. "Open App Settings → AI Providers, select OpenAI, and enable the provider"
2. "Enter the API key. If you use a proxy or compatible endpoint, enter its proxy URL" — тот же ключ `cr_…`, Proxy URL `https://api.qcode.cc/openai/v1`
3. "Select Check to test the connection"
4. "Enable the OpenAI models you need, then select one in the Agent settings"

Китайские идентификаторы идут через этого же провайдера и с этим же Proxy URL: `deepseek-v4.1-flash`, `deepseek-v4-pro`, `glm-5.3`, `qwen3.8-max`, `kimi-k3` — см. [Китайские модели](/docs/usage/cn-models). Отдельные гайды DeepSeek, Qwen или Moonshot для этого не нужны: один OpenAI-совместимый эндпоинт закрывает весь список. Если нужного идентификатора нет во встроенном списке, добавьте его там, где документация разрешает получение или добавление моделей.

### Переменные окружения на своём сервере

При развёртывании через Docker или Compose те же два адреса задаются по провайдерам в env-файле. Справочник описывает `ANTHROPIC_PROXY_URL` как параметр, чтобы "override the default Anthropic API request base URL", а `OPENAI_PROXY_URL` — чтобы "override the default OpenAI API request base URL", то есть это серверные двойники поля Proxy URL из интерфейса:

| Переменная | Значение по умолчанию | Чем заменить |
|---|---|---|
| `ANTHROPIC_API_KEY` | – | ваш ключ QCode `cr_…` |
| `ANTHROPIC_PROXY_URL` | `https://api.anthropic.com` | `https://api.qcode.cc/api` |
| `OPENAI_API_KEY` | – | тот же ключ |
| `OPENAI_PROXY_URL` | `https://api.openai.com/v1` | `https://api.qcode.cc/openai/v1` |
| `OPENAI_MODEL_LIST` | – | см. ниже |
| `ANTHROPIC_CLIENT_TIMEOUT` | `295000` | не трогать, если длинные ответы не обрываются |

Про `OPENAI_MODEL_LIST` справочник говорит "Used to control the model list": `+` добавляет модель, `-` скрывает, а `-all` сначала прячет встроенный набор — удобно, когда эндпоинт отдаёт только то, что вы перечислили:

```bash
ANTHROPIC_API_KEY=cr_your_qcode_key
ANTHROPIC_PROXY_URL=https://api.qcode.cc/api
OPENAI_API_KEY=cr_your_qcode_key
OPENAI_PROXY_URL=https://api.qcode.cc/openai/v1
OPENAI_MODEL_LIST=-all,+gpt-6-sol,+gpt-5.6-terra,+glm-5.3,+deepseek-v4.1-flash
```

Нужен ли суффикс `/v1` в значении, зависит от эндпоинта, а не от LobeChat: документация советует "check the request suffix of your proxy service provider" и при пустом ответе предлагает добавить `/v1` и повторить. Для QCode: на стороне OpenAI оставляем `/openai/v1`, на стороне Anthropic останавливаемся на `/api`. В справочнике есть и отдельные переменные китайских сервисов (`DEEPSEEK_PROXY_URL`, `QWEN_PROXY_URL`, `MOONSHOT_PROXY_URL`); направляйте их на QCode, только если осознанно хотите использовать QCode вместо нативного сервиса этого провайдера.

## Проверка

Штатная проверка в интерфейсе: "Select Check to test the connection" на карточке провайдера. **Тестового ключа у этой страницы нет, поэтому ни один HTTP-результат выше не заявлен.** Если **Check** не проходит, сначала чините Proxy URL и ключ, а уже потом всё остальное.

Чтобы отделить проблему шлюза от проблемы приложения, обратитесь к эндпоинтам напрямую:

```bash
KEY="cr_your_qcode_key"

# Anthropic — только идентификаторы Claude
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

# OpenAI-совместимый — GPT и китайские идентификаторы, никогда claude-*
curl -X POST https://api.qcode.cc/openai/v1/chat/completions \
  -H "authorization: Bearer $KEY" -H "content-type: application/json" \
  -d '{"model":"gpt-6-sol","messages":[{"role":"user","content":"ping"}]}'
```

Если в JSON есть `content` (Anthropic) или `choices` (OpenAI) — эндпоинт отвечает, и остаток проблемы лежит в настройках приложения. Оплата по токенам; цены каждой модели перечислены на [qcode.cc/models](https://qcode.cc/models).

## Устранение ошибок и известные ограничения

| Симптом | Что говорит документация | Что делать |
|---|---|---|
| Пустой ответ после задания `OPENAI_PROXY_URL` | можно "may encounter a situation where the AI returns an empty message"; лечение — перепроверить переменную и то, добавлен ли `/v1`, "suffix is added correctly (if required)" | держите `https://api.qcode.cc/openai/v1` буквально, без слэша на конце |
| Идентификатор `claude-*` отвергнут | — | QCode не отдаёт семейство Claude на OpenAI-совместимом адресе (`model_not_available_on_endpoint`); перенесите его в провайдер Anthropic с `https://api.qcode.cc/api` |
| Длинные запросы к Anthropic обрываются | `ANTHROPIC_CLIENT_TIMEOUT`, по умолчанию `295000`, и этот тайм-аут "is also used by Anthropic-compatible providers that rely on the Anthropic SDK" | поднимайте только на своём сервере и только под длинные генерации |
| Развёртывание на Vercel | задокументирован "10-second serverless function timeout limit" | по нашей оценке: ответы длиннее этого лимита требуют Docker или другого хостинга |
| Провайдер стал недоступен | "This does not guarantee automatic failover" | настройте второй провайдер сами и переключайтесь вручную |
| Ошибка подключения, ключ признан недействительным | "Check your API key for extra spaces. Check that the key type matches the provider" | вставьте ключ `cr_…` заново, проверьте тип провайдера |
| Вашей модели нет в списке | "Your account tier can exclude a model, or the provider can retire it" | в случае QCode добавляйте идентификатор вручную: встроенный список не равен списку моделей QCode |
| Ошибки лимита частоты | "You reached the provider's request rate limit" | снизьте частоту запросов или смените провайдера |

Чего у QCode нет: **gpt-6-luna** и **gpt-5.6-luna** — возьмите другую модель GPT (`gpt-6.1-sol` / `gpt-6-sol` / `gpt-5.6-terra`); семейство **Gemini** тоже не предоставляется — используйте Claude, GPT или китайскую модель. Если основной адрес у вас недоступен, тот же ключ работает на `https://asia.qcode.cc/api` и `https://us.qcode.cc/api`. Какие сборки LobeChat показывают поле Proxy URL у конкретного провайдера, документацией не описано, и разница cloud / desktop вне рамок этой страницы.

## Похожие материалы

- [Эндпоинты и пути API](/docs/getting-started/endpoints-and-api-paths) — протокол против семейства моделей
- [Совместимость инструментов](/docs/ide/tool-compatibility) — какой инструмент что понимает
- [Cherry Studio](/docs/ide/cherry-studio) — те же эндпоинты, поля desktop-приложения
- [Claude Desktop: сторонний API](/docs/ide/claude-desktop)
- [Китайские модели](/docs/usage/cn-models)
- [Выбор модели](/docs/usage/model-selection)
- [Устранение неполадок](/docs/reference/troubleshooting)