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

# GccAi in CC-Switch verwenden

> Ausführliche Anleitung zur Konfiguration und Nutzung der GccAi-API-Dienste in CC-Switch, mit der Sie mehrere KI-Modelle für unterstütztes Programmieren mit einfacher Konfiguration verwenden können.

## Einführung

CC-Switch ist eine Open-Source-Desktop-Anwendung, die die Verwaltung von API-Anbieterkonfigurationen über mehrere KI-Programmier-CLI-Tools wie Claude Code, Codex und Gemini CLI hinweg vereinheitlicht.
Sie verwandelt das mühsame Bearbeiten von Konfigurationsdateien in wenige Klicks in einer GUI – sobald ein Anbieter hinzugefügt ist, können Sie sofort zwischen API-Diensten wechseln, ohne Konfigurationsdateien manuell bearbeiten zu müssen.

Indem Sie GccAi über CC-Switch verbinden, können Sie den GccAi-Dienst leicht für Claude Code und Codex konfigurieren und frei zwischen mehreren Anbietern wechseln.

## Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie haben:

1. **Ein unterstütztes CLI-Tool installiert**
   Mindestens ein unterstütztes CLI-Tool installiert, wie [Claude Code](https://gccai.heqingsong.uk/de/integrations/dev-tool/claude-code.md) oder [Codex CLI](https://gccai.heqingsong.uk/de/integrations/dev-tool/codex-cli.md)

2. **Einen GccAi-API-Schlüssel erhalten**
   Melden Sie sich in der [GccAi-Konsole](https://gccai.heqingsong.uk/keys) an, um Ihren API-Schlüssel zu erhalten (beginnt mit `sk-`)

> [!NOTE]
>
> **Tipp:** Wenn Sie noch kein GccAi-Konto haben, registrieren Sie sich zuerst bei [GccAi](https://gccai.heqingsong.uk) und holen Sie sich Ihren API-Schlüssel.

## Schritt 1: CC-Switch installieren

Wählen Sie die Installationsmethode entsprechend Ihrem Betriebssystem:

**macOS**

Installation über Homebrew (empfohlen):

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

Sie können auch den `.dmg`-Installer von den [GitHub Releases](https://github.com/farion1231/cc-switch/releases) herunterladen. CC-Switch ist von Apple signiert und notarisiert, sodass es direkt installiert werden kann (erfordert macOS 12 oder neuer).

**Windows**

Laden Sie den `.msi`-Installer oder das portable `.zip` von den [GitHub Releases](https://github.com/farion1231/cc-switch/releases) herunter.

Erfordert Windows 10 oder neuer.

**Linux**

Laden Sie das passende Paket von den [GitHub Releases](https://github.com/farion1231/cc-switch/releases) herunter:

* Debian / Ubuntu: `.deb`-Paket
* Fedora / RHEL: `.rpm`-Paket
* Universell: `.AppImage`-Format
* Arch Linux: `paru -S cc-switch-bin`

> [!NOTE]
>
> Beim ersten Start erkennt CC-Switch automatisch die auf Ihrem Rechner installierten CLI-Tools und kann bestehende Konfigurationen als Standard-Anbieter importieren.

## Schritt 2: GccAi-Anbieter hinzufügen

Oben im CC-Switch-Hauptfenster können Sie zwischen verschiedenen CLI-Tool-Gruppen wechseln. Folgen Sie den Schritten unten je nachdem, welches Tool Sie konfigurieren möchten.

**Für Claude Code konfigurieren**

**1. Zur Claude-Code-Gruppe wechseln**

Wählen Sie oben im Hauptfenster **Claude Code**.

**2. Panel zum Hinzufügen eines Anbieters öffnen**

Klicken Sie oben rechts im Hauptfenster auf die Schaltfläche **+**.

**3. Anbieterdetails ausfüllen**

Füllen Sie das Formular wie folgt aus:

| Feld | Wert | Beschreibung |
| - | - | - |
| **Name** | `GccAi` | Benutzerdefiniertes Label zur Identifikation |
| **Endpoint URL** | `https://gccai.heqingsong.uk` | GccAi-API-Base-URL |
| **API Key** | `sk-xxxxxxxxxxxx` | Ihr GccAi-API-Schlüssel |
| **API Format** | `Anthropic Messages` | Behalten Sie das standardmäßige Anthropic-Native-Format bei |

![CC-Switch main interface](https://mintcdn.com/apicore/_1ZGW4_iuaSfzpC6/images/integrations/cc-switch/step-2.png?fit=max\&auto=format\&n=_1ZGW4_iuaSfzpC6\&q=85\&s=7d91af6ec3f40c7bb2666ba455a09faa)

**4. Konfiguration speichern**

Klicken Sie auf **Add**, um zu speichern. GccAi erscheint in der Anbieterliste.

**Für Codex konfigurieren**

**1. Zur Codex-Gruppe wechseln**

Wählen Sie oben im Hauptfenster **Codex**.

**2. Panel zum Hinzufügen eines Anbieters öffnen**

Klicken Sie oben rechts im Hauptfenster auf die Schaltfläche **+**.

**3. Anbieterdetails ausfüllen**

Ein Codex-Anbieter wird über zwei Blöcke konfiguriert:

Geben Sie den API-Schlüssel im **auth.json**-Block ein:

```json theme={null}
{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}
```

Geben Sie die Anbieterkonfiguration im **config.toml**-Block ein:

```toml theme={null}
model = "gpt-5.5"
model_provider = "gccai"

[model_providers.gccai]
name = "GccAi"
base_url = "https://gccai.heqingsong.uk/v1"
wire_api = "responses"
requires_openai_auth = true
```

**4. Konfiguration speichern**

Benennen Sie den Anbieter (z. B. `GccAi`) und klicken Sie auf **Add**, um zu speichern. CC-Switch validiert sowohl das JSON als auch das TOML automatisch.

> [!NOTE]
>
> **Zur Endpoint-URL:** Claude Code verwendet das Anthropic-native Format mit der URL `https://gccai.heqingsong.uk` (ohne `/v1`); Codex verwendet das OpenAI-kompatible Format mit der URL `https://gccai.heqingsong.uk/v1` (mit
> `/v1`). Verwechseln Sie sie nicht.

## Schritt 3: Anbieter wechseln

Nach dem Hinzufügen können Sie jederzeit zwischen GccAi und anderen Anbietern wechseln:

### Im Hauptfenster wechseln

1. Wählen Sie **GccAi** in der Anbieterliste
2. Klicken Sie auf die Schaltfläche **Enable** (oder **Use**)
3. Eine „Switched successfully"-Benachrichtigung bestätigt die Änderung

![CC-Switch main interface](https://mintcdn.com/apicore/LdtR-ceBhXT3_e8B/images/integrations/cc-switch/step-1.png?fit=max\&auto=format\&n=LdtR-ceBhXT3_e8B\&q=85\&s=46a838ac93d721254556c464cc0b4864)

### Aus dem System-Tray wechseln

CC-Switch bleibt im System-Tray, sodass Sie wechseln können, ohne das Hauptfenster zu öffnen:

1. Klicken Sie auf das CC-Switch-Symbol im System-Tray
2. Klicken Sie im Menü auf den Namen des Zielanbieters – das wirkt sofort

> [!NOTE]
>
> **Zur Aktivierung:** Claude Code unterstützt Hot-Switching – neue Sitzungen übernehmen die neue Konfiguration automatisch. Nach dem Wechsel für Codex müssen Sie das Terminal oder Codex neu starten, damit die Änderung wirksam wird.

## Unterstützte Modelle

Nach dem Wechsel zum GccAi-Anbieter können Sie verschiedene Modelle im entsprechenden CLI-Tool verwenden:

| Modell-ID | Stärken | Empfohlene Anwendungsfälle |
| - | - | - |
| `claude-opus-4-6` | Insgesamt am stärksten | Komplexe Architektur, schwieriges Debugging |
| `claude-sonnet-4-6` | Ausgewogene Leistung & Geschwindigkeit | Alltägliches Programmieren, Codegenerierung |
| `gpt-5.5` | Hervorragende Programmierfähigkeiten | Komplexe Engineering-Aufgaben |
| `gpt-4o` | Hohe Leistung, schnell | Alltägliches Programmieren, schnelle Iteration |

> [!TIP]
>
> In Claude Code verwenden Sie den Befehl `/model`, um Modelle zu wechseln; in Codex verwenden Sie ebenfalls den Befehl `/model`. Die vollständige Modellliste finden Sie im [Claude-Code-Leitfaden](https://gccai.heqingsong.uk/de/integrations/dev-tool/claude-code.md) und im [Codex-CLI-
> Leitfaden](https://gccai.heqingsong.uk/de/integrations/dev-tool/codex-cli.md).

## FAQ

### Q1: Anbieterwechsel wirkt nicht?

* **Claude Code**: Unterstützt Hot-Switching – starten Sie eine neue Sitzung; falls es immer noch nicht funktioniert, starten Sie Claude Code neu
* **Codex**: Nach dem Wechsel das Terminal oder Codex neu starten

### Q2: API-Schlüssel wird als ungültig gemeldet?

1. Stellen Sie sicher, dass der API-Schlüssel mit `sk-` beginnt und vollständig ohne zusätzliche Leerzeichen kopiert wurde
2. Gehen Sie zur [GccAi-Konsole](https://gccai.heqingsong.uk/keys), um zu bestätigen, dass der Schlüssel aktiv ist
3. Prüfen Sie, dass die Endpoint-URL korrekt ist (Claude Code verwendet `https://gccai.heqingsong.uk`, Codex verwendet `https://gccai.heqingsong.uk/v1`)

### Q3: Formatfehler beim Hinzufügen eines Codex-Anbieters?

CC-Switch validiert `auth.json` (JSON-Syntax) und `config.toml` (TOML-Syntax). Prüfen Sie:

* Klammern, Anführungszeichen und Kommas im JSON sind vollständig
* Keine Vollbreite- / Smart-Quotes verwendet
* Feldnamen im TOML sind korrekt geschrieben

### Q4: Welche Dateien ändert CC-Switch?

CC-Switch schreibt in die Konfigurationsdateien jedes Tools:

* **Claude Code**: `~/.claude/settings.json`
* **Codex**: `~/.codex/config.toml` und `~/.codex/auth.json`

CC-Switch sichert diese Dateien automatisch vor dem Wechsel, sodass Sie sie nicht von Hand bearbeiten müssen.

### Q5: Wie sehe ich API-Nutzung und Abrechnung ein?

Melden Sie sich in der [GccAi-Konsole](https://gccai.heqingsong.uk/overview) an, um API-Aufruf-Statistiken, Token-Verbrauchsdetails und Kostentrends zu sehen.

## Support und Hilfe

Wenn Sie bei der Verwendung von CC-Switch auf Probleme stoßen:

* 📚 [GccAi-Dokumentationszentrum](https://gccai.heqingsong.uk)
* 📚 [CC-Switch-Projektseite](https://github.com/farion1231/cc-switch)
* 💬 [Discord-Community](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @GccAi\_](https://x.com/GccAi_)
* 📧 Technischer Support: [zhihong@gccai.heqingsong.uk](mailto:zhihong@gccai.heqingsong.uk)

***

> **[Mit GccAi loslegen](https://gccai.heqingsong.uk)**
>
> Registrieren Sie sich jetzt bei GccAi, holen Sie sich Ihren API-Schlüssel und verwalten Sie mehrere KI-Programmiertools mühelos in CC-Switch!


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.