LobeChat einrichten

QCode.cc in LobeChat verbinden: API-Key und Proxy URL bei den Anbietern Anthropic und OpenAI, dazu die Umgebungsvariablen beim Self-Hosting.

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

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

Auf einen Blick¶

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¶

🔴 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.

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):

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):

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. 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:

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:

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:

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.

Fehlerbehebung und bekannte Grenzen¶

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 — Protokoll je Modellfamilie
• Kompatibilität der Werkzeuge — was welches Tool spricht
• Cherry Studio — dieselben Endpunkte, Felder der Desktop-App
• Claude Desktop mit Fremd-API
• Chinesische Modelle
• Modellauswahl
• Fehlerbehebung

Enterprise →