Claude Desktop in Russland: Inference Gateway konfigurieren

Claude Desktop kann über den Entwicklermodus mit einem externen Inference Gateway verbunden werden. Eine Claude-Key-Gruppe arbeitet direkt mit einem Anthropic-kompatiblen Endpoint; für eine OpenAI-kompatible Gruppe ist eine lokale Route über CC Switch erforderlich. Der dokumentierte macOS-Ablauf unten reicht von der Auswahl der API-Key-Gruppe bis zur Prüfung der Anfrage im Dashboard.

Bereit, den gewählten Weg mit einer kurzen Anfrage zu testen? BetterToken-Konto erstellen

Prüfen Sie beim Zuordnen von Modellen in CC Switch GPT, Sonnet, Opus, Fable und Haiku gegen die für Ihren Key aktuell verfügbare Model ID.

Verbinden Sie Ihren eigenen API Key über die passende Route und prüfen Sie sie sofort. BetterToken stellt getrennte OpenAI-kompatible und Anthropic-kompatible Schnittstellen bereit; die Adresse darf daher nicht anhand des Modellnamens gewählt werden. Öffnen Sie den aktuellen BetterToken-Leitfaden für Claude Desktop, bestimmen Sie Ihre API-Key-Gruppe und folgen Sie dem passenden Abschnitt.

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://bettertoken.ai; Authentifizierungsschema ist x-api-key.
• GPT, Kimi, GLM oder ein anderer Nicht-Claude-Provider: Verwenden Sie den Tab Claude Desktop in CC Switch, OpenAI Responses API (Requires routing), eine explizite Modellzuordnung und den aktivierten Proxy.

Übertragen Sie keine Einstellungen zwischen den Routen. Das direkte Gateway mit x-api-key ist für Modelle des Claude-Providers. Bei anderen Providern nutzen Sie die getrennte CC-Switch-Route für Protokollumsetzung, Modellzuordnung, Proxy und Neustart von Claude Desktop.

Direkte Einrichtung für einen Claude-Provider

1. Installieren Sie das aktuelle Claude Desktop über die offizielle Claude-Downloadseite, aktivieren Sie dann über Help → Troubleshooting → Enable Developer Mode den Entwicklermodus und beenden Sie die App vollständig.
2. Öffnen Sie Developer → Configure Third-Party Inference…, wählen Sie Gateway und tragen Sie https://bettertoken.ai als Gateway Base URL, Ihren API Key aus Token management sowie x-api-key als Gateway auth scheme ein.
3. Klicken Sie auf Apply locally und anschließend auf Save & Restart. Wählen Sie nach dem Start Continue with Gateway; Gateway unten links zeigt die aktive Route an.

Erweiterte Route für einen anderen Provider als Claude

Verwenden Sie diese Route für GPT, Kimi, GLM und andere nicht-Claude-Provider. Nutzen Sie aktuelle Versionen von Claude Desktop und CC Switch; die aktuelle BetterToken-Anleitung verlangt CC Switch v3.16.5 oder neuer.

1. Provider auf dem Tab Claude Desktop hinzufügen

Wählen Sie in CC Switch oben das Symbol Claude Desktop und klicken Sie auf +.

Provider Name: BetterToken-GPT
API Endpoint: https://bettertoken.ai
API Key: Ihr BetterToken API Key

Der Name dient nur zur Unterscheidung. Veröffentlichen Sie den Key nicht und verschieben Sie ihn nicht in eine gemeinsame Konfigurationsdatei.

2. Format wählen und Modelle zuordnen

Wählen Sie bei API Format OpenAI Responses API (Requires routing) und klicken Sie auf Fetch Models. Ordnen Sie Sonnet, Opus, Fable und Haiku der benötigten aktuellen Model ID aus der BetterToken model plaza oder dem Setup-Fenster Ihres Keys zu. Aktivieren Sie Declare 1M nur, wenn der aktuelle Katalog für das Modell ein 1M-Kontextfenster nennt.

3. Provider anwenden und Claude Desktop neu starten

Speichern Sie den Provider, markieren Sie ihn als In use und aktivieren Sie den Proxy oben links in CC Switch. Beenden Sie Claude Desktop vollständig und öffnen Sie es erneut. Gateway unten links bestätigt die aktive Einrichtung; wählen Sie das zugeordnete Modell neben dem Eingabefeld.

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 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: Kopieren Sie den Key erneut und wählen Sie x-api-key für die direkte Claude-Route; bei der erweiterten Route prüfen Sie den Key im CC-Switch-Provider.
• Keine Antwort und kein Dashboard-Eintrag: Prüfen Sie bei der erweiterten Route, ob der gewünschte Provider als In use markiert und der CC-Switch-Proxy aktiviert ist.
• 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 der direkten Einrichtung ändert sich nichts: Klicken Sie auf Save & Restart und wählen Sie anschließend Continue with Gateway.
• Nach der CC-Switch-Einrichtung ändert sich nichts: Beenden Sie Claude Desktop vollständig, öffnen Sie es erneut und prüfen Sie Gateway unten links.

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?

Nein. Die direkte Route für Modelle des Claude-Providers nutzt den Anthropic-kompatiblen Endpoint https://bettertoken.ai ohne /v1. Für einen anderen Provider füllen Sie das direkte Gateway nicht analog aus, sondern konfigurieren den Provider im getrennten Claude-Desktop-Tab 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-Route. Für andere Provider konfigurieren Sie die Felder im CC-Switch-Provider nach dem aktuellen Leitfaden. Prüfen Sie danach Desktop-Antwort und neuen Dashboard-Eintrag.