Claude Desktop mit Drittanbieter-API: 3P-Gateway einrichten, Grenzen und FAQ
Stand 2026-10-07 lässt sich Claude Desktop an eine Drittanbieter-API anbinden, allerdings nur an eine Art: ein Gateway, das die Anthropic Messages API implementiert; die offizielle Dokumentation beschreibt dafür die Nutzung von Claude-Modellen, und die Modellerkennung zeigt nur Claude-Modelle. Der Einstieg ist der Entwicklermodus: Help → Troubleshooting → Enable Developer Mode, danach Developer → Configure Third-Party Inference; dort wählen Sie Gateway als Inferenz-Provider und tragen Base URL und Schlüssel ein. Die Desktop-App liest weder ANTHROPIC_BASE_URL noch settings.json der Claude Code CLI, und GPT lässt sich nicht anbinden. Diese Seite fasst Schritte, Unterschiede zu Claude Code und häufige Fragen nach der offiziellen Anthropic-Dokumentation und der QCode-Dokumentation zusammen.
Aktualisiert 2026-10-08
Vier Punkte vorab
Der Inferenz-Provider Ihrer Wahl
Setzen Sie im Abschnitt Connection des Fensters Configure Third-Party Inference den Inference provider auf Gateway und füllen Sie Gateway base URL, Gateway API key und das Authentifizierungsschema aus. Laut offizieller Dokumentation prüft das Fenster die Werte schon bei der Eingabe und kann die Verbindung zu Ihrem Endpunkt testen.
Was das Gateway implementieren muss
Offiziell verlangt ist die Anthropic Messages API: POST /v1/messages mit Streaming und Tool-Nutzung ist Pflicht. GET /v1/models ist optional; implementiert das Gateway es, werden die Modelle automatisch erkannt, sonst tragen Sie sie in inferenceModels ein.
Welche Modelle wählbar sind
Die offizielle Gateway-Seite beschreibt die Nutzung von Claude-Modellen über ein Gateway, und die Modellerkennung zeigt nur Modelle, deren ID erkennbar zu Claude gehört. Die QCode-Dokumentation hält fest, dass GPT-Modelle den Anthropic-Endpunkt nicht nutzen können, daher funktioniert GPT in der Desktop-App nicht.
Desktop und CLI lesen jeweils ihre eigene
Die Desktop-App liest ihre Gateway-Einstellungen aus der eigenen Konfiguration für Drittanbieter-Inferenz, nicht aus ANTHROPIC_BASE_URL oder settings.json. Bei der Claude Code CLI ist es umgekehrt: Sie erreicht ein Gateway über Umgebungsvariablen oder eine Einstellungsdatei.
Was der 3P-Modus in Claude Desktop ist
Stand 2026-10-07 läuft die Anbindung von Claude Desktop an eine Drittanbieter-API über einen Bereitstellungsmodus, den Anthropic Claude Desktop on 3P nennt: Die gesamte Modell-Inferenz geht an einen Provider, den Sie konfigurieren – Agent Platform von Google Cloud, Amazon Bedrock, Microsoft Foundry, ein kompatibles Gateway, das Sie selbst betreiben, oder die Anthropic API selbst. Die offizielle Architekturtabelle nennt die Unterschiede: Das Standard-Claude-Desktop schickt die Inferenz an die Anthropic API, der 3P-Modus an Ihren konfigurierten Endpunkt; die Webanwendung ist in die App eingebaut und wird nicht von claude.ai geladen; als Benutzeridentität dient nur das lokale Gerät (außer bei Verwaltung über die Admin-Konsole von claude.ai); Unterhaltungen liegen auf der lokalen Festplatte. Laut Anthropic bleiben im 3P-Modus Chat, Cowork und Code erhalten, Inferenz und Bezahlung übernimmt der gewählte Provider (ob Cowork über QCode funktioniert, ist auf dieser Seite nicht geprüft). Gedacht ist der Modus für Organisationen, die wegen Sicherheits-, Regulierungs- oder Vertragsvorgaben keine Daten über Anthropics eigene Produkte senden dürfen; ein einzelner Rechner lässt sich aber auch direkt in der App konfigurieren – diesen Weg beschreibt die Dokumentation für Evaluierung, Pilotprojekte und Organisationen ohne MDM.
Neues in der offiziellen Dokumentation (Stand 2026-10-07)
Stand 2026-10-07 ist v2.26454.0 (2026-10-06) die neueste Version im Konfigurations-Changelog von Claude Desktop on 3P. Zwei Punkte betreffen Gateway-Nutzer direkt. Erstens: Laut offizieller Gateway-Seite nahm eine Sitzung bei Versionen vor v2.19675.0 (2026-10-01) für den Standard-Modelleintrag bei jedem Modell ein Kontextfenster von 200K Tokens an; neuere Versionen nehmen 1M für Modelle an, die sie als nativ 1M-fähig erkennen, und 200K für alle anderen Modell-IDs. Zweitens: Gateway auth scheme akzeptiert jetzt nur noch zwei Werte, bearer und x-api-key, Standard ist bearer. Außerdem sollten Gateways laut Dokumentation das Prompt-Caching erhalten: Ein Gateway, das cache_control entfernt oder Systemprompt bzw. Tool-Liste von Anfrage zu Anfrage ändert, lässt die gesamte Unterhaltung in jeder Runde zum vollen Input-Token-Preis neu verarbeiten. Die QCode-Seite zur Anbindung von Claude Desktop wurde am 2026-09-25 aktualisiert.
Zeitleiste
Claude Desktop v1.3036.0 führt die Einstellung Gateway auth scheme ein: Die Gateway-Zugangsdaten lassen sich als Header Authorization: Bearer oder als Header x-api-key senden.
Die QCode-Seite zur Anbindung von Claude Desktop wird aktualisiert; sie nennt die offizielle Dokumentation zu Gateways für Drittanbieter-Inferenz als Grundlage, und die aktuelle Fassung zieht die Aussage zurück, mit QCode lasse sich Cowork ohne Pro nutzen.
Schritte und Zitate auf dieser Seite wurden an diesem Tag mit den offiziellen Seiten abgeglichen; zu diesem Datum ist v2.26454.0 (2026-10-06) die neueste Version im offiziellen Konfigurations-Changelog.
Bestätigt vs. nicht verifiziert
Bestätigt (wörtlich in der offiziellen Dokumentation)
Folgendes lässt sich wörtlich in der offiziellen Anthropic-Dokumentation oder der QCode-Dokumentation nachprüfen: Der Einstieg ist Help → Troubleshooting → Enable Developer Mode, dann Developer → Configure Third-Party Inference; das Gateway muss die Anthropic Messages API implementieren, POST /v1/messages mit Streaming und Tool-Nutzung, GET /v1/models ist optional; die Modellerkennung zeigt nur Claude-Modelle; das Authentifizierungsschema ist standardmäßig Bearer und lässt sich auf x-api-key umstellen; die Desktop-App liest ANTHROPIC_BASE_URL und settings.json nicht; solange die Gateway-Konfiguration aktiv ist, steht Remote Control nicht zur Verfügung; im 3P-Modus gibt es keine Mobil-App, keinen Webzugang über claude.ai, keinen Sprachmodus, kein Teilen zwischen Nutzern und keine Sitzungen in Anthropics Cloud; 3P ist tokenbasierter Verbrauch ohne Lizenzen pro Arbeitsplatz; bei QCode laufen Claude-Modelle nur über den Anthropic-Endpunkt unter https://api.qcode.cc/api.
Nicht verifiziert oder widersprüchlich
Zu drei Punkten zieht diese Seite keine Schlüsse. Erstens Cowork: Laut Anthropic bleiben im 3P-Modus Chat, Cowork und Code erhalten, doch die QCode-Dokumentation hat die Aussage zurückgezogen, mit QCode lasse sich Cowork ohne Pro nutzen, und bittet darum, Cowork nicht als QCode-Anwendungsfall einzuplanen; diese Seite verspricht daher nicht, dass Cowork über QCode funktioniert. Zweitens Modelle außer Claude: Die offizielle Dokumentation sagt, dass die Modellerkennung nur Claude-Modelle zeigt, und die Gateway-Dokumentation von Claude Code hält fest, dass Anthropic die Anbindung von Claude Code an andere Modelle über kein Gateway unterstützt; eine Einrichtung anderer Modelle in der Desktop-App beschreibt diese Seite daher nicht. Drittens die Websuche, die nicht verifiziert ist: Eine Fußnote der offiziellen Funktionstabelle besagt, dass Gateways, die die Server-Tools von Anthropic nicht weiterreichen, zuerst einen Such-Provider brauchen; die QCode-Dokumentation beschreibt nicht, wie sich die Websuche in der Desktop-App verhält, und ob sie über QCode funktioniert, hat diese Seite nicht geprüft.
Unterschiede zu Claude Code Desktop und zur Claude Code CLI
vs. Claude Code Desktop
Es sind keine zwei Apps. Laut offizieller Dokumentation hat die Claude-Desktop-App drei Tabs: Chat für Unterhaltungen, Cowork für Dispatch und längere agentische Arbeit und Code für Softwareentwicklung; Claude Code Desktop ist genau dieser Code-Tab. Im 3P-Modus läuft im Code-Tab dieselbe Claude-Code-Engine wie in der eigenständigen CLI, er übernimmt die Konfiguration für Drittanbieter-Inferenz der Desktop-App automatisch und nutzt denselben Provider, denselben Endpunkt und dieselben Zugangsdaten wie Cowork-Sitzungen. Ist das Gateway in der Desktop-App eingerichtet, gilt es also auch im Code-Tab, ohne zusätzliche Konfiguration.
vs. Claude Code CLI
Die Konfiguration liegt an anderer Stelle. Die CLI erreicht ein Gateway über ANTHROPIC_BASE_URL plus eine Variable mit Zugangsdaten (die QCode-Dokumentation nutzt ANTHROPIC_AUTH_TOKEN); die Desktop-App liest beides nicht. Laut offizieller Dokumentation tragen Anfragen, solange Gateway-Zugangsdaten aktiv sind, diese anstelle des claude.ai-Abo-Logins, und die Nutzungslimits des Abos gelten für sie nicht; wer nur ANTHROPIC_BASE_URL ohne Zugangsdaten setzt, ersetzt das Abo nicht. Was wählen: Die Dokumentation empfiehlt die Desktop-App, um parallele Sitzungen in einem Fenster zu verwalten, Bereiche nebeneinander anzuordnen oder Änderungen visuell zu prüfen, und die CLI für Skripte, Automatisierung oder die Arbeit im Terminal. Die Desktop-App ist rein interaktiv, eine Ausgabe à la --print gibt es dort nicht.
In sechs Schritten ein Gateway in der Desktop-App anbinden
① Installieren Sie Claude Desktop von claude.com/download und starten Sie die App, ohne sich anzumelden und ohne ein Anthropic-Konto anzulegen. ② Wählen Sie in der macOS-Menüleiste (unter Windows im Anwendungsmenü ☰ oben links auf dem Anmeldebildschirm) Help → Troubleshooting → Enable Developer Mode; die App startet mit einem Developer-Menü neu. ③ Öffnen Sie Developer → Configure Third-Party Inference… und setzen Sie im Abschnitt Connection den Inference provider auf Gateway. ④ Tragen Sie die Gateway-Adresse als Gateway base URL und den vom Gateway ausgegebenen Schlüssel als Gateway API key ein; lassen Sie Credential kind auf dem Standard Static API key und Gateway auth scheme auf dem Standard Bearer und stellen Sie nur dann auf x-api-key um, wenn Ihr Gateway das verlangt. ⑤ Modelle: Implementiert das Gateway GET /v1/models, werden die Modelle automatisch erkannt; andernfalls tragen Sie im Bereich Models unter inferenceModels jede vollständige Modell-ID ein, die Ihr Gateway akzeptiert – der erste Eintrag wird zum Standardmodell. ⑥ Klicken Sie auf Apply Changes und danach auf Save & Restart; nach dem Neustart bietet der Anmeldebildschirm eine Option, mit dieser Konfiguration zu starten. Zurück zum Standard-Claude-Desktop gelangen Sie, indem Sie dort die Anmeldung über Anthropic wählen.
Auf QCode
Laut QCode-Dokumentation füllen Sie Schritt ④ so aus: Gateway base URL ist https://api.qcode.cc/api (ohne /v1 und ohne abschließenden Schrägstrich; für Netze in Festlandchina empfiehlt die Dokumentation https://asia.qcode.cc/api), Gateway API key ist ein in der Konsole erstellter cr_-Schlüssel, das Authentifizierungsschema bleibt auf dem Standard bearer. Bei QCode laufen Claude-Modelle nur über den Anthropic-Endpunkt, wählen Sie in der Desktop-App also Claude-Modelle wie claude-sonnet-5-5, claude-opus-5-5 oder claude-sonnet-5. GPT-Modelle können den Anthropic-Endpunkt nicht nutzen; für GPT nehmen Sie einen Client mit Unterstützung für das OpenAI-Protokoll. Derselbe Schlüssel funktioniert auch mit der Claude Code CLI: Setzen Sie ANTHROPIC_BASE_URL auf https://api.qcode.cc/api und ANTHROPIC_AUTH_TOKEN auf Ihren cr_-Schlüssel. Bezahlt wird pro Token; die Preise je Modell stehen unter /models. Jede Anfrage lässt sich auf probe.qcode.cc nach Eingabe des Schlüssels einsehen.
Häufig gestellte Fragen
Kann Claude Desktop eine Drittanbieter- oder eigene API nutzen?
Ja, aber nur über ein Gateway, das die Anthropic Messages API implementiert; die offizielle Dokumentation beschreibt dafür Claude-Modelle, und die Modellerkennung zeigt nur Claude-Modelle. Stand 2026-10-07 nennt Anthropic das Claude Desktop on 3P: Öffnen Sie im Entwicklermodus Configure Third-Party Inference, wählen Sie Gateway als Inferenz-Provider und tragen Sie Base URL und Schlüssel ein. Das Gateway muss POST /v1/messages mit Streaming und Tool-Nutzung unterstützen. Das Standard-Claude-Desktop außerhalb des 3P-Modus schickt die Inferenz an die Anthropic API.
Kann ich GPT in Claude Desktop nutzen?
Nein. Die offizielle Dokumentation verlangt, dass das Gateway die Anthropic Messages API implementiert, und die Modellerkennung zeigt nur Claude-Modelle; die QCode-Dokumentation hält fest, dass GPT-Modelle den Anthropic-Endpunkt nicht nutzen können. Für GPT auf dem Desktop rät die QCode-Dokumentation zu einem Client mit Unterstützung für das OpenAI-Protokoll.
Ich habe ANTHROPIC_BASE_URL in settings.json gesetzt. Warum nutzt die Desktop-App das nicht?
Weil die Desktop-App es nicht liest. Laut offizieller Gateway-Dokumentation von Claude Code liest die Desktop-App ihre Gateway-Einstellungen aus der eigenen Konfiguration für Drittanbieter-Inferenz, nicht aus ANTHROPIC_BASE_URL oder settings.json; beides wirkt nur auf die Claude Code CLI. Damit die Desktop-App (einschließlich ihres Code-Tabs) über ein Gateway läuft, richten Sie es unter Developer → Configure Third-Party Inference ein. Ist dieses Fenster schreibgeschützt, hat ein Administrator bereits eine Konfiguration verteilt, und diese hat Vorrang.
Brauche ich mit einem Drittanbieter-Gateway noch ein Claude-Konto oder ein Pro-Abo?
Anmelden müssen Sie sich nicht. Die offiziellen Schritte für einen einzelnen Rechner sagen ausdrücklich: nicht anmelden und kein Anthropic-Konto anlegen; nach der Konfiguration bietet der Anmeldebildschirm an, die Anthropic-Authentifizierung zu überspringen und mit Ihrer Provider-Konfiguration zu starten. Laut Dokumentation ist 3P tokenbasierter Verbrauch, bezahlt über Ihren Provider, ohne Lizenzen pro Arbeitsplatz; die Nutzung der Desktop-App selbst unterliegt weiterhin den Commercial Terms of Service von Anthropic. Der Preis dafür sind weniger Funktionen: Laut offizieller Funktionstabelle hat der 3P-Modus keine Mobil-App, keinen Webzugang über claude.ai, keinen Sprachmodus, kein Teilen zwischen Nutzern und keine Sitzungen in Anthropics Cloud. Zurück geht es über die Anmeldung über Anthropic auf dem Anmeldebildschirm.
Die Modellauswahl ist leer oder es erscheint Gateway was unreachable. Was tun?
Erst die Adresse prüfen, dann die Modellliste. Laut offizieller Dokumentation bedeutet Gateway was unreachable, dass die App beim Start die konfigurierte Base URL nicht erreichen konnte; prüfen Sie also URL und Netzwerkpfad. Bei leerer Auswahl rät die Dokumentation, die Antwort von GET /v1/models am Gateway und die Liste inferenceModels zu prüfen: Ist /v1/models nicht erreichbar oder liefert es einen Fehler, greift die Auswahl auf inferenceModels zurück, und ist auch diese Liste leer, bleibt die Auswahl leer. Die QCode-Dokumentation ergänzt: Die Base URL darf nicht mit einem Schrägstrich enden, und der Schlüssel muss mit cr_ beginnen und darf am Anfang und Ende keine Leerzeichen haben; bleibt die Auswahl trotzdem leer, tragen Sie vollständige IDs wie claude-sonnet-5-5 selbst in inferenceModels ein.
Kann ich die Desktop-App und die Claude Code CLI gleichzeitig mit einem QCode-Schlüssel nutzen?
Ja. Laut offizieller Dokumentation läuft die Desktop-App auf derselben Engine wie die CLI, und beide lassen sich gleichzeitig auf demselben Rechner, sogar im selben Projekt, betreiben. Laut QCode-Dokumentation liest jede ihre eigene Konfiguration – die Desktop-App ihre eigene, die CLI ~/.claude/settings.json –, und der gemeinsame QCode-API-Schlüssel verursacht keine Konflikte. Eine Einschränkung: Der Befehl /desktop, der eine CLI-Sitzung in die Desktop-App verschiebt, setzt eine Anmeldung mit Claude-Abo voraus und steht laut Dokumentation bei Authentifizierung per API-Schlüssel nicht zur Verfügung.
Quellen
3P-Modus und Gateway-Einrichtung: die offizielle Anthropic-Dokumentation zu Claude Desktop on 3P auf claude.com/docs (Überblick, Funktionsvergleich, Installation und Einrichtung, Konfiguration in der App, LLM-Gateway, Modelle und Effort-Stufen, Chat, Code, Recht und Compliance sowie das Konfigurations-Changelog), abgerufen am 2026-10-07. Verhältnis von Desktop-App und CLI: die offizielle Claude-Code-Dokumentation auf code.claude.com (Seite zur Desktop-Anwendung, Verbindung mit einem LLM-Gateway und weitere LLM-Gateways), am selben Tag abgerufen. Adressen, Schlüssel und Endpunktregeln von QCode: die QCode-Dokumentationsseite zur Anbindung von Claude Desktop (aktualisiert am 2026-09-25) sowie die Seiten zu Endpunkten und API-Formaten, zu Umgebungsvariablen und zu Abos und QCode-Schlüssel, am selben Tag abgerufen.
Claude Desktop mit QCode verbinden
Inferenz-Provider Gateway, Adresse https://api.qcode.cc/api, ein QCode-Schlüssel mit cr_ am Anfang und ein Claude-Modell. Bezahlt wird pro Token; die Preise je Modell stehen unter /models.
Weiterführende Lektüre
Claude Code Desktop Redesign 2026
Das Redesign vom 2026-04-14: Mission-Control-Seitenleiste, parallele Sitzungen und integriertes Terminal.
Claude Code auf einen eigenen Endpunkt ausrichten
Für die CLI-Seite: ANTHROPIC_BASE_URL und AUTH_TOKEN richtig setzen.
Claude Code Benutzerhandbuch
Komplettes CLI-Tutorial von der Installation bis zur Beherrschung.
Schritte und Zitate auf dieser Seite wurden am 2026-10-07 anhand der offiziellen Anthropic-Dokumentation und der QCode-Dokumentation geprüft; Änderungen beim Anbieter sind ohne Vorankündigung möglich. Menü- und Schaltflächennamen der Desktop-App ändern sich je nach Version, maßgeblich ist Ihre installierte Version; für die Modellverfügbarkeit gilt /models.