CC-Switch Vollständige Anleitung zum Hinzufügen von Anbietern: 4-Schritte-Konfigurationsanleitung am Beispiel von APIYI

Nach der Installation von CC-Switch besteht der nächste Schritt darin, Ihren eigenen API-Anbieter hinzuzufügen. Viele Anfänger bleiben an dieser Stelle hängen: Sie wissen nicht, was sie ausfüllen sollen, wo es hinkommt und wie es wirksam wird. In diesem Artikel nehmen wir APIYI apiyi.com als Beispiel und führen Sie Schritt für Schritt durch den gesamten Prozess des Hinzufügens, Wechselns, Speedtestens und Wiederherstellens des offiziellen Logins für CC-Switch-Anbieter.

Kernwert: Nach der Lektüre dieses Artikels werden Sie die vollständige Verwaltung von CC-Switch-Anbietern beherrschen und alle Konfigurationen vom Hinzufügen bis zur Aktivierung in nur 3 Minuten abschließen.

Vorbereitungen vor dem Hinzufügen eines Anbieters in CC-Switch

Bevor Sie mit der Konfiguration beginnen, sollten Sie Folgendes vorbereiten:

Checkliste der Voraussetzungen

APIYI-Konto registrieren

Falls Sie noch kein APIYI-Konto haben, schließen Sie zuerst die Registrierung ab:

1. Besuchen Sie die offizielle APIYI-Website apiyi.com
2. Klicken Sie auf Registrieren, um Ihr Konto zu erstellen
3. Gehen Sie in die Konsole und holen Sie sich Ihren API Key
4. Notieren Sie sich folgende Informationen:
   • API Key: Eine Zeichenfolge, die mit sk- beginnt
   • Base URL: https://api.apiyi.com

🚀 Bonus für Neubenutzer: APIYI apiyi.com bietet direkt nach der Registrierung kostenloses Testguthaben. Es unterstützt gängige Modelle wie Claude, GPT und Gemini, sodass Sie erst testen können, bevor Sie sich für eine Aufladung entscheiden.

Konflikte bei Umgebungsvariablen prüfen

Wichtig: Wenn Sie zuvor API-Keys in den Systemumgebungsvariablen festgelegt haben, können diese die Konfiguration von CC-Switch überschreiben.

Prüfen und bereinigen Sie widersprüchliche Umgebungsvariablen:

macOS/Linux:

# Prüfen, ob Konflikt-Variablen existieren
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_AUTH_TOKEN
echo $OPENAI_API_KEY

# Falls Werte vorhanden sind, aus ~/.zshrc oder ~/.bashrc löschen

Windows:

• Öffnen Sie "Systemeigenschaften → Erweitert → Umgebungsvariablen"
• Prüfen und löschen Sie Variablen wie ANTHROPIC_API_KEY, OPENAI_API_KEY etc.

CC-Switch: Schritt-für-Schritt-Anleitung zum Hinzufügen von Providern

Schritt 1: Oberfläche zum Hinzufügen von Providern öffnen

1. Starten Sie die CC-Switch-Anwendung.
2. Suchen Sie auf der Hauptoberfläche die Schaltfläche „Add Provider“ (normalerweise direkt über der Provider-Liste).
3. Klicken Sie auf die Schaltfläche, um das Fenster für die Provider-Konfiguration zu öffnen.

Schritt 2: Konfigurationsmethode wählen

CC-Switch bietet zwei Möglichkeiten zum Hinzufügen an:

Da APIYI ein Drittanbieter ist, wählen wir die „Custom“-Konfiguration.

Schritt 3: Provider-Konfigurationsdaten ausfüllen

Dies ist der wichtigste Schritt. Die folgenden Felder müssen korrekt ausgefüllt werden:

Basisinformationen

Claude-Code-Konfiguration (falls verwendet)

CC-Switch unterstützt die folgenden Felder für Claude Code:

Modell-Mapping-Konfiguration (optional)

Falls Sie ein Standardmodell festlegen möchten, können Sie dies hier konfigurieren:

Beispiel für eine vollständige Konfiguration

Hier ist die vollständige Konfiguration für das Hinzufügen von APIYI als Provider:

# 基础信息
Name: APIYI
Base URL: https://api.apiyi.com

# Claude Code 配置
ANTHROPIC_AUTH_TOKEN: sk-your-apiyi-key
ANTHROPIC_BASE_URL: https://api.apiyi.com

# 模型配置 (可选)
ANTHROPIC_MODEL: claude-sonnet-4-20250514

{
  "name": "APIYI",
  "baseUrl": "https://api.apiyi.com",
  "claude": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-apiyi-key",
    "ANTHROPIC_API_KEY": "sk-your-apiyi-key",
    "ANTHROPIC_BASE_URL": "https://api.apiyi.com",
    "ANTHROPIC_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-20250514"
  },
  "codex": {
    "OPENAI_API_KEY": "sk-your-apiyi-key",
    "OPENAI_BASE_URL": "https://api.apiyi.com/v1"
  },
  "gemini": {
    "GEMINI_API_KEY": "sk-your-apiyi-key",
    "GOOGLE_GEMINI_BASE_URL": "https://api.apiyi.com/v1"
  }
}

Schritt 4: Konfiguration speichern

1. Überprüfen Sie, ob alle Pflichtfelder korrekt ausgefüllt sind.
2. Klicken Sie auf die Schaltfläche „Save“ oder „Bestätigen“.
3. CC-Switch überprüft das Format der Konfiguration.
4. Nach dem erfolgreichen Speichern erscheint der neue Provider in der Liste.

💡 Konfigurations-Tipp: Die von APIYI (apiyi.com) bereitgestellten Schnittstellen sind vollständig kompatibel mit den Formaten von OpenAI und Anthropic. Daher reicht es aus, als Basis-URL https://api.apiyi.com einzutragen, ohne das Suffix /v1 hinzuzufügen (CC-Switch erledigt dies automatisch).

3 Wege zum Wechseln des Anbieters in CC-Switch

Nachdem Sie einen Anbieter hinzugefügt haben, müssen Sie zu diesem wechseln, damit er aktiv wird. CC-Switch bietet drei verschiedene Möglichkeiten zum Umschalten:

Methode 1: Wechsel über die Hauptoberfläche (Empfohlen für Einsteiger)

Dies ist der intuitivste Weg:

1. Gehen Sie in der CC-Switch Hauptoberfläche zur Anbieterliste.
2. Suchen Sie den gerade hinzugefügten Anbieter „APIYI“.
3. Klicken Sie rechts neben dem Anbieter auf die Schaltfläche „Enable“ oder „Aktivieren“.
4. Sobald der Status auf Active wechselt, ist die Umschaltung erfolgt.

┌─────────────────────────────────────────────────┐
│              CC-Switch Anbieterliste             │
├─────────────────────────────────────────────────┤
│  ○ Official Login          [Enable]             │
│  ● APIYI (Active)          [Disable] [Test]    │  ← Aktuell aktiviert
│  ○ OpenRouter              [Enable]             │
└─────────────────────────────────────────────────┘

Methode 2: Wechsel über das System-Tray (Empfohlen für fortgeschrittene Nutzer)

Ein noch schnellerer Weg, ganz ohne das Hauptfenster öffnen zu müssen:

1. Suchen Sie das CC-Switch-Symbol im System-Tray (unten rechts unter Windows / in der Menüleiste unter macOS).
2. Klicken Sie auf das Symbol, um das Menü zu öffnen.
3. Klicken Sie direkt auf den Namen des Anbieters „APIYI“.
4. Die Änderung wird sofort wirksam, ohne dass eine zusätzliche Bestätigung erforderlich ist.

Vorteil: Diese Methode ist am schnellsten und eignet sich ideal, wenn Sie häufig zwischen Anbietern wechseln.

Methode 3: Anwendungsspezifische Konfiguration

Wenn Sie mehrere CLI-Tools gleichzeitig nutzen, können Sie für jede Anwendung einen individuellen Anbieter festlegen:

In CC-Switch kann jede Anwendung völlig unabhängig mit einem eigenen Anbieter konfiguriert werden.

CC-Switch: So werden Änderungen wirksam

WICHTIG: Nach dem Wechsel des Anbieters werden die Konfigurationen in den CLI-Tools nicht sofort übernommen. Sie müssen die entsprechende Anwendung neu starten.

Schritte zur Aktivierung

Konfiguration überprüfen

Nach dem Neustart können Sie die Konfiguration wie folgt überprüfen:

Methode 1: Direkter Chat-Test

claude
# Geben Sie eine einfache Frage ein. Wenn eine normale Antwort erfolgt, war die Konfiguration erfolgreich.
> Hallo, bitte antworte auf Deutsch.

Methode 2: CC-Switch Speedtest-Funktion nutzen

1. Klicken Sie auf die Schaltfläche „Test“ neben dem Anbieter.
2. Überprüfen Sie Latenz und Status.
3. Ein grünes Häkchen (✓) zeigt an, dass die Verbindung ordnungsgemäß funktioniert.

Methode 3: Konfigurationsdatei prüfen

# Claude Code Konfigurationsdatei
cat ~/.claude/settings.json

# Sie sollten einen ähnlichen Inhalt sehen:
# "apiBaseUrl": "https://api.apiyi.com"

🎯 Empfehlung zur Überprüfung: Über das Dashboard von APIYI (apiyi.com) können Sie die API-Aufrufprotokolle einsehen. Wenn dort neue Anfragen protokolliert werden, ist die Konfiguration erfolgreich aktiv.

CC-Switch: Zurück zum offiziellen Login

Falls Sie wieder zu den offiziellen Diensten zurückkehren möchten, bietet CC-Switch eine Ein-Klick-Wiederherstellungsfunktion.

Claude Code: Offiziellen Login wiederherstellen

1. Suchen Sie in der Anbieterliste von CC-Switch das Preset „Official Login“.
2. Klicken Sie auf „Enable“, um in den offiziellen Modus zu wechseln.
3. Starten Sie das Terminal neu und führen Sie claude aus.
4. Folgen Sie dem offiziellen Login-Prozess von Claude Code (OAuth-Authentifizierung).

Codex: Offiziellen Login wiederherstellen

1. Wählen Sie das Preset „Official Login“ (Codex-Version).
2. Klicken Sie auf „Aktivieren“.
3. Führen Sie nach dem Neustart codex aus.
4. Schließen Sie die offizielle OpenAI-Authentifizierung gemäß den Anweisungen ab.

Gemini CLI: Offiziellen Login wiederherstellen

1. Wählen Sie das Preset „Google Official“.
2. Klicken Sie auf „Aktivieren“.
3. Führen Sie nach dem Neustart gemini aus.
4. Schließen Sie den Google OAuth-Prozess gemäß den Anweisungen ab.

Zusammenfassung der Wiederherstellung

Hinweis: Nach der Wiederherstellung des offiziellen Logins sichert CC-Switch automatisch Ihre benutzerdefinierten Konfigurationen. Wenn Sie das nächste Mal zu einem Drittanbieter wechseln, bleiben Ihre vorherigen Einstellungen erhalten.

CC-Switch: Fortgeschrittene Techniken zur Lieferantenverwaltung

Technik 1: Vergleich der Lieferantengeschwindigkeit

Nachdem Sie mehrere Anbieter hinzugefügt haben, können Sie einen Sammel-Geschwindigkeitstest durchführen, um den schnellsten auszuwählen:

1. Klicken Sie nacheinander bei jedem Anbieter auf die Schaltfläche „Test“.
2. Notieren Sie die Latenzwerte der einzelnen Anbieter.
3. Wählen Sie den Anbieter mit der niedrigsten Latenz als Ihren primären Provider.

Referenzwerte:

Technik 2: Lieferanten duplizieren

Wenn Sie einen neuen Anbieter mit einer ähnlichen Konfiguration erstellen möchten:

1. Wählen Sie einen vorhandenen Anbieter aus.
2. Klicken Sie auf „Duplicate“ oder wählen Sie per Rechtsklick „Kopieren“.
3. Passen Sie den Namen und Teile der Konfiguration an.
4. Speichern Sie ihn als neuen Anbieter.

Technik 3: Konfigurations-Backup und Synchronisierung

CC-Switch unterstützt die Cloud-Synchronisierung Ihrer Einstellungen:

1. Öffnen Sie Settings → Storage.
2. Wählen Sie einen Cloud-Synchronisierungsordner (z. B. Dropbox, OneDrive).
3. Alle Anbieterkonfigurationen werden nun automatisch synchronisiert.

So können Sie dieselben Anbieter-Einstellungen auf mehreren Geräten nutzen.

Technik 4: Gemeinsame Lieferantenkonfiguration

Ab Version 3.9.0 wird die Funktion „Gemeinsame Lieferanten“ unterstützt:

• Eine Anbieterkonfiguration kann gleichzeitig auf Claude, Codex und Gemini angewendet werden.
• Ideal für die Nutzung von Gateways wie APIYI, die mehrere Protokolle unterstützen.
• Aktivieren Sie beim Hinzufügen eines Anbieters einfach die Option „Sync to all apps“.

CC-Switch: Häufig gestellte Fragen zum Hinzufügen von Lieferanten

APIYI Provider-Konfigurations-Referenz

Zur schnellen Konfiguration sind hier die vollständigen Parameter für APIYI zusammengefasst:

Fazit

In diesem Tutorial hast du den vollständigen Workflow für die Provider-Verwaltung in CC-Switch gelernt:

1. Provider hinzufügen: Klicke auf „Add Provider“ → Wähle „Custom“ → Fülle die Konfiguration aus → Speichern
2. Provider wechseln: Klicke im Hauptmenü auf „Enable“ oder direkt im System-Tray auf den Provider-Namen
3. Anwendung der Änderungen: Starte das Terminal oder den entsprechenden CLI-Client neu
4. Zurück zum offiziellen Login: Wähle das „Official Login“-Preset → Neustart → Schließe den OAuth-Prozess ab

Die Kombination aus CC-Switch + APIYI macht das API-Management zum Kinderspiel:

• CC-Switch: Visuelle Verwaltung, Ein-Klick-Wechsel
• APIYI (apiyi.com): Einheitliche Schnittstelle, günstige Preise, Unterstützung vieler Modelle

Besuche jetzt APIYI (apiyi.com), um deinen API-Key zu erhalten, füge den Provider in CC-Switch hinzu und genieße ein effizientes AI-Programmierungserlebnis!

📝 Autor: APIYI Tech-Team | APIYI apiyi.com – AI-API-Aufrufe einfach gemacht