Claude Desktop mit einer Drittanbieter-API: Configure Third-Party Inference und Fehlersuche

Wokey Team · 2026-09-24

Kurz gesagt: Die Claude-Desktop-App kennt genau einen Weg, eine Drittanbieter-API zu nutzen: Developer → Configure Third-Party Inference. Sie liest weder ANTHROPIC_BASE_URL noch ~/.claude/settings.json; eine Konfiguration, die in deinem Terminal funktioniert, bewirkt in der Desktop-App also nichts. Diese Anleitung geht die typischen Probleme durch: ein fehlendes Menü, Einstellungen, die nicht greifen, eine leere Modellliste und Funktionen, die es im Drittanbieter-Modus schlicht nicht gibt. Die vollständige Ersteinrichtung findest du in der Einrichtung von Claude Desktop.

Die richtige Reihenfolge

1. Starte die Desktop-App und melde dich nicht mit einem Anthropic-Konto an.

2. Öffne Help → Troubleshooting → Enable Developer Mode.

3. Öffne Developer → Configure Third-Party Inference….

4. Setze unter Connection den Inference provider auf Gateway und fülle dann Gateway credentials aus:

   Feld	Wert
   Gateway base URL	https://api.wokey.ai (ohne /v1)
   Gateway API key	Dein Wokey-API-Key
   Credential kind	Static API key
   Gateway auth scheme	Bearer (Wokey akzeptiert auch x-api-key; lass den Standard stehen)

5. Klicke auf Apply Changes und dann auf Save & Restart.

Systemanforderungen:

• macOS: 14 (Sonoma) oder neuer, auf Apple Silicon oder Intel.
• Windows: Windows 10 Build 19041 oder neuer, auf x64 oder Arm64.

Das Menü Developer fehlt

Das Menü Developer erscheint erst, wenn der Entwicklermodus aktiv ist: Help → Troubleshooting → Enable Developer Mode. Fehlt dieser Eintrag auch im Menü Help, aktualisiere die App auf die neueste Version; ältere Versionen haben die Einstellungen für Drittanbieter-Inferenz nicht.

Das Konfigurationsfenster ist schreibgeschützt

Liegt auf dem Rechner bereits eine von einem Administrator verteilte Konfiguration, etwa ein MDM-Profil deiner Firma, öffnet sich das Fenster schreibgeschützt, und du kannst lokal nichts ändern. Frag deinen Administrator oder nimm einen nicht verwalteten Rechner.

Umgebungsvariablen haben keine Wirkung

Das ist der häufigste Fehler. Die Desktop-App bezieht ihre Gateway-Einstellungen ausschließlich aus der Konfiguration für Drittanbieter-Inferenz. Sie liest weder ANTHROPIC_BASE_URL noch settings.json.

Der Code-Tab der Desktop-App verhält sich genauso. Er nutzt dieselbe Claude-Code-Engine wie die CLI, aber Gateway-Adresse und Zugangsdaten kommen direkt aus der Desktop-Konfiguration. Einstellungen auf Benutzerebene in ~/.claude/settings.json können sie nicht überschreiben.

Das gilt auch umgekehrt: Die Desktop-Konfiguration wirkt sich nicht auf claude in deinem Terminal aus. Richte beides getrennt ein; für das Terminal siehe die Anleitung zur Base URL in Claude Code.

Die Modellliste ist leer oder unvollständig

Ohne eigene Modellliste ruft die App GET /v1/models des Gateways ab und behält nur Modelle, deren IDs erkennbar zu Claude gehören. Mit Wokey zeigt die automatische Erkennung deshalb Modelle wie claude-opus-5 und claude-sonnet-5 und filtert GPT, Grok und andere Modelle heraus. Das ist so vorgesehen.

Um die Liste festzulegen oder das Standardmodell zu wählen, trage vollständige Modell-IDs in die Modellliste des Konfigurationsfensters ein (Model list, der Schlüssel inferenceModels):

• Der erste Eintrag ist das Standardmodell, und auch neue Sitzungen im Code-Tab starten damit.
• Ist jeder Eintrag eine vollständige ID, überspringt die App die Anfrage an /v1/models.
• Schlägt /v1/models fehl und ist die Liste leer, bleibt die Auswahl leer.

Fehler

Gateway was unreachable: Die App erreicht das Gateway nicht. Prüfe die Gateway base URL auf Tippfehler und teste dann aus einem Terminal mit curl:

curl -X POST https://api.wokey.ai/v1/messages \
  -H "Authorization: Bearer your Wokey API key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":1,"messages":[{"role":"user","content":"."}]}'

Funktioniert curl und die App nicht, liegt es meist an einem Proxy: Das Terminal läuft über einen und die App nicht, oder umgekehrt.

401 mit dem code invalid_api_key: Die Anfrage hat Wokey erreicht, aber der Key fehlt oder ist falsch. Wokey akzeptiert beide Auth-Schemata, an dieser Einstellung musst du also nichts ändern. Füge den Key noch einmal ein.

invalid x-api-key: Die Anfrage ging an Anthropic, die Drittanbieter-Konfiguration ist also nicht aktiv. Meist wurde nicht auf Save & Restart geklickt, oder danach wurde auf dem Anmeldebildschirm die Anmeldung bei Anthropic gewählt. Siehe die Anleitung zu invalid x-api-key.

Für mehr Details: Exportiere einen Bericht über Help → Troubleshooting → Generate Diagnostic Report. Drei Dateien darin sind hilfreich:

• managed-config.txt: die aktive Konfiguration.
• provider-status.txt: der Status der Gateway-Verbindung.
• deployment-mode.txt: der aktuelle Modus.

Die Logs liegen hier:

• macOS: ~/Library/Logs/Claude-3p/main.log
• Windows: %LOCALAPPDATA%\Claude-3p\Logs\main.log

Funktionen, die im Drittanbieter-Modus fehlen

Diese Funktionen hängen von einem Anthropic-Konto oder den Cloud-Diensten von Anthropic ab und sind deshalb mit einem Gateway nicht verfügbar. Das ist kein Konfigurationsproblem:

• Zugriff per Mobilgerät und über claude.ai im Web
• Sprachmodus
• Teilen von Projekten und Plugins
• Claude Design, Claude Security und Claude Tag
• Computer Use
• Remote Control und von Anthropic gehostete Cloud-Umgebungen

Zwei weitere sind standardmäßig aus:

• Tool-Suche und experimentelle Beta-Funktionen. Die App schaltet sie ab, um mit strengen Gateways kompatibel zu bleiben. Die Tool-Suche aktivierst du mit toolSearchEnabled wieder.
• SSH-Remote-Sitzungen. Sie sind im Drittanbieter-Modus in der Beta und setzen voraus, dass ein Administrator eine Host-Allowlist einrichtet.

Zurück zu deinem Anthropic-Konto

Wähle auf dem Anmeldebildschirm die Anmeldung bei Anthropic, um zur normalen Claude-Desktop-App zurückzukehren.