Claude Desktop

Claude Code in der App Claude Desktop (Tab Code) über OneProvider betreiben, ohne Claude-Konto.

App Claude Desktop mit dem Tab Code

Was funktioniert

Der Tab Code (Claude Code mit grafischer Oberfläche) und Cowork laufen über den integrierten Gateway-Modus von Claude Desktop auf OneProvider, den Anthropic als Drittanbieter-Inferenz (third-party inference) bezeichnet. Ein Claude- oder Anthropic-Konto ist nicht nötig. Es funktioniert unter macOS 14+ und Windows 10 (2004) oder neuer, auch Windows 11.

Einschränkung des Clients

Der Gateway-Modus ist nur lokal: Sitzungen laufen auf Ihrem Computer, es gibt keine Cloud-Sitzungen, kein SSH und kein Remote Control (Fernsteuerung). Desktop übernimmt das Gateway aus dem Formular unten, nicht aus ANTHROPIC_BASE_URL oder ~/.claude/settings.json (die gelten für die Kommandozeile von Claude Code). Ohne das Formular öffnet sich Desktop nur mit einem kostenpflichtigen Claude-Abo.

Einrichtung

1. Claude Desktop installieren und nicht anmelden

   Laden Sie die App von claude.com/download herunter (macOS: .dmg, Claude in den Ordner „Programme“ ziehen; Windows: .msix-Installationspaket) und starten Sie sie. Bleiben Sie auf dem Anmeldebildschirm: Melden Sie sich nicht an und legen Sie kein Anthropic-Konto an.

2. Developer Mode einschalten

   macOS: Wählen Sie in der Menüleiste Help → Troubleshooting → Enable Developer Mode. Windows: Klicken Sie auf dem Anmeldebildschirm oben links auf das Anwendungsmenü ☰, dann auf Help → Troubleshooting → Enable Developer Mode. Die App startet neu und ein Menü Developer erscheint; es bleibt auch nach Neustarts erhalten.

3. Configure Third-Party Inference öffnen

   Wählen Sie Developer → Configure Third-Party Inference… (Drittanbieter-Inferenz konfigurieren). Setzen Sie im Abschnitt Connection den Inference provider auf Gateway und füllen Sie die Karte Gateway credentials wie gezeigt aus. Die base URL lautet genau so, ohne /v1 und ohne weiteren Pfad; fügen Sie Ihren OneProvider-Schlüssel in Gateway API key ein.

   Inference provider: Gateway
   Gateway base URL: https://api.oneprovider.dev
   Gateway API key: sk-your-key-here
   Credential kind: Static API key
   Gateway auth scheme: Bearer (x-api-key funktioniert auch)

4. Modellliste prüfen

   Lassen Sie Models zunächst leer: Desktop fragt https://api.oneprovider.dev/v1/models ab und zeigt die Claude-Modelle aus dem Katalog. Bleibt die Auswahl leer, öffnen Sie den Abschnitt Models und tragen Sie die genaue Claude-Modell-ID (<your-compatible-model-id>) aus dem Modellkatalog ein; der erste Eintrag ist der Standard für neue Code-Sitzungen.

5. Anwenden, neu starten und im Gateway-Modus starten

   Klicken Sie auf Apply Changes, dann auf Save & Restart. Nach dem Neustart bietet der Anmeldebildschirm an, mit Ihrer Inference-Provider-Konfiguration zu starten: Wählen Sie diese Option, nicht die Anthropic-Anmeldung. Öffnen Sie den Tab Code, wählen Sie einen lokalen Projektordner und senden Sie eine Nachricht.

Verbindung prüfen

Anfrage im Konto bestätigen

Senden Sie in einer neuen Code-Sitzung eine kurze Nachricht. Binnen einer Minute sollte die Anfrage im Konto unter „Verbrauch“ mit Modell, Tokens und abgebuchtem Betrag erscheinen. Schlägt sie fehl:

Standard-Anmeldebildschirm ohne die Provider-Option → das Formular wurde nicht angewendet: App vollständig beenden (Cmd+Q unter macOS, Task-Manager unter Windows) und neu öffnen
"Gateway was unreachable" → base URL prüfen (genau https://api.oneprovider.dev) und VPN oder Proxy ausschalten
401 → falscher, widerrufener oder abgelaufener Schlüssel: im Konto unter „Schlüssel“ prüfen
429 insufficient balance → Guthaben des Kontos aufladen, dann erneut senden
Leere Modellauswahl → die Modell-ID im Abschnitt Models ergänzen
"Error 403: Forbidden" → Sie sind auf dem Anthropic-Anmeldepfad: Wählen Sie stattdessen die Provider-Option
Was Desktop angewendet hat: Help → Troubleshooting → Generate Diagnostic Report → Export to file (managed-config.txt, provider-status.txt)
Log: ~/Library/Logs/Claude-3p/main.log (macOS) oder %LOCALAPPDATA%\Claude-3p\Logs\main.log (Windows)

Verbindungsdaten

Protokoll

anthropic

Endpoint

https://api.oneprovider.dev

Schlüsselsicherheit

Der Schlüssel wird nur in der Desktop-Konfiguration auf diesem Computer gespeichert. Nutzen Sie einen eigenen Schlüssel mit Ausgabenlimit; ist der Computer geteilt oder der Schlüssel kompromittiert, löschen oder pausieren Sie diesen Schlüssel im Konto, und der Rest Ihres Guthabens bleibt sicher.

Kurze Antworten

Welche base URL verwende ich?

Claude Code und die Anthropic-SDKs verwenden https://api.oneprovider.dev. OpenAI-SDKs und OpenAI-kompatible Clients verwenden https://api.oneprovider.dev/v1. Ein Schlüssel funktioniert an beiden Adressen; die Modellliste finden Sie auf der Modellseite , die Preise auf der Preisseite .

Wie authentifiziere ich mich?

Senden Sie den unveränderten sk-…-Schlüssel in x-api-key oder Authorization: Bearer: nur eines von beiden, nie beide. Bewahren Sie den Schlüssel in einer Umgebungsvariable auf, nicht in einer Datei, die ins Repository committet wird. Mehr zur Authentifizierung .

Wo bekomme ich einen Schlüssel?

Öffnen Sie Ihr Konto im Telegram-Bot @oneprovider_robot oder auf app.oneprovider.dev, laden Sie das Guthaben auf und tippen Sie auf „Schlüssel ausstellen“. Jeder Schlüssel kann ein eigenes Ausgabenlimit haben. Konto & API-Schlüssel .

Was bedeuten 401, 404 und 429?

401: Der Schlüssel fehlt, ist falsch geschrieben oder steht im falschen Header; fügen Sie den ganzen Schlüssel ohne Anführungszeichen und Leerzeichen ein. 404: meist eine falsche base URL, zum Beispiel ein fehlendes oder doppeltes /v1. 429 mit „Insufficient balance“: Das Guthaben des Kontos oder das Ausgabenlimit des Schlüssels ist aufgebraucht – laden Sie auf, statt es erneut zu versuchen; jedes andere 429 ist ein Rate-Limit, warten Sie dann die Zeit aus Retry-After ab. Details: Fehlercodes und Fehlerbehebung .

Warum brechen Streams ab oder werden zurückgesetzt?

VPN- und VLESS-Proxys puffern SSE oft oder stören die HTTP/2-Aushandlung. OneProvider hat keine regionalen Beschränkungen und puffert keine Streams – schalten Sie den Proxy aus und versuchen Sie es erneut.

Wohin wende ich mich, wenn das nicht reicht?

Schreiben Sie @Oneproviderhelpbot auf Telegram oder öffnen Sie „Support“ im Web-Konto – mit HTTP-Statuscode und genauer Fehlermeldung. So arbeitet der Support .