# LobsterAI mit QCode einrichten

> **Zuletzt überprüft**: 2026-11-10 · 📄 Laut offizieller Dokumentation (LobsterAI 2026.11.6, veröffentlicht am 2026-11-06: README, Benutzerhandbuch, Quellcode des Repositorys)

Kann LobsterAI Ihren eigenen API-Schlüssel verwenden? Ja. Stand 2026-11-10 laut offiziellem README, Quellcode des Repositorys und der Antwort eines Maintainers: Öffnen Sie **Settings → Custom Model**, klicken Sie unten in der Anbieterliste auf **+ Add Custom**, wählen Sie unter **API Format** **Anthropic Compatible (Messages)** oder **OpenAI Compatible (Chat Completions)**, tragen Sie die Base URL von QCode und Ihren `cr_`-Schlüssel ein, fügen Sie eine Modell-ID hinzu und klicken Sie auf **Test Connection**.

## Auf einen Blick

| Punkt | Details |
|---|---|
| Nutzbare Modelle | Claude ✅ (Anthropic Compatible) · GPT ✅ (OpenAI Compatible) · GLM / Kimi / DeepSeek / Qwen ✅ (beide Formate) · Gemini ❌ (QCode bietet es derzeit nicht an) |
| Base URL | Anthropic Compatible (Messages): `https://api.qcode.cc/api` · OpenAI Compatible (Chat Completions): `https://api.qcode.cc/openai/v1` |
| Wo konfigurieren | In der App: **Settings → Custom Model → + Add Custom** |
| Offizielle Dokumentation | [Model configuration guide](https://lobsterai.youdao.com/en/docs/lobsterai_model_config_guide) · [User manual](https://lobsterai.youdao.com/en/docs/lobsterai_user_manual) · [GitHub-Repository](https://github.com/netease-youdao/LobsterAI) |

Die offizielle FAQ beschreibt LobsterAI (chinesischer Name: Youdao Lobster) als quelloffenen Desktop-KI-Agenten von NetEase Youdao, gedacht als Büroassistent für alle Arbeitsbereiche. Er baut auf dem quelloffenen Agenten-Framework OpenClaw auf, läuft unter macOS (Apple Silicon und Intel) und Windows und steht unter der MIT-Lizenz auf GitHub (netease-youdao/LobsterAI). Er ist ein anderes Produkt als [OpenClaw](/docs/ide/openclaw): OpenClaw ist das Laufzeit-Framework, LobsterAI ein Desktop-Client mit eigener Oberfläche.

Version: Stand 2026-11-10 ist das auf GitHub als **Latest** markierte Release `LobsterAI 2026.11.6` (veröffentlicht am 2026-11-06); die Startseite der offiziellen Website zeigt am selben Tag 2026.10.30. Die Oberflächenbezeichnungen unten sind mit dem Quellcode von 2026.11.6 abgeglichen.

## Welches Protokoll Sie verwenden

Ein benutzerdefinierter Anbieter bietet mehrere API-Formate; für den Alltag mit QCode reichen zwei:

- **Anthropic Compatible (Messages)** + `https://api.qcode.cc/api`: Claude-Modelle sowie GLM / Kimi / DeepSeek / Qwen.
- **OpenAI Compatible (Chat Completions)** + `https://api.qcode.cc/openai/v1`: GPT-Modelle sowie GLM / Kimi / DeepSeek / Qwen.

Ein `cr_`-Schlüssel gilt für beide. Claude-Modelle gibt es nur am Anthropic-Endpunkt, GPT-Modelle nur an den OpenAI-Endpunkten; die vollständige Matrix steht unter [Endpunkte & API-Pfade](/docs/getting-started/endpoints-and-api-paths). Das Format **OpenAI Compatible (Responses)** behandelt ein optionaler Abschnitt weiter unten.

## Installation

Das offizielle README verweist auf die [Downloadseite](https://lobsterai.youdao.com/#/download-list) (macOS Apple Silicon, macOS Intel, Windows x64) oder auf die neuesten Installer unter GitHub Releases. Ein Konto bei einem Modellanbieter brauchen Sie nicht: Erstellen Sie im [Dashboard](https://qcode.cc/dashboard) einen `cr_`-Schlüssel und halten Sie ihn bereit.

## Konfiguration

Die offiziellen Quellen beschreiben den Menüpfad mit leicht unterschiedlichen Worten:

- README: den eigenen API-Schlüssel unter **Settings → Custom Model** hinzufügen.
- Antwort eines Repository-Maintainers in Issue #362 (2026-10-06): „add a custom provider under Settings → Custom Models … choose OpenAI-compatible with base URL … and the … key, add a model ID … and run Test Connection“. Laut derselben Antwort wird der Anbieter nach erfolgreichem Test automatisch aktiviert und lässt sich in der Modellauswahl des Eingabefelds wählen; die andere Wahl ist das Anthropic-kompatible Format.
- Benutzerhandbuch und Leitfaden zur Modellkonfiguration nutzen **Settings → Models** für die integrierten Anbieter (DeepSeek, Moonshot, Zhipu, MiniMax, Qwen und weitere). QCode gehört unter **Custom Model**.

### Schritt 1: benutzerdefinierten Anbieter hinzufügen

1. Öffnen Sie Settings und gehen Sie zu **Custom Model**.
2. Klicken Sie unten in der Anbieterliste auf **+ Add Custom**.
3. Füllen Sie die Felder aus (Bezeichnungen wie in den englischen UI-Texten im Quellcode von 2026.11.6).

| Feld | Claude und chinesische Modelle | GPT und chinesische Modelle |
|---|---|---|
| Display Name | `QCode` (frei wählbar) | `QCode OpenAI` (frei wählbar) |
| API Format | `Anthropic Compatible (Messages)` | `OpenAI Compatible (Chat Completions)` |
| API Base URL | `https://api.qcode.cc/api` | `https://api.qcode.cc/openai/v1` |
| API Key | `cr_xxx` | `cr_xxx` |

Für beide Formate legen Sie zwei benutzerdefinierte Anbieter an. Laut offiziellem Changelog lassen sich mehrere benutzerdefinierte Anbieter gleichzeitig anbinden, höchstens 30.

### Schritt 2: Braucht die Base URL ein `/v1`?

Drei offizielle Quellen beantworten das:

1. Der Hinweis unter **API Format**: „Must match the protocol behind your Base URL; OpenAI-compatible URLs usually end with /v1“.
2. Die Beispiele unter dem Feld Base URL („Examples (SiliconFlow, click to fill)“) ordnen **OpenAI Compatible** `https://api.siliconflow.cn/v1` zu und **Anthropic Compatible** `https://api.siliconflow.cn` ohne `/v1` (Quellcode des Repositorys).
3. **Test Connection** setzt den Anfragepfad selbst zusammen (Quellcode des Repositorys, 2026.11.6). Das Anthropic-Format sendet an Base URL + `/v1/messages`, endet die Base URL bereits auf `/v1`, nur an `/messages`. Das Format OpenAI Chat Completions hängt `/chat/completions` an, wenn die Base URL auf eine Version wie `/v1` endet, und ergänzt sonst zuerst `/v1`. Das Responses-Format sendet an Base URL + `/responses` und ergänzt ebenfalls zuerst ein fehlendes `/v1`.

Tragen Sie also für Anthropic Compatible `https://api.qcode.cc/api` ein (der Test ruft dann `/api/v1/messages` auf) und für OpenAI Compatible `https://api.qcode.cc/openai/v1` (der Test ruft `/openai/v1/chat/completions` auf). Hängen Sie `/v1/messages` oder `/chat/completions` nicht selbst an. Auf einer LobsterAI-Installation haben wir diese Einrichtung nicht getestet; maßgeblich ist daher das Ergebnis von **Test Connection**. Bei instabilem Netz können Sie den Host durch `asia.qcode.cc` (Asien) oder `us.qcode.cc` (Nordamerika) ersetzen; der Pfad bleibt gleich.

### Schritt 3: Modell hinzufügen und Verbindung testen

1. Klicken Sie im neuen Anbieter auf **Add Model** und füllen Sie **Model Name** (die Bezeichnung in der Liste) und **Model ID** aus.
2. Die **Model ID** muss Zeichen für Zeichen einem Modell entsprechen, das auf [qcode.cc/models](https://qcode.cc/models) angeboten wird, zum Beispiel:

| API Format | Beispiele für Model ID |
|---|---|
| Anthropic Compatible (Messages) | `claude-sonnet-5-5`, `claude-opus-5-5`, `claude-haiku-5-5`, `glm-5.3`, `deepseek-v4.1-flash`, `kimi-k3`, `qwen3.8-max` |
| OpenAI Compatible (Chat Completions) | `gpt-6.1-sol`, `gpt-6.1-terra`, `glm-5.3`, `deepseek-v4.1-flash`, `kimi-k3`, `qwen3.8-max` |

3. Klicken Sie auf **Test Connection**. Laut der Antwort des Maintainers in Issue #362 wird der Anbieter nach Erfolg automatisch aktiviert, und Sie können ihn in der Modellauswahl des Eingabefelds wählen. Die Preise je Modell stehen unter https://qcode.cc/models.

### Optional: OpenAI Compatible (Responses)

Die offiziellen Release Notes zu 2026.10.23 sagen: „Custom providers now support OpenAI Responses and Gemini native APIs.“ Die Option heißt **OpenAI Compatible (Responses)**, mit dem Hinweis „Requires the provider to support the OpenAI Responses API. Requests go to Base URL + /responses.“ Bei QCode bedient Responses GPT-Modelle; mit der Base URL `https://api.qcode.cc/openai/v1` landet die Anfrage auf `/openai/v1/responses`, den die Endpunktseite als gleichwertig zu `/openai/responses` führt. Für den Alltag genügt **OpenAI Compatible (Chat Completions)**. Gemini-Modelle bietet QCode derzeit nicht an, die Option **Gemini (generateContent)** bleibt also ungenutzt.

## Überprüfen

1. Klicken Sie auf **Test Connection**; „Connection successful“ bedeutet, dass Pfad und Schlüssel funktionieren.
2. Wählen Sie im Eingabefeld das neue Modell in der Modellauswahl und senden Sie `ping`.
3. Wenn Sie Netzwerk und Schlüssel vorab im Terminal prüfen möchten (eine 400 bei leerem Body bedeutet, dass Pfad und Schlüssel passen):

```bash
KEY="cr_your_key"
curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://api.qcode.cc/api/v1/messages -H "x-api-key: $KEY"
curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY"
# 400 = path and key fine; 401 = bad key; 404 = wrong path prefix
```

Jede Anfrage erscheint auf [probe.qcode.cc](https://probe.qcode.cc); geben Sie Ihren Schlüssel ein, um Modell und Statuscode jedes Aufrufs zu sehen.

## Bekannte Grenzen und häufige Fehler

Auf Grundlage von offiziellem Handbuch, Changelog, Quellcode und Issues des Repositorys:

- **Responses bei benutzerdefinierten Anbietern (Issue #185)**: Issue #185 (eröffnet am 2026-02-28) wünschte das neuere OpenAI-API-Format für benutzerdefinierte Anbieter; der Maintainer riet damals, die App-Sprache auf Englisch umzustellen und den integrierten OpenAI-Anbieter zu nutzen. Heutiger Stand: Seit 2026.10.23 unterstützen benutzerdefinierte Anbieter OpenAI Responses (siehe den optionalen Abschnitt oben).
- **Die App-Sprache bestimmt die Liste der integrierten Anbieter**: In den Issues #87 und #185 erklärt der Maintainer, dass die englische Oberfläche zusätzliche integrierte Anbieter wie OpenAI und Gemini zeigt. Heutiger Stand: Im Quellcode von 2026.11.6 hängt die integrierte Liste weiterhin von der Oberflächensprache ab, benutzerdefinierte Anbieter erscheinen in beiden Sprachen – die Einrichtung von QCode ist in der chinesischen und der englischen Oberfläche also gleich.
- **Claude-ID unter einem OpenAI-Format**: QCode antwortet mit `model_not_available_on_endpoint`. Stellen Sie das **API Format** dieses Anbieters auf **Anthropic Compatible (Messages)** mit `https://api.qcode.cc/api` um; das ist ein falsches Protokoll, kein Schlüsselproblem.
- **Unbekannte Modell-ID**: In Issue #87 antwortete ein anderer Dienst mit `invalid param model:claude-haiku-4-5-20251001` (400), weil er diese ID nicht kannte. Verwenden Sie bei QCode nur IDs, die auf [qcode.cc/models](https://qcode.cc/models) angeboten werden.
- Die Fehlertabelle im offiziellen Leitfaden zur Modellkonfiguration nennt vier Meldungen: „API Key Invalid“, „Insufficient Balance“, „Network Error“ und „Service Unavailable“. Bei QCode: den `cr_`-Schlüssel vollständig neu kopieren, das QCode-Guthaben prüfen, das Netzwerk prüfen und dann den Dienststatus prüfen.
- Schlüsselspeicherung: Laut offiziellem Handbuch wird der API-Schlüssel nur auf Ihrem lokalen Gerät gespeichert und auf keinen Server hochgeladen.

## Weiterführende Dokumentation

- [Endpunkte & API-Pfade](/docs/getting-started/endpoints-and-api-paths) – Protokolle und das Ausfüllen der Base URL
- [Übersicht der Tool-Kompatibilität](/docs/ide/tool-compatibility) – Protokollunterstützung aller Tools
- [OpenClaw anbinden](/docs/ide/openclaw) – das OpenClaw-Framework, auf dem LobsterAI aufbaut
- [AutoClaw](/docs/ide/autoclaw) – die lokale OpenClaw-App von Zhipu (benutzerdefinierte Modelle sprechen das OpenAI-Protokoll)
- [Qoder](/docs/ide/qoder) – ein weiterer Desktop-Agent, dessen benutzerdefinierte Modelle Anthropic- und OpenAI-Endpunkte annehmen
- [Chinesische Modelle](/docs/usage/cn-models) – aktuelle IDs von GLM / Kimi / DeepSeek / Qwen im Angebot
- [Fehlerbehebungsleitfaden](/docs/reference/troubleshooting)