CC-Switch Vollständiger Leitfaden: In 5 Minuten lernen, Claude Code Multi-API-Konfigurationen zu verwalten

Mit Claude Code zu coden macht richtig Laune, aber die offizielle API ist zu teuer? Sie möchten zu einem Drittanbieter-API-Relay wechseln, wissen aber nicht, wie Sie die Konfigurationsdatei anpassen sollen? CC-Switch wurde genau für diesen Schmerzpunkt entwickelt. In diesem Artikel erfahren Sie, wie Sie in 5 Minuten die Installation und Nutzung von CC-Switch meistern, um eine einheitliche API-Verwaltung für die vier großen KI-Programmierassistenten Claude Code, Codex, OpenCode und Gemini CLI zu realisieren.

Kernwert: Nach dem Lesen dieses Artikels werden Sie wissen, wie Sie CC-Switch nutzen, um mehrere API-Provider visuell zu verwalten, Konfigurationen mit einem Klick zu wechseln und sich von der mühsamen manuellen Bearbeitung von JSON-Dateien zu verabschieden.

Was ist CC-Switch? Und warum brauchen Sie es?

CC-Switch ist eine quelloffene, plattformübergreifende Desktop-Anwendung, die speziell für die zentrale Verwaltung der Konfigurationen von KI-Programmierassistenten entwickelt wurde. Sie wurde vom Entwickler farion1231 erstellt und auf GitHub als Open Source veröffentlicht.

Die Kernpositionierung von CC-Switch

Einfach ausgedrückt ist CC-Switch das „Konfigurationszentrum“ für KI-Programmiertools:

Die 4 unterstützten KI-Programmiertools

🚀 Schnellstart: CC-Switch unterstützt die Anbindung von Drittanbieter-Relays wie APIYI (apiyi.com). Sobald der Provider konfiguriert ist, können Sie Tools wie Claude Code zu deutlich geringeren Kosten nutzen und gleichzeitig den Komfort des Provider-Wechsels per Klick genießen.

CC-Switch Kernfunktionen im Detail

CC-Switch ist nicht nur ein Konfigurations-Switcher, sondern eine vollwertige Management-Plattform für KI-Tools:

Funktion 1: Provider-Management (Kernfunktion)

Dies ist die am häufigsten genutzte Funktion von CC-Switch. Sie unterstützt:

Beispiel für eine Provider-Konfiguration:

{
  "name": "APIYI",
  "baseUrl": "https://api.apiyi.com",
  "apiKey": "sk-your-apiyi-key",
  "models": {
    "claude-sonnet-4-20250514": "claude-sonnet-4-20250514",
    "claude-opus-4-20250514": "claude-opus-4-20250514"
  }
}

Funktion 2: MCP-Server-Management

MCP (Model Context Protocol) ist das Erweiterungsprotokoll für Claude Code. CC-Switch bietet eine einheitliche Oberfläche zur MCP-Verwaltung:

• Unterstützt die Übertragungstypen stdio, http und sse
• Anwendungsübergreifende einheitliche Konfiguration (Claude/Codex/Gemini)
• Visuelles Hinzufügen, Bearbeiten und Löschen von MCP-Servern

Funktion 3: Skills-Management

CC-Switch kann Claude Skills automatisch finden und installieren:

• Automatisches Scannen von Skills in GitHub-Repositories
• One-Click-Installation im Verzeichnis ~/.claude/skills/
• Unterstützung für rekursives Scannen von verschachtelten Verzeichnissen

Funktion 4: Management von System-Eingabeaufforderungen

Erstellen Sie Voreinstellungen für System-Eingabeaufforderungen für verschiedene Szenarien:

• Unbegrenzte Anzahl an Prompt-Voreinstellungen
• Unterstützt CLAUDE.md, AGENTS.md und GEMINI.md
• Schneller Wechsel zwischen verschiedenen Arbeitsmodi

Funktion 5: Lokaler API-Proxy (v3.9.0+)

CC-Switch verfügt über einen integrierten lokalen Proxy-Server, der erweiterte Funktionen bietet:

💡 Technischer Tipp: Die Funktion des lokalen Proxys arbeitet besonders effektiv mit APIYI (apiyi.com) zusammen. APIYI bietet stabile OpenAI-kompatible Schnittstellen, und die Failover-Funktion von CC-Switch kann bei Netzwerkschwankungen automatisch umschalten, um ein unterbrechungsfreies Programmierungserlebnis zu garantieren.

CC-Switch Installationshandbuch

CC-Switch unterstützt die drei großen Plattformen Windows, macOS und Linux und bietet verschiedene Installationsmethoden an.

Windows-Installation

Option 1: MSI-Installationspaket (empfohlen)

Laden Sie die .msi-Datei von den GitHub-Releases herunter und führen Sie die Installation per Doppelklick aus.

Option 2: Portable Version

Laden Sie die portable .zip-Version herunter, entpacken Sie diese und führen Sie die Anwendung direkt aus – eine Installation ist nicht erforderlich.

macOS-Installation

Option 1: Homebrew (empfohlen)

brew install --cask cc-switch

Option 2: Manuelle Installation

Laden Sie die .dmg– oder .zip-Datei herunter und ziehen Sie die Anwendung in Ihren Applications-Ordner (Programme).

Hinweis: Beim ersten Start kann eine Gatekeeper-Warnung erscheinen. Sie müssen die Ausführung in den „Systemeinstellungen → Sicherheit & Datenschutz“ erlauben.

Linux-Installation

CC-Switch bietet verschiedene Paketformate für Linux an:

Installation überprüfen

Starten Sie CC-Switch nach der Installation. Auf der Hauptoberfläche sollte der Status der erkannten CLI-Tools angezeigt werden.

CC-Switch Kurzanleitung zur Konfiguration

Schritt 1: APIYI Provider hinzufügen

1. Klicken Sie auf der Hauptoberfläche auf die Schaltfläche „Add Provider“.
2. Wählen Sie „Custom“ für eine benutzerdefinierte Konfiguration.
3. Geben Sie die folgenden Informationen ein:

Name: APIYI
Base URL: https://api.apiyi.com
API Key: sk-your-apiyi-key  # Erhalten Sie auf apiyi.com

4. Modell-Mapping konfigurieren (optional):

{
  "claude-sonnet-4-20250514": "claude-sonnet-4-20250514",
  "claude-opus-4-20250514": "claude-opus-4-20250514",
  "gpt-4o": "gpt-4o"
}

5. Klicken Sie auf „Save“, um die Konfiguration zu speichern.

API-Key erhalten: Besuchen Sie APIYI unter apiyi.com und registrieren Sie ein Konto, um Ihren API-Key zu erhalten. Die Plattform bietet kostenloses Testguthaben und unterstützt gängige Modelle wie Claude, GPT und Gemini.

Schritt 2: Provider wechseln

Sobald die Konfiguration gespeichert ist, gehen Sie in der Provider-Liste der Hauptoberfläche wie folgt vor:

1. Suchen Sie den gerade hinzugefügten Provider „APIYI“.
2. Klicken Sie auf „Switch“ oder direkt auf den Provider-Eintrag.
3. CC-Switch passt automatisch die Konfigurationsdateien der entsprechenden Tools an.
4. Starten Sie Claude Code oder andere CLI-Tools neu, damit die Änderungen wirksam werden.

Schritt 3: Verbindung testen

Verwenden Sie die Geschwindigkeitstest-Funktion von CC-Switch, um die Konfiguration zu validieren:

1. Klicken Sie auf die Schaltfläche „Test“ neben dem Provider.
2. Warten Sie, bis der Latenztest abgeschlossen ist.
3. Überprüfen Sie die Antwortzeit und die Statusanzeige.

Wenn der Test erfolgreich war, öffnen Sie Ihr Terminal und starten Sie Claude Code:

claude

Wenn Sie einen Dialog führen können, war die Konfiguration erfolgreich.

Beispiel für eine minimalistische Konfiguration

{
  "id": "apiyi-provider",
  "name": "APIYI (empfohlen)",
  "baseUrl": "https://api.apiyi.com",
  "apiKey": "sk-your-apiyi-key",
  "enabled": true,
  "models": {
    "claude-sonnet-4-20250514": {
      "id": "claude-sonnet-4-20250514",
      "name": "Claude Sonnet 4",
      "maxTokens": 64000
    },
    "claude-opus-4-20250514": {
      "id": "claude-opus-4-20250514",
      "name": "Claude Opus 4",
      "maxTokens": 32000
    },
    "gpt-4o": {
      "id": "gpt-4o",
      "name": "GPT-4o",
      "maxTokens": 16384
    },
    "gpt-4o-mini": {
      "id": "gpt-4o-mini",
      "name": "GPT-4o Mini",
      "maxTokens": 16384
    }
  },
  "healthCheck": {
    "enabled": true,
    "interval": 60
  }
}

Erweiterte Funktionen von CC-Switch

Strategien zur Verwaltung mehrerer Provider

CC-Switch unterstützt die Konfiguration mehrerer Provider, um flexible Nutzungsstrategien zu ermöglichen:

┌─────────────────────────────────────────────────┐
│              CC-Switch Provider-Liste             │
├─────────────────────────────────────────────────┤
│  ⭐ APIYI (Hauptnutzung) Latenz: 120ms  ✓ Gesund  │
│  📦 OpenRouter (Backup)  Latenz: 280ms  ✓ Gesund  │
│  🏢 Offizieller Claude (Fall-back) Latenz: 350ms  │
└─────────────────────────────────────────────────┘

Empfohlene Konfiguration:

• Hauptnutzung: APIYI – Günstige Preise, schnelle Zugriffszeiten.
• Backup: OpenRouter – Große Modellauswahl, stabil im Ausland.
• Fall-back: Offizieller Login – Stellt die ständige Verfügbarkeit sicher.

Cloud-Synchronisierung der Konfiguration

CC-Switch unterstützt die Synchronisierung Ihrer Konfiguration mit Cloud-Speichern:

1. Öffnen Sie Settings → Storage.
2. Wählen Sie einen Cloud-Synchronisierungsordner (Dropbox, OneDrive, iCloud Drive).
3. CC-Switch synchronisiert die Provider-Konfigurationen automatisch.

So können Sie dieselbe API-Konfiguration auf mehreren Geräten teilen.

Erweiterte Konfiguration des lokalen Proxys

Nach der Aktivierung des lokalen Proxys führt CC-Switch folgende Schritte aus:

1. Startet einen Proxy-Server auf dem lokalen Rechner.
2. Ändert automatisch die CLI-Konfiguration, sodass sie auf den lokalen Proxy verweist.
3. Der Proxy-Server leitet die Anfragen an den tatsächlichen Provider weiter.

Vorteile:

• Alle Anfragen laufen über einen einheitlichen Zugangspunkt, was die Überwachung erleichtert.
• Automatisches Failover: Fällt ein Provider aus, wird automatisch gewechselt.
• Protokollierung von Anfragen zur einfacheren Fehlerdiagnose.

# Anfragefluss im Proxy-Modus
Claude Code → localhost:8080 → CC-Switch Proxy → APIYI → Claude API

Claude Rectifier Funktion

Die in v3.10.0 neu hinzugefügte Claude Rectifier Funktion dient dazu, Kompatibilitätsprobleme mit Drittanbieter-APIs zu beheben:

• Automatische Korrektur des Formats der „Thinking-Signature“.
• Verbesserte Kompatibilität mit inoffiziellen APIs.
• Reduzierung von Fehlermeldungen des Typs „Formatfehler“.

CC-Switch FAQ (Häufig gestellte Fragen)

# Methode 1: Aktuelles Terminal schließen und neu öffnen
# Methode 2: In Claude Code /exit eingeben und danach neu starten
claude  # Neustart

# Benutzerdefinierte Konfiguration löschen und offiziellen Login wiederherstellen
rm ~/.claude/settings.json
claude  # Erneut am offiziellen Account anmelden

CC-Switch vs. manuelle Konfiguration im Vergleich

🎯 Auswahl-Empfehlung: Wenn Sie häufig zwischen verschiedenen API-Providern wechseln oder mehrere KI-Coding-Tools parallel nutzen, steigert CC-Switch Ihre Effizienz massiv. In Kombination mit APIYI apiyi.com erhalten Sie das beste Erlebnis aus niedrigen Kosten und maximalem Komfort.

Vergleich ähnlicher CC-Switch Tools

Neben CC-Switch gibt es noch weitere hilfreiche Tools für ähnliche Einsatzzwecke:

Empfohlene Kombination: CC-Switch (Konfigurationsmanagement) + APIYI (API-Relay) = Die beste Preis-Leistungs-Lösung

Referenzen

Fazit

CC-Switch ist ein mächtiges Werkzeug zur Verwaltung von Konfigurationen für KI-Programmierassistenten und löst die folgenden Probleme:

1. Komplizierte Konfiguration: Eine visuelle Benutzeroberfläche ersetzt das manuelle Bearbeiten von JSON-Dateien.
2. Umständlicher Wechsel: Wechseln Sie mit nur einem Klick zwischen verschiedenen Providern.
3. Verstreute Tools: Zentrale Verwaltung von Claude Code, Codex, OpenCode und Gemini CLI.
4. Fehlende Geschwindigkeitstests: Integrierte Latenztests helfen dabei, den schnellsten Provider auszuwählen.
5. Verlust von Konfigurationen: Automatisches Backup und Cloud-Synchronisierung sorgen dafür, dass Ihre Einstellungen nie verloren gehen.

Für Entwickler, die regelmäßig KI-Programmiertools nutzen, ist die Kombination aus CC-Switch und APIYI die empfohlene Lösung:

• CC-Switch: Bietet ein komfortables Konfigurationsmanagement.
• APIYI (apiyi.com): Bietet stabile und kostengünstige API-Dienste.

Besuchen Sie APIYI (apiyi.com), um ein Konto zu erstellen und Ihren API-Key zu erhalten. Fügen Sie diesen anschließend als Provider in CC-Switch hinzu, um ein reibungsloses KI-Programmiererlebnis zu genießen.

📝 Autor: APIYI Technik-Team | APIYI apiyi.com – KI-API-Aufrufe einfacher machen