Entwickler-Ressourcen

CC Switch

CC Switch installieren, einen RunAPI Claude Code Provider hinzufügen, ein Modell auswählen und die Verbindung überprüfen.

Markdown anzeigen

Übersicht

CC Switch ist eine Desktop-Anwendung zur Verwaltung von Coding-Tool-Providern. Diese Anleitung verbindet dessen Claude Code Provider mit RunAPI, ohne dass Sie Ihr Shell-Profil oder Projektdateien manuell bearbeiten müssen.

Bevor Sie beginnen

Installieren Sie Claude Code und melden Sie sich bei Ihrem RunAPI-Konto an.
Erstellen Sie einen Standard-API-Schlüssel gemäß der Authentifizierungsanleitung. Bewahren Sie ihn in CC Switch auf; fügen Sie ihn nicht der Quellcodeverwaltung hinzu.
Verwenden Sie eine RunAPI-Modellkennung, die über diese Verbindung verfügbar ist. Sie können eine in CC Switch auswählen oder sie aus dem Modellkatalog kopieren.

Installieren

Laden Sie CC Switch von den offiziellen Releases für Windows, macOS oder Linux herunter. Unter macOS mit Homebrew installieren Sie es mit:

SHELL

brew install --cask cc-switch

Öffnen Sie CC Switch nach der Installation und wählen Sie Claude Code im App-Switcher.

RunAPI konfigurieren

Wählen Sie Add Provider und dann das Preset Custom.
Benennen Sie den Anbieter RunAPI und geben Sie Ihren API-Schlüssel sowie die Base URL in den Konfigurations-Editor ein:

JSON

{
  "env": {
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_BASE_URL": "https://runapi.ai"
  }
}

Der obige API-Schlüssel ist ein Platzhalter. Erstellen und rotieren Sie Ihren tatsächlichen Schlüssel über die Authentifizierungsanleitung.

Ein Modell auswählen

Verwenden Sie Fetch Models nur zur Ermittlung von Kandidaten. Falls das Modell nicht aufgeführt ist, kopieren Sie seinen Bezeichner aus dem Model Catalog. Das Abrufen weist Modellen keine Claude Code-Anforderungsrollen zu.
Setzen Sie den gewählten Bezeichner als Default fallback model und wählen Sie dann Quick Set. Dadurch wird der Bezeichner auf jede Zeile unter Actual Request Model angewendet: Sonnet, Opus, Fable, Haiku und Subagent.
Vergewissern Sie sich vor dem Speichern, dass jede Zeile den gewünschten RunAPI-Bezeichner anzeigt. CC Switch speichert diese Zuordnung als ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_FABLE_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL und CLAUDE_CODE_SUBAGENT_MODEL.
Speichern Sie den Anbieter, wählen Sie ihn in der Anbieterliste aus und aktivieren Sie ihn.

Überprüfen

Öffnen Sie ein neues Terminal in einem Projektverzeichnis und starten Sie Claude Code:

SHELL

claude

Führen Sie /status aus, um das aktive Modell zu prüfen, und senden Sie dann einen kurzen Prompt wie Describe this repository in one sentence. Eine normale Antwort bestätigt, dass CC Switch den aktiven RunAPI-Anbieter verwendet.

Fehlerbehebung

Authentifizierung schlägt fehl: Überprüfen Sie den API-Schlüssel im aktiven CC Switch-Provider und erstellen Sie bei Bedarf einen neuen Schlüssel über die Authentifizierungsanleitung.
Das erwartete Modell ist nicht verfügbar: Aktualisieren Sie den Modell-Selektor oder kopieren Sie eine unterstützte Modellkennung aus dem Modellkatalog, legen Sie diese dann als Standard-Fallback-Modell fest und wählen Sie erneut Quick Set.
Claude Code verwendet weiterhin einen anderen Provider: Aktivieren Sie den RunAPI-Provider in CC Switch und öffnen Sie dann eine neue Terminalsitzung. Prüfen Sie die Provider-Dokumentation von CC Switch auf Umgebungskonflikte.

Nächste Schritte

Für die Protokollauswahl und das Anfrageverhalten verwenden Sie den LLM API Quickstart. Für Anfrage- und Antwortfelder verwenden Sie die Anthropic Messages API Referenz. Um RunAPI-Tools zu Claude Code hinzuzufügen, fahren Sie mit der MCP-Übersicht fort.