# LobeChat einrichten

> **Zuletzt geprüft**: 2026-10-13 · 📄 Laut offizieller Dokumentation (LobeHub v2.2.19)

## Auf einen Blick

| Punkt | Details |
|---|---|
| Verwendbare Modelle | Claude ✅ (Anbieter Anthropic + Proxy URL) · GPT ✅ · chinesische Modelle ✅ (Anbieter OpenAI + Proxy URL) · Gemini ❌ (QCode bietet keine Gemini-Reihe — nutzen Sie Claude, GPT oder ein chinesisches Modell) |
| Protokoll & Proxy URL | Anthropic Messages: `https://api.qcode.cc/api` · OpenAI-kompatibel: `https://api.qcode.cc/openai/v1` |
| Wo eingestellt wird | App Settings → AI Providers; beim gewählten Anbieter die Felder API key, **Proxy URL** und **Check** |
| Eigener Server | stattdessen die Umgebungsvariablen `ANTHROPIC_PROXY_URL` und `OPENAI_PROXY_URL` |
| Offizielle Dokumentation | [AI Model Providers](https://lobehub.com/docs/usage/providers) |

Die App erscheint heute unter dem Namen **LobeHub**; die Übersichtsseite nennt für den Mehrmodell-Ansatz nach wie vor den Ursprung "began with LobeChat's multi-model support". Unter dieser Marke liegen Doku, Desktop-Pakete, das Image `lobehub/lobehub` und die quelloffene Community Edition — wer LobeChat sucht, landet bei LobeHub.

## Welches Protokoll

| Gewünschte Modelle | Zu aktivierender Anbieter | 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` |
| Chinesische Modelle (`deepseek-v4.1-flash`, `glm-5.3`, `qwen3.8-max`, `kimi-k3`) | **OpenAI** | `https://api.qcode.cc/openai/v1` |

🔴 **Rufen Sie Claude niemals über den OpenAI-Anbieter auf.** QCode liefert Claude ausschließlich über den Anthropic-Endpunkt; eine `claude-*`-Kennung am OpenAI-Endpunkt wird abgelehnt, und `gpt-*`-Kennungen laufen nicht am Anthropic-Endpunkt. Ein QCode-Schlüssel (`cr_…`) deckt beide Eingaben ab.

Tragen Sie die Proxy URL genau wie in der Tabelle ein: **kein Slash am Ende**, und schreiben Sie in dieses Feld auch keinen vollständigen Anfrageweg wie `/v1/chat/completions` — LobeHub definiert das Feld als "the provider API base URL or a compatible endpoint". Ob auf der Anthropic-Seite ein zusätzliches Pfadsegment erwartet wird, ist nicht dokumentiert; übernehmen Sie die Adresse, die QCode Ihnen nennt, unverändert. Siehe [Endpunkte und API-Pfade](/docs/getting-started/endpoints-and-api-paths).

## Installation

Entscheiden Sie zuerst, wie Sie die App betreiben — daraus folgt, wo der Schlüssel steht.

- **Desktop oder Web** — wörtlich aus der Doku: "Download the macOS, Windows, or Linux app from the official download page"; der Desktop-Bau nutzt Electron, im Browser genügt "Open LobeHub in a modern browser". Schlüssel und Proxy URL tragen Sie in der Oberfläche ein (siehe unten).
- **Eigener Server, ein Docker-Image** (offizieller Befehl; die Variablen stehen in einer env-Datei):

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

- **Eigener Server, Docker Compose** (offizielles Skript, danach compose):

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

Soll der Desktop-Client eine selbst betriebene Instanz nutzen, verlangt die Desktop-Doku für die Verbindungsfunktionen eine selbst betriebene Instanz, die "1.83.6 or higher to support desktop" ist: oben rechts auf das Wi-Fi-Symbol klicken, die Instanzadresse eintragen, dann verbinden. Dieselbe Doku verlangt außerdem, dass die Instanz vor dem Verbinden "correctly configured with the OIDC-related environment variables" ist. Der Server-Release, gegen den diese Seite geprüft wurde, ist v2.2.19 (veröffentlicht am 2026-10-07); 1.83.6 ist die von der Desktop-Doku genannte Zahl, nicht dieselbe Versionsnummer.

Es gibt auf dieser Seite also zwei Wege: **Cloud und Desktop benutzen die Felder der Oberfläche**, **Self-Hosting benutzt Umgebungsvariablen**.

## Konfiguration

LobeHub hält ausdrücklich fest, dass die Felder vom Anbieter abhängen: "Open App Settings → AI Providers, then select the provider you want to configure. The available fields depend on the provider". Die dokumentierte Reihenfolge ist: "Select a provider from the list and turn on its switch", dann "Enter the credentials shown on the page. Most cloud providers use an API key", dann "If Proxy URL is available, enter the provider API base URL or a compatible endpoint", dann "Select Check to test the connection", dann "Enable a model in the model list. You can also fetch or add models when those actions are available." Ergänzt wird das durch "Your changes are saved automatically. You can then select the provider and model in the Agent settings."

Zwei Einschränkungen vorweg. Erstens ist die Formulierung bedingt — *If Proxy URL is available* — diese Seite behauptet also nicht, dass jedes Anbieterfeld existiert; eine Matrix zur Feldverfügbarkeit in Cloud und Desktop publiziert LobeHub ebenfalls nicht. Wenn Ihre Version bei Anthropic oder OpenAI kein Proxy-URL-Feld zeigt, kann diese Anleitung den Zielort nicht umleiten. Zweitens sind Cloud und Desktop kein Gegensatz: "The desktop app can use Cloud services and cloud models."

### Claude einrichten (Anbieter Anthropic)

Die Schritte der offiziellen Anthropic-Seite, in ihrer Reihenfolge:

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" — Ihren QCode-Schlüssel (`cr_…`) und als 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"

Die Kennungen wählen Sie aus der QCode-Liste: `claude-sonnet-5` für den Alltag, `claude-sonnet-5-5`, für schwere Aufgaben `claude-opus-5` oder `claude-opus-5-5`, für leichte `claude-haiku-5-5`; außerdem sind `claude-sonnet-4-6`, `claude-haiku-4-5-20251001`, `claude-fable-5` und `claude-fable-5-1` verfügbar. Diese Seite behandelt nur die eingebauten Anbieter Anthropic und OpenAI; LobeHub listet Anleitungen zu vielen weiteren Herstellern, und nichts davon wurde hier nachgeprüft.

### GPT und chinesische Modelle einrichten (Anbieter OpenAI)

Gleicher Ablauf, nach den Schritten der offiziellen OpenAI-Seite:

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" — derselbe `cr_…`-Schlüssel, 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"

Chinesische Kennungen laufen über denselben Anbieter und dieselbe Proxy URL: `deepseek-v4.1-flash`, `deepseek-v4-pro`, `glm-5.3`, `qwen3.8-max`, `kimi-k3` — siehe [Chinesische Modelle](/docs/usage/cn-models). Die eigenen Anleitungen für DeepSeek, Qwen oder Moonshot brauchen Sie dafür nicht: ein OpenAI-kompatibler Eintrag deckt die ganze Liste ab. Fehlt Ihre Kennung in der eingebauten Auswahl, ergänzen Sie sie dort, wo die Doku das Abrufen oder Hinzufügen von Modellen erlaubt.

### Umgebungsvariablen beim Self-Hosting

Bei einem Docker- oder Compose-Betrieb werden dieselben zwei Adressen anbietergetrennt in der env-Datei gesetzt. Die Referenz beschreibt `ANTHROPIC_PROXY_URL` als Eintrag, um "override the default Anthropic API request base URL" zu ersetzen, und `OPENAI_PROXY_URL` als Eintrag, um "override the default OpenAI API request base URL" zu ersetzen — das Gegenstück zum Proxy-URL-Feld der Oberfläche:

| Variable | Dokumentierter Standardwert | Ihr Wert |
|---|---|---|
| `ANTHROPIC_API_KEY` | – | Ihr QCode-Schlüssel `cr_…` |
| `ANTHROPIC_PROXY_URL` | `https://api.anthropic.com` | `https://api.qcode.cc/api` |
| `OPENAI_API_KEY` | – | derselbe Schlüssel |
| `OPENAI_PROXY_URL` | `https://api.openai.com/v1` | `https://api.qcode.cc/openai/v1` |
| `OPENAI_MODEL_LIST` | – | siehe unten |
| `ANTHROPIC_CLIENT_TIMEOUT` | `295000` | nur anfassen, wenn lange Antworten abbrechen |

Zu `OPENAI_MODEL_LIST` sagt die Referenz "Used to control the model list": `+` fügt ein Modell hinzu, `-` blendet eines aus, und `-all` verbirgt zuerst den eingebauten Bestand — die passende Form, wenn der Endpunkt nur liefert, was Sie selbst benennen:

```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
```

Ob das Suffix `/v1` in den Wert gehört, entscheidet der Endpunkt und nicht LobeChat — die Doku sagt, Sie sollen "check the request suffix of your proxy service provider", und bei einer leeren Antwort empfiehlt sie, `/v1` anzuhängen und es erneut zu versuchen. Für QCode gilt: Der OpenAI-Wert behält `/openai/v1`, der Anthropic-Wert endet bei `/api`. Die Referenz führt auch eigene Variablen für die chinesischen Dienste (`DEEPSEEK_PROXY_URL`, `QWEN_PROXY_URL`, `MOONSHOT_PROXY_URL`); richten Sie eine davon nur dann auf QCode, wenn Sie QCode bewusst hinter den Eintrag dieses Anbieters setzen wollen.

## Test

Der dokumentierte Nachweis sitzt in der App: "Select Check to test the connection" auf der Anbieterkarte. **Diese Seite hat keinen Test-Schlüssel, deshalb wird für keine der Einstellungen oben ein HTTP-Ergebnis behauptet.** Schlägt **Check** fehl, korrigieren Sie zuerst Proxy URL und Schlüssel, bevor Sie andere Punkte prüfen.

Um ein Gateway-Problem von einem App-Problem zu trennen, fragen Sie die Endpunkte direkt an:

```bash
KEY="cr_your_qcode_key"

# Anthropic-Endpunkt — nur Claude-Kennungen
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-kompatibler Endpunkt — GPT und chinesische Kennungen, niemals 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"}]}'
```

Enthält die JSON-Antwort `content` (Anthropic) oder `choices` (OpenAI), hat der Endpunkt geantwortet, und das verbleibende Problem liegt in den Einstellungen der App. Abgerechnet wird pro Token; die Preise je Modell stehen auf [qcode.cc/models](https://qcode.cc/models).

## Fehlerbehebung und bekannte Grenzen

| Symptom | Was die Doku sagt | Was zu tun ist |
|---|---|---|
| Leere Antwort nach dem Setzen von `OPENAI_PROXY_URL` | die Doku warnt, dass Sie eine leere Antwort erhalten können ("the AI returns an empty message"); als Abhilfe prüfen Sie die Variable und ob das `/v1`-Suffix korrekt gesetzt ist ("suffix is added correctly (if required)") | `https://api.qcode.cc/openai/v1` exakt übernehmen, ohne Slash am Ende |
| Eine `claude-*`-Kennung wird abgelehnt | — | QCode liefert die Claude-Familie nicht über die OpenAI-kompatible Adresse (`model_not_available_on_endpoint`); wechseln Sie zu Anthropic mit `https://api.qcode.cc/api` |
| Lange Anthropic-Anfragen brechen ab | `ANTHROPIC_CLIENT_TIMEOUT`, Standard `295000`; diese Zeitgrenze "is also used by Anthropic-compatible providers that rely on the Anthropic SDK" | erhöhen Sie sie nur auf dem eigenen Server und nur für lange Generierungen |
| Betrieb auf Vercel | dort gilt ein "10-second serverless function timeout limit" | unsere Lesart: Antworten über dieser Grenze brauchen Docker oder einen anderen Host |
| Ein Anbieter fällt aus | "This does not guarantee automatic failover" | zweiten Anbieter selbst einrichten und manuell umschalten |
| Verbindungsfehler, Schlüssel ungültig | "Check your API key for extra spaces. Check that the key type matches the provider" | `cr_…`-Schlüssel neu einfügen, Anbietertyp prüfen |
| Ihr Modell fehlt in der Liste | "Your account tier can exclude a model, or the provider can retire it" | bei QCode die Kennung selbst ergänzen — die eingebaute Auswahl ist nicht das QCode-Sortiment |
| Fehler zur Request-Grenze | "You reached the provider's request rate limit" | Abfragetakt reduzieren oder Anbieter wechseln |

Was es bei QCode nicht gibt: **gpt-6-luna** und **gpt-5.6-luna** — bitte ein anderes GPT-Modell (`gpt-6.1-sol` / `gpt-6-sol` / `gpt-5.6-terra`); und die **Gemini-Reihe** — nutzen Sie stattdessen Claude, GPT oder ein chinesisches Modell. Ist die Hauptadresse für Sie nicht erreichbar, funktioniert derselbe Schlüssel auch auf `https://asia.qcode.cc/api` und `https://us.qcode.cc/api`. Welche LobeChat-Version bei welchem Anbieter ein Proxy-URL-Feld anzeigt, ist nicht dokumentiert und bleibt außerhalb dieser Seite.

## Weiteres

- [Endpunkte und API-Pfade](/docs/getting-started/endpoints-and-api-paths) — Protokoll je Modellfamilie
- [Kompatibilität der Werkzeuge](/docs/ide/tool-compatibility) — was welches Tool spricht
- [Cherry Studio](/docs/ide/cherry-studio) — dieselben Endpunkte, Felder der Desktop-App
- [Claude Desktop mit Fremd-API](/docs/ide/claude-desktop)
- [Chinesische Modelle](/docs/usage/cn-models)
- [Modellauswahl](/docs/usage/model-selection)
- [Fehlerbehebung](/docs/reference/troubleshooting)