Claude Desktop in Russland: Inference Gateway konfigurieren

Was Third-Party Inference in Claude Desktop bedeutet

Normalerweise verwendet Claude Desktop ein Anthropic-Konto und die Dienste von Anthropic. Third-Party Inference verändert den Weg der Modellanfrage: Die Anwendung sendet sie an das konfigurierte Gateway. Dadurch wird eine Drittanbieter-API weder zu einem Claude-Abonnement noch entfallen Anforderungen der Anwendung an Installation, Updates oder die Verfügbarkeit einzelner Funktionen.

Verwechseln Sie ein Inference Gateway nicht mit Desktop Extensions oder MCP. Extensions geben Claude Zugriff auf lokale Anwendungen und Daten. Das Gateway leitet Anfragen an ein Modell weiter. Ein Fehler in einer Ebene beweist nicht, dass eine andere Ebene defekt ist.

Nach der aktuellen Anthropic-Dokumentation ist Claude Desktop für macOS, Windows und als Linux-Beta verfügbar. Die unten genannten Menüpfade Help → Troubleshooting und Developer → Configure Third-Party Inference… sind im aktuellen BetterToken-Leitfaden für macOS bestätigt. Prüfen Sie auf einem anderen Betriebssystem zuerst, ob Ihre installierte App-Version dieselben Einstellungen anbietet.

Route nach API-Key-Gruppe wählen

• Claude-Gruppe: direktes Anthropic-kompatibles Gateway; Gateway Base URL ist https://www.bettertoken.ai; Authentifizierungsschema ist x-api-key.
• Codex-Gruppe: BetterToken → CC Switch → lokale Claude-Route; Gateway Base URL ist die Service address aus CC Switch; Authentifizierungsschema ist bearer.

Tragen Sie für eine Codex-Gruppe https://www.bettertoken.ai/v1 nicht direkt in das Claude-Desktop-Gateway ein. Das ist eine OpenAI-kompatible Base URL, während das Gateway-Feld eine Anthropic-kompatible Route erwartet. CC Switch nimmt die OpenAI Responses API entgegen, ordnet Modelle zu und stellt Claude Desktop eine lokale Service address bereit.

Direkte Einrichtung für eine Claude-Gruppe

1. Aktuelles Claude Desktop installieren

Laden Sie die Anwendung von der offiziellen Claude-Seite herunter. Im normalen Installationsablauf von Anthropic melden Sie sich an. Der BetterToken-Gateway-Ablauf beginnt vor der üblichen Anmeldung; folgen Sie der Reihenfolge des Gateway-Leitfadens, damit die beiden Modi nicht vermischt werden.

2. Entwicklermodus aktivieren

Öffnen Sie unter macOS:

Help → Troubleshooting → Enable Developer Mode

Klicken Sie auf Enable und beenden Sie Claude Desktop vollständig. Nach dem erneuten Start sollte ein Menü Developer erscheinen.

3. Gateway-Einstellungen öffnen

Gehen Sie zu:

Developer → Configure Third-Party Inference…

Wählen Sie Gateway und füllen Sie Folgendes aus:

Gateway base URL: https://www.bettertoken.ai
Gateway API key: Ihr API Key aus Token management
Gateway auth scheme: x-api-key

Fügen Sie den Key nicht in einen Artikel, Screenshot, öffentlichen Log oder ein Repository ein. Nach der Auswahl von x-api-key sollte die Anwendung die verfügbaren Modelle der Claude-Gruppe abrufen.

4. Einstellungen anwenden und neu starten

Klicken Sie auf Apply locally und dann auf Relaunch now. Wählen Sie nach dem Start Continue with Gateway. Die Kennzeichnung Cowork 3P | Gateway unten links zeigt die aktive Route an.

Lokale Route für eine Codex-Gruppe

Diese Route ist länger: Claude Desktop verbindet sich mit einer lokalen CC-Switch-Adresse, und CC Switch leitet die Anfragen an die BetterToken OpenAI Responses API weiter.

1. BetterToken als Provider in CC Switch hinzufügen

Öffnen Sie Claude Code, klicken Sie auf Add Provider und geben Sie ein:

Provider Name: BetterToken
Base URL: https://www.bettertoken.ai
API Key: Ihr BetterToken API Key

Wählen Sie unter Advanced Options die OpenAI Responses API. Klicken Sie anschließend auf Fetch Model List und ordnen Sie die Modelle ausdrücklich den verfügbaren Mapping-Feldern zu. Verwenden Sie nur aktuelle IDs aus Ihrer Codex-Gruppe; übernehmen Sie kein Modell aus einem alten Artikel oder fremden Screenshot.

2. Lokale Route aktivieren

Speichern Sie den Provider, setzen Sie ihn auf In use und aktivieren Sie den Proxy. Prüfen Sie unter Settings → Routing den Hauptschalter und die Claude-Route. Kopieren Sie die angezeigte Service address; diese lokale Adresse benötigt Claude Desktop.

3. Gateway-Felder in Claude Desktop ausfüllen

Kehren Sie zu Developer → Configure Third-Party Inference… zurück, wählen Sie Gateway und geben Sie ein:

Gateway base URL: Service address aus CC Switch
Gateway API key: Ihr BetterToken API Key
Gateway auth scheme: bearer

Fügen Sie unter Model list die aktuelle Model ID und den Display name hinzu, die Sie in CC Switch konfiguriert haben. Klicken Sie auf Apply locally, bestätigen Sie Relaunch now und wählen Sie Continue with Gateway.

Anfrage und Dashboard-Eintrag prüfen

Beginnen Sie nicht mit dem Zugriff auf Arbeitsverzeichnisse oder einer langen Aufgabe. Senden Sie eine kurze Anfrage ohne personenbezogene Daten, etwa nach dem Unterschied zwischen einem JSON-Array und einem Objekt, und öffnen Sie danach das BetterToken Dashboard.

Eine erfolgreiche Prüfung hat zwei Signale:

1. Claude Desktop zeigt die Antwort und den aktiven Modus Cowork 3P | Gateway.
2. Das Dashboard zeigt einen passenden Eintrag mit Zeit, Modell, Status, Input-/Output-/Cache-Token und Belastung.

Erhalten Sie eine Antwort ohne Eintrag, prüfen Sie, ob die Anwendung tatsächlich das Gateway und nicht einen anderen Modus verwendet. Erscheint ein Eintrag mit Fehlerstatus, hat die Route die API-Ebene erreicht: Prüfen Sie Key-Gruppe, Authentifizierungsschema, Modell und Guthaben. Verwenden Sie das Dashboard nicht als Speicher für vollständige Prompts oder Antworten; entfernen Sie Keys und Anfrageinhalte aus Logs, bevor Sie den Support kontaktieren.

Was prüfen, wenn Claude Desktop keine Verbindung herstellt

• Kein Menü Developer: Aktivieren Sie den Entwicklermodus erneut und beenden Sie Claude Desktop vollständig, statt nur das Fenster zu schließen.
• Your provider setup needs a fix: Prüfen Sie Model list, aktuelle IDs und alle erforderlichen Mappings in CC Switch.
• 401 oder 403: Wählen Sie x-api-key für eine Claude-Gruppe und bearer für die lokale Route einer Codex-Gruppe.
• Keine Antwort und kein Dashboard-Eintrag: Prüfen Sie, ob Proxy, Hauptschalter für Routing und Claude-Route in CC Switch aktiviert sind.
• Ein Eintrag erscheint, aber die Anfrage schlägt fehl: Prüfen Sie Key-Gruppe, aktuelles Modell, verfügbares Guthaben und versehentliche Leerzeichen im Key.
• Nach Apply locally ändert sich nichts: Klicken Sie auf Relaunch now und wählen Sie anschließend Continue with Gateway.

Diagnostizieren Sie das Gateway nicht anhand einer einzelnen Kennzeichnung in der Oberfläche. Stellen Sie den Claude-Desktop-Modus, den Zustand der lokalen Route und den Dashboard-Eintrag gegenüber, um zu erkennen, an welcher Stelle die Kette unterbrochen wurde.

Einschränkungen dieser Methode

BetterToken ist ein unabhängiger API-Anbieter, kein Produkt von Anthropic und kein Ersatz für ein Claude-Abonnement. BetterToken verantwortet seinen eigenen API Endpoint und die Einrichtungsdokumentation. Downloadzugang, Anmeldung, Updates, Cowork, Code mode und andere Funktionen von Claude Desktop hängen von der aktuellen App-Version, dem Tarif und den Regeln von Anthropic ab.

Für die Verbindung zum BetterToken API Endpoint aus Russland ist kein VPN erforderlich. Das gilt nicht für die Claude-Website, den App-Download, Konten oder externe Dienste. Wenn Ihre Menüeinträge von diesem Artikel abweichen, halten Sie an und vergleichen Sie die offizielle Installationsdokumentation für Claude Desktop mit dem aktuellen BetterToken-Einrichtungsleitfaden.

FAQ

Kann ich https://www.bettertoken.ai/v1 in das Claude-Desktop-Gateway eintragen?

Nicht für den hier beschriebenen Ablauf. Das ist eine OpenAI-kompatible Adresse. Eine Claude-Gruppe verwendet den direkten Anthropic-kompatiblen Endpoint https://www.bettertoken.ai; eine Codex-Gruppe verbindet sich über die lokale Service address von CC Switch.

Benötige ich für den Gateway-Modus ein Claude-Konto?

In den normalen Anthropic-Anweisungen werden Sie nach der Installation zur Anmeldung aufgefordert. Der aktuelle BetterToken-Gateway-Leitfaden führt Benutzer vor der normalen Anmeldung durch Continue with Gateway. Mischen Sie die Schritte der beiden Modi nicht; prüfen Sie die Oberfläche Ihrer installierten Claude-Desktop-Version.

Wie erkenne ich das richtige Authentifizierungsschema?

Verwenden Sie x-api-key für eine direkte Claude-Gruppe. Verwenden Sie bearer für eine Codex-Gruppe, die lokal über CC Switch geroutet wird. Prüfen Sie nach dem Anwenden der Einstellungen sowohl die Desktop-Antwort als auch einen neuen Dashboard-Eintrag.