> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Erweiterte CC-Switch-Einrichtung für BetterToken Provider

> Verwalte BetterToken Provider, Modellzuordnungen und Proxy-Einstellungen für Claude Code, Claude Desktop, Codex CLI, OpenCode und OpenClaw in CC Switch.

CC Switch ist eine plattformübergreifende Desktop-App zur Verwaltung von Providern für Claude Code, Claude Desktop, Codex, OpenCode und OpenClaw. Diese Seite bündelt die erweiterte Einrichtung. Beginne mit der direkten Einrichtungsseite des jeweiligen Tools und verwende CC Switch nur, wenn du Provider wechseln oder ein nicht natives Modell verwenden musst.

## CC Switch installieren

<Tabs>
  <Tab title="macOS">
    Homebrew ist die einfachste Option. Du kannst auch die neueste `.dmg`- oder `.zip`-Datei aus den [GitHub Releases](https://github.com/farion1231/cc-switch/releases) herunterladen.

    ```bash theme={null}
    brew tap farion1231/ccswitch
    brew install --cask cc-switch
    ```
  </Tab>

  <Tab title="Windows">
    Lade das neueste Installationsprogramm `CC-Switch-v{version}-Windows.msi` oder die portable `.zip`-Version aus den [GitHub Releases](https://github.com/farion1231/cc-switch/releases) herunter.
  </Tab>

  <Tab title="Linux">
    Lade die neueste `.deb`-, `.rpm`- oder `.AppImage`-Version aus den [GitHub Releases](https://github.com/farion1231/cc-switch/releases) herunter.
  </Tab>
</Tabs>

## Was du vorbereiten musst

* BetterToken API Key (<a href={"https://bettertoken.ai/register"}>hier registrieren</a>)
* Claude Code verwendet das Anthropic-Protokoll, daher ist seine `Base URL` `https://www.bettertoken.ai`
* Claude Desktop mit einem nicht-Claude Provider erfordert die neueste Version von Claude Desktop und CC Switch `v3.16.5` oder höher
* Codex, OpenCode und OpenClaw verwenden das OpenAI-kompatible Protokoll, daher ist ihre `Base URL` `https://www.bettertoken.ai/v1`
* Bereite eine aktuelle Modell-ID des **GPT Providers** für Codex, OpenCode und OpenClaw vor. Du kannst sie aus der <a href={"https://bettertoken.ai/pricing"}>BetterToken model plaza</a> kopieren oder von CC Switch über `/v1/models` abrufen lassen

<Info>
  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.
</Info>

<Note>
  BetterToken verwendet zwei Zugriffsmodi: Anthropic und OpenAI-kompatibel. Um `https://www.bettertoken.ai` und `https://www.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.
</Note>

## BetterToken Provider hinzufügen

<Tabs>
  <Tab title="Claude Code" id="claude-code">
    <Steps>
      <Step title="Claude Code in CC Switch öffnen und Provider hinzufügen">
        Öffne CC Switch, wechsle zu **Claude Code** und klicke auf **Add Provider**.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/cc-switch/claude-code-add-provider.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=517f215f5f828187647dd214eacfe19b" alt="Die Claude-Code-Seite in CC Switch mit der Schaltfläche oben rechts zum Erstellen eines neuen Providers." style={{ borderRadius: '0.5rem' }} width="2000" height="1792" data-path="images/cc-switch/claude-code-add-provider.png" />
        </Frame>
      </Step>

      <Step title="Grundfelder ausfüllen">
        * **Provider Name**: `BetterToken-claude` (oder ein anderer leicht erkennbarer Name)
        * **Base URL**: `https://www.bettertoken.ai`
        * **API Key**: dein BetterToken API Key
        * **API Format**: `OpenAI Responses API`

        Die nummerierten Markierungen im Screenshot entsprechen diesen Feldern:

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

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/claude-code-basic-fields.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=514944678fb16510d03f0f2610bd8b70" alt="Die Bearbeitungsseite des Claude-Code-Providers in CC Switch mit den Feldern Provider Name, API Key und API Endpoint." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/claude-code-basic-fields.png" />
        </Frame>
      </Step>

      <Step title="Modellzuordnung je nach Provider einrichten">
        * Wenn du den **Claude Provider** verwendest, musst du die erweiterten Optionen oder Modellzuordnung normalerweise nicht ändern
        * Wenn du den **GPT Provider** verwendest, führe die zusätzliche Einrichtung unten durch:

        1. Öffne **Advanced Options**
        2. Setze **API Format** auf **OpenAI Responses API**

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/claude-code-api-format.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=5605667b764f033854f78dc981592f84" alt="Der Bereich für erweiterte Optionen in CC Switch mit API Format auf OpenAI Responses API." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/claude-code-api-format.png" />
        </Frame>

        3. Klicke in **Model Mapping** auf **Fetch Model List**
        4. Wähle Werte aus den Dropdowns für **Primary Model**, **Thinking Model**, **Haiku Default Model**, **Sonnet Default Model** und **Opus Default Model** ausdrücklich aus

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/claude-code-model-mapping.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=d1104cc24dae2825dfed3a6be53dc6b3" alt="Der Bereich für Modellzuordnung in CC Switch mit Fetch Model List und Zuordnungen für Primary-, Thinking-, Haiku-, Sonnet- und Opus-Modelle." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/claude-code-model-mapping.png" />
        </Frame>

        Für alle diese Modelle sollten aktuelle Modell-IDs des **GPT Providers** aus der <a href={"https://bettertoken.ai/pricing"}>BetterToken model plaza</a> verwendet werden.
      </Step>

      <Step title="Speichern, wechseln und über Proxy-Aktivierung entscheiden">
        Gehe nach dem Speichern zurück zur Provider-Liste:

        1. Markiere den BetterToken Provider als aktiv
        2. Wenn du den **Claude Provider** verwendest, musst du den **CC Switch proxy** oben links nicht aktivieren
        3. Wenn du den **GPT Provider** verwendest, aktiviere den **CC Switch proxy**

        Der Screenshot unten zeigt BetterToken-claude in der Provider-Liste aktiviert. Aktiviere den **CC Switch proxy** oben links nur, wenn du den **GPT Provider** verwendest.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/claude-code-enable-proxy.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=13c9adc5d76d5a2d1fae0e52e90a87ca" alt="Die CC-Switch-Provider-Liste mit ausgewähltem und als In Use markiertem BetterToken-claude." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/claude-code-enable-proxy.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Desktop" id="claude-desktop">
    <Info>
      Diese Registerkarte gilt für GPT, Kimi, GLM und andere nicht-Claude Provider. Verwende für den Claude Provider die [direkte Claude-Desktop-Einrichtung](/de/faq/claude-desktop-bettertoken-api).
    </Info>

    <Steps>
      <Step title="Zu Claude Desktop wechseln und Provider hinzufügen">
        Öffne CC Switch, wähle das Symbol **Claude Desktop** in der oberen Werkzeugleiste und klicke dann oben rechts auf **+**.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/zaxT_L3BQP7MnZS4/images/claude-desktop-third-party-models/cc-switch-claude-desktop-add-provider.png?fit=max&auto=format&n=zaxT_L3BQP7MnZS4&q=85&s=8906aaf8ead247cf406a55a51f402bdf" alt="Zu Claude Desktop in CC Switch wechseln und auf die Plus-Schaltfläche klicken, um einen Provider hinzuzufügen." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/claude-desktop-third-party-models/cc-switch-claude-desktop-add-provider.png" />
        </Frame>
      </Step>

      <Step title="Grundfelder eingeben">
        * **Provider Name**: verwende einen erkennbaren Namen wie `BetterToken-GPT`
        * **API Key**: dein BetterToken API Key
        * **API Endpoint**: `https://www.bettertoken.ai`

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/zaxT_L3BQP7MnZS4/images/claude-desktop-third-party-models/provider-basic-fields.png?fit=max&auto=format&n=zaxT_L3BQP7MnZS4&q=85&s=ba55f76085a213cde6527e86aca54798" alt="Provider Name, API Key und API Endpoint für Claude Desktop in CC Switch eingeben." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/claude-desktop-third-party-models/provider-basic-fields.png" />
        </Frame>
      </Step>

      <Step title="API Format und Modellzuordnung festlegen">
        Wähle für **API Format** **OpenAI Responses API (Requires routing)** und klicke dann auf **Fetch Models**.

        Ordne Sonnet, Opus, Fable und Haiku der Model ID zu, die du verwenden möchtest:

        | Modellrolle | Angefordertes Modell |
        | ----------- | -------------------- |
        | Sonnet      | `YOUR_MODEL_ID`      |
        | Opus        | `YOUR_MODEL_ID`      |
        | Fable       | `YOUR_MODEL_ID`      |
        | Haiku       | `YOUR_MODEL_ID`      |

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/zaxT_L3BQP7MnZS4/images/claude-desktop-third-party-models/provider-model-mapping.png?fit=max&auto=format&n=zaxT_L3BQP7MnZS4&q=85&s=d93c1bd4098f1f839cd2ab6a426d1aba" alt="OpenAI Responses API auswählen und die Claude-Desktop-Modellzuordnung in CC Switch konfigurieren." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/claude-desktop-third-party-models/provider-model-mapping.png" />
        </Frame>

        Kopiere eine aktuelle Model ID aus der <a href={"https://bettertoken.ai/pricing"}>model plaza</a> oder dem API-Key-Dialog **Setup**. Aktiviere **Declare 1M** nur, wenn die model plaza das Modell als Unterstützung eines 1M-Kontextfensters ausweist.
      </Step>

      <Step title="Speichern, wechseln und Proxy aktivieren">
        Speichere den Provider, setze ihn auf **In use** und aktiviere dann den Proxy-Schalter oben links.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/zaxT_L3BQP7MnZS4/images/claude-desktop-third-party-models/provider-enable-proxy.png?fit=max&auto=format&n=zaxT_L3BQP7MnZS4&q=85&s=99800d159627886f2e999f9eceb061bf" alt="Der BetterToken Provider für Claude Desktop ist aktiv und der CC Switch proxy ist aktiviert." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/claude-desktop-third-party-models/provider-enable-proxy.png" />
        </Frame>
      </Step>

      <Step title="Claude Desktop neu starten">
        Beende Claude Desktop vollständig und öffne es erneut. **Gateway** unten links bestätigt die aktive Einrichtung. Wähle ein zugeordnetes Modell aus dem Modellmenü im Nachrichtenfeld.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/zaxT_L3BQP7MnZS4/images/claude-desktop-third-party-models/claude-desktop-gateway-ready.png?fit=max&auto=format&n=zaxT_L3BQP7MnZS4&q=85&s=bf573497e7a842b367f6c9ca95fdc99b" alt="Claude Desktop zeigt nach dem Neustart Gateway und bietet die über CC Switch zugeordneten Modelle an." style={{ borderRadius: '0.5rem' }} width="2400" height="1600" data-path="images/claude-desktop-third-party-models/claude-desktop-gateway-ready.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Codex" id="codex-cli">
    <Steps>
      <Step title="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

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/cc-switch/codex-cli-add-provider.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=5f892bf124c432babed54886c6051632" alt="Die Codex-Seite in CC Switch mit oben ausgewähltem Codex und der Schaltfläche oben rechts zum Erstellen eines neuen Providers." style={{ borderRadius: '0.5rem' }} width="1800" height="1532" data-path="images/cc-switch/codex-cli-add-provider.png" />
        </Frame>
      </Step>

      <Step title="Grundfelder ausfüllen">
        * **Provider Name**: `BetterToken`
        * **Base URL**: `https://www.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**

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/codex-cli-basic-fields.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=a6483a11bcf6eaf3663134f407843391" alt="Die Bearbeitungsseite des Codex-Providers in CC Switch mit den Feldern Provider Name, API Key und Base URL." style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/codex-cli-basic-fields.png" />
        </Frame>
      </Step>

      <Step title="Modell abrufen und zuordnen">
        Klicke auf **Fetch Models** und wähle eine aktuelle Model ID aus der <a href={"https://bettertoken.ai/pricing"}>model plaza</a>. Codex benötigt keinen CC Switch proxy.
      </Step>

      <Step title="Speichern und wechseln">
        Speichere den Provider und wechsle Codex zu BetterToken. CC Switch schreibt die zugehörigen Codex-Auth- und Konfigurationsdateien für dich.

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

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/ZMo3cJhJx4ISRrsG/images/cc-switch/codex-cli-activate-provider.png?fit=max&auto=format&n=ZMo3cJhJx4ISRrsG&q=85&s=52dc850977af1443b4b573a27726c4b5" alt="Die Codex-Provider-Liste in CC Switch mit ausgewähltem und als in use markiertem BetterToken." style={{ borderRadius: '0.5rem' }} width="1800" height="1686" data-path="images/cc-switch/codex-cli-activate-provider.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="OpenCode" id="opencode">
    <Steps>
      <Step title="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**.
      </Step>

      <Step title="Grundfelder ausfüllen">
        * **Provider Name**: `BetterToken`
        * **Base URL**: `https://www.bettertoken.ai/v1`
        * **API Key**: dein BetterToken API Key
        * **API Format**: `OpenAI Compatible`
      </Step>

      <Step title="Standardmodell auswählen">
        Verwende nach Möglichkeit **Fetch Models**. Wenn du das Modell manuell eingeben musst, verwende eine aktuelle Modell-ID des **GPT Providers** aus der <a href={"https://bettertoken.ai/pricing"}>BetterToken model plaza</a>.

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

      <Step title="Speichern und wechseln">
        Speichere den Provider und wechsle OpenCode zu BetterToken.
      </Step>
    </Steps>
  </Tab>

  <Tab title="OpenClaw" id="openclaw">
    <Steps>
      <Step title="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**.
      </Step>

      <Step title="Grundfelder ausfüllen">
        * **Provider Name**: `BetterToken`
        * **Base URL**: `https://www.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.
      </Step>

      <Step title="Standardmodell auswählen">
        Verwende nach Möglichkeit **Fetch Models**. Wenn du das Modell manuell eingeben musst, verwende eine aktuelle Modell-ID des **GPT Providers**.

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

      <Step title="Speichern und wechseln">
        Speichere den Provider und wechsle OpenClaw zu BetterToken.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 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 beim Wechsel zu einem Drittanbieter die offizielle Codex-Anmeldung beibehalten und offizielle sowie Drittanbieter-Sitzungen in einem Verlauf zusammenführen. Starte Codex nach der Aktivierung dieser Optionen neu. Siehe [offizielle Codex-Anmeldung und einheitlichen Sitzungsverlauf beibehalten](/de/faq/codex/official-login-third-party-api).

## Häufige Probleme

* Füge `/v1` nicht zur Claude-Code-`Base URL` hinzu
* Wenn Claude Code den **GPT Provider** verwendet, setze **API Format** unter **Advanced Options** auf **OpenAI Responses API**
* Wenn Claude Code den **Claude Provider** verwendet, musst du den **CC Switch proxy** nicht aktivieren
* Wenn Claude Desktop einen nicht-Claude Provider verwendet, aktiviere den **CC Switch proxy** und starte die App vollständig neu
* Codex, OpenCode und OpenClaw sollten `https://www.bettertoken.ai/v1` verwenden
* Wenn Codex, OpenCode oder OpenClaw nach einem Modell fragt, verwende eine Modell-ID des **GPT Providers**
* 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 der Wechsel nicht wirksam wird, bestätige, dass BetterToken der aktive Provider in CC Switch ist, und starte den betroffenen Client oder das Gateway wie oben beschrieben neu

## Verwandte Seiten

* Claude-Code-Details: [Claude Code](/de/ai-tools/claude-code)
* Direkte Claude-Provider-Einrichtung für Claude Desktop: [Claude Desktop](/de/faq/claude-desktop-bettertoken-api)
* Codex-Details: [Codex](/de/ai-tools/codex)
* OpenCode-Details: [OpenCode](/de/ai-tools/opencode)
* OpenClaw-Details: [OpenClaw](/de/ai-tools/openclaw)

## Verwandte FAQ

* [Drittanbieter-Modelle und Codex in Claude Desktop verwenden](/de/faq/claude-desktop/third-party-models)
* [OpenAI-kompatible API und Anthropic-kompatible API: Unterschiede](/de/faq/concepts/openai-compatible-vs-anthropic-compatible)
* [MCP, API Key und Base URL: Unterschiede](/de/faq/concepts/mcp-vs-api-key-base-url)
* [Was sind model\_provider, base\_url und wire\_api?](/de/faq/codex/model-provider-base-url-wire-api)
* [OpenAI-kompatible API in Cline konfigurieren](/de/faq/cline/openai-compatible-api)