BetterToken in CC Switch einrichten

CC Switch ist eine optionale Desktop-App zum Verwalten von API Keys, Endpoints und Modellen für Claude Code, Claude Desktop, Codex CLI, OpenCode und OpenClaw.

CC Switch installieren

macOS

Homebrew ist die einfachste Option. Du kannst auch die neueste .dmg- oder .zip-Datei aus den GitHub Releases herunterladen.

brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows

Lade das neueste Installationsprogramm CC-Switch-v{version}-Windows.msi oder die portable .zip-Version aus den GitHub Releases herunter.

Linux

Lade die neueste .deb-, .rpm- oder .AppImage-Version aus den GitHub Releases herunter.

Was du vorbereiten musst

• BetterToken API Key (hier registrieren)
• Claude Code verwendet das Anthropic-Protokoll, daher ist seine Base URL https://bettertoken.ai
• Codex, OpenCode und OpenClaw verwenden das OpenAI-kompatible Protokoll, daher ist ihre Base URL https://bettertoken.ai/v1
• Bereite eine aktuelle Modell-ID aus der model plaza für Codex, OpenCode und OpenClaw vor. Du kannst sie aus der BetterToken model plaza kopieren oder von CC Switch über /v1/models abrufen lassen

Beim ersten Start importiert CC Switch automatisch die bereits auf deinem Rechner gefundenen Konfigurationen. Du kannst deinen offiziellen Provider als Fallback behalten und BetterToken zusätzlich hinzufügen.

BetterToken verwendet zwei Zugriffsmodi: Anthropic und OpenAI-kompatibel. Um https://bettertoken.ai und https://bettertoken.ai/v1 nicht zu vermischen, solltest du Provider pro App erstellen, statt Claude Code und die OpenAI-kompatiblen Tools in einen universellen Provider zu zwingen.

BetterToken Provider hinzufügen

Claude Code

Wähle in CC Switch Claude Code und klicke auf Add Provider.

Verbinden Sie Claude Code mit Ihrem BetterToken API Key, der Base URL https://bettertoken.ai und der gewünschten Model ID.

• Provider Name: BetterToken
• API Key: YOUR_API_KEY
• API Endpoint: https://bettertoken.ai

Verwenden Sie das Format Anthropic Messages API. Tragen Sie die gewählten Model IDs unter Model Mapping ein und speichern Sie die Konfiguration.

Kopieren Sie die genaue Model ID aus der model plaza.

Speichern Sie die Konfiguration, aktivieren Sie BetterToken und starten Sie den Client vollständig neu.

Claude Desktop

Claude Desktop unterstützt nur Claude-Modelle. Dies ist eine Einschränkung des Claude Desktop-Clients.

Öffne in CC Switch die separate Seite Claude Desktop, um einen Provider hinzuzufügen oder vorhandene Claude-Code-Provider zu importieren. Prüfe vor der Aktivierung die importierten Claude Model IDs und den Verbindungsmodus. Siehe das offizielle Claude-Desktop-Handbuch.

Für die direkte Einrichtung in Claude Desktop folge der Claude Desktop-Anleitung: Konfiguriere Gateway, die Base URL https://bettertoken.ai, deinen BetterToken API Key und Gateway auth scheme x-api-key. Klicke auf Apply Changes, um die Konfiguration zu speichern und Claude Desktop neu zu starten.

Codex

Für die aktuelle CC-Switch-Version zuerst offiziell anmelden, wenn der Login erhalten bleiben soll. Unter Einstellungen → Anwendungskonfiguration → Codex Offizielle Anmeldung beim Wechsel ohne Übernahme beibehalten aktivieren, dann BetterToken hinzufügen oder aktivieren. Die offizielle Anmeldedatei nicht mit einem Drittanbieter-Key überschreiben.

Codex in CC Switch öffnen und Provider hinzufügen

Öffne CC Switch, wechsle zu Codex und klicke auf Add Provider. Wenn CC Switch zuerst nach einem Preset fragt, wähle bevorzugt OpenAI Compatible oder Custom.

Die nummerierten Markierungen im Screenshot entsprechen diesen Aktionen:

1. Zu Codex wechseln
2. Oben rechts auf Add Provider klicken

Grundfelder ausfüllen

• Provider Name: BetterToken
• Base URL: https://bettertoken.ai/v1
• API Key: dein BetterToken API Key

Wenn du zu einer benutzerdefinierten Konfigurationsansicht wechselst, stelle sicher, dass die zugrunde liegende Konfiguration wire_api = "responses" verwendet.

Die nummerierten Markierungen im Screenshot entsprechen diesen Feldern:

1. Provider Name
2. API Key
3. Base URL

Modell abrufen und zuordnen

Klicke auf Fetch Models und wähle eine aktuelle Model ID aus der model plaza. Codex benötigt keinen CC Switch proxy.

Speichern und wechseln

Speichern und BetterToken aktivieren. Der Drittanbieter-API-Key steht im Provider der config.toml; der Login-Schalter bestimmt, ob die offizielle auth.json erhalten bleibt.

Kehre nach dem Speichern zur Liste zurück und bestätige, dass der BetterToken-Eintrag als In Use markiert ist.

OpenCode

OpenCode in CC Switch öffnen und Provider hinzufügen

Öffne CC Switch, wechsle zu OpenCode und klicke auf Add Provider. Wenn CC Switch zuerst nach einem Preset fragt, wähle bevorzugt OpenAI Compatible oder Custom.

Grundfelder ausfüllen

• Provider Name: BetterToken
• Base URL: https://bettertoken.ai/v1
• API Key: dein BetterToken API Key
• API Format: OpenAI Compatible

Standardmodell auswählen

Verwende nach Möglichkeit Fetch Models. Wenn du das Modell manuell eingeben musst, verwende eine aktuelle Modell-ID aus der BetterToken model plaza.

OpenCode liest die gespeicherte Provider-Konfiguration direkt und benötigt keinen CC Switch proxy.

Speichern und wechseln

Füge den Provider in CC Switch hinzu und wähle anschließend den BetterToken-Provider und das Modell in OpenCode aus. CC Switch speichert diesen Provider neben deinen anderen OpenCode-Providern.

OpenClaw

OpenClaw in CC Switch öffnen und Provider hinzufügen

Öffne CC Switch, wechsle zu OpenClaw und klicke auf Add Provider. Wenn CC Switch zuerst nach einem Preset fragt, wähle bevorzugt OpenAI Compatible oder Custom.

Grundfelder ausfüllen

• Provider Name: BetterToken
• Base URL: https://bettertoken.ai/v1
• API Key: dein BetterToken API Key
• API Format: OpenAI Responses API

Wenn du eine eigene OpenClaw-Provider-Konfiguration bearbeitest, stelle sicher, dass api auf openai-responses gesetzt ist.

Standardmodell auswählen

Verwende nach Möglichkeit Fetch Models. Wenn du das Modell manuell eingeben musst, verwende eine aktuelle Modell-ID aus der model plaza.

OpenClaw verwendet die gespeicherte Provider-Konfiguration direkt und benötigt keinen CC Switch proxy.

Speichern und wechseln

Füge den Provider in CC Switch hinzu und wähle anschließend den BetterToken-Provider und das Modell in OpenClaw aus. CC Switch speichert diesen Provider neben deinen anderen OpenClaw-Providern.

Gespeicherte Änderungen anwenden

Starte nach dem Speichern und Wechseln des Providers den betroffenen Client oder das Gateway neu, bevor du die Einrichtung überprüfst.

• Claude Code: Beende die aktuelle Claude-Code-Sitzung vollständig und starte sie erneut.
• Claude Desktop: Beende die App vollständig, öffne sie erneut und bestätige, dass Gateway unten links erscheint.
• Codex: Starte den aktuellen Codex-Prozess neu oder öffne eine neue Terminal-Sitzung.
• OpenCode: Beende die aktuelle OpenCode-Sitzung und starte sie erneut.
• OpenClaw: Führe openclaw gateway restart aus und verwende dann /new, /status und /model in Discord.

Erweiterte CC-Switch-Funktionen

CC Switch kann die offizielle Codex-Anmeldung bei direktem Wechsel erhalten. Einheitlicher Codex-Sitzungsverlauf ist optional und betrifft nur die CLI-Liste resume; für die aktuelle Desktop-Version ist er nicht nötig. Fortsetzen über einen anderen Provider kann fehlschlagen; nach einem Wechsel eine neue Sitzung beginnen. Siehe Anmeldung und Sitzungsverlauf.

Häufige Probleme

• Füge /v1 nicht zur Claude-Code-Base URL hinzu

• Codex, OpenCode und OpenClaw sollten https://bettertoken.ai/v1 verwenden

• Wenn Codex, OpenCode oder OpenClaw nach einem Modell fragt, verwende eine Modell-ID aus der model plaza

• Wenn Fetch Models fehlschlägt, prüfe den API Key und die Base URL und füge die Model ID anschließend manuell ein

• Wenn Änderungen nicht wirksam werden, prüfe, ob BetterToken in CC Switch für Codex aktiv oder in OpenCode/OpenClaw ausgewählt ist. Starte anschließend den betroffenen Client oder das Gateway wie oben beschrieben neu.

• Wenn Codex nach Ausschöpfen des offiziellen Kontingents das Senden blockiert, kann die beibehaltene offizielle Anmeldung diese Sperre aufrechterhalten. Folge der offiziellen Release-Anleitung: Wechsle in den direkten Modus, deaktiviere Keep official login for direct switches unter Settings → App config → Codex, aktiviere BetterToken und starte Codex vollständig neu. Dadurch wird der API-Key-Modus verwendet und der Zugriff auf Funktionen entfernt, die eine offizielle Anmeldung erfordern. Stelle die Anmeldung mit Erhalt der offiziellen Sitzung wieder her, sobald das Kontingent zurückgesetzt wurde.

Verwandte Seiten

• Claude-Code-Details: Claude Code

• Direkte Einrichtung für Claude Desktop: Claude Desktop

• Codex-Details: Codex

• OpenCode-Details: OpenCode

• OpenClaw-Details: OpenClaw

• Alle unterstützten Tools vergleichen

• API-Fehler, Statuscodes und Ratenbegrenzungen

Verwandte FAQ

• Claude Desktop-Endpoint
• OpenAI-kompatible API und Anthropic-kompatible API: Unterschiede
• MCP, API Key und Base URL: Unterschiede
• Was sind model_provider, base_url und wire_api?
• OpenAI-kompatible API in Cline konfigurieren