Cursor / Claude Code / Cherry Studio mit einem eigenen KI-Gateway verbinden

Tutorial · 2026-11-20 · 7 Min. Lesezeit

Gängige KI-Tools unterstützen benutzerdefinierte APIs – das heißt, du kannst sie auf dein eigenes Gateway (z. B. 4-4 AI) richten und Schlüssel und Abrechnung vereinheitlichen. Dieser Artikel behandelt die Konfiguration der drei meistgenutzten Tools und das allgemeine Vorgehen bei der Fehleranalyse.

Voraussetzung: Du hast bereits einen API-Schlüssel. Falls nicht, erledige Registrierung und Schlüsselerstellung zuerst mit „In 5 Minuten zur einheitlichen KI-API". Dieser Artikel nutzt die Base URL von 4-4 AI (https://www.4-4.vip/v1) als Beispiel – andere OpenAI-kompatible Gateways funktionieren genauso.

Cursor

Das Chat-Modell von Cursor kann eine benutzerdefinierte OpenAI-kompatible Schnittstelle nutzen:

  1. Settings → Models öffnen (oder die Models-Einstellungsseite);
  2. Im Bereich OpenAI API Key die Konfiguration aufklappen: Gateway-Schlüssel (sk-...) eintragen;
  3. Override OpenAI Base URL ankreuzen/ausfüllen: https://www.4-4.vip/v1;
  4. In der Modellliste die im Gateway verfügbaren Modellnamen ergänzen (exakt identisch mit dem Gateway-Kanalnamen, Groß-/Kleinschreibung beachten);
  5. Nach bestandener Verify-Prüfung im Chat unten einfach zum benutzerdefinierten Modell wechseln.

Hinweis: Cursors eingebaute Tab-Vervollständigung und Teile von Composer laufen über Cursors eigenen Dienst und bleiben von dieser Konfiguration unberührt; benutzerdefinierte Modelle sind primär für den Chat gedacht.

Claude Code

Claude Code nutzt das Anthropic-Protokoll. Voraussetzung für die Gateway-Anbindung ist, dass das Gateway den Anthropic-Protokoll-Endpunkt (/v1/messages) unterstützt – Gateways auf new-api-Basis (inklusive 4-4 AI) können dieses Protokoll konvertieren; Claude-Protokoll-Anfragen werden umgesetzt und an den tatsächlichen Modellkanal geroutet.

Konfiguration über Umgebungsvariablen (im Terminal, in dem claude gestartet wird):

export ANTHROPIC_BASE_URL="https://www.4-4.vip"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_GATEWAY_KEY"

# start
claude

In Windows PowerShell entsprechend:

$env:ANTHROPIC_BASE_URL = "https://www.4-4.vip"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_GATEWAY_KEY"
Zwei Details: ① ANTHROPIC_BASE_URL ohne /v1-Suffix (den Anthropic-Protokollpfad ergänzt das Tool selbst); ② Wenn Claude Code Nicht-Claude-Modelle nutzen soll, prüfe, ob im Gateway-Kanal das passende Modell-Mapping konfiguriert ist, und verwende die Modellnamen der Gateway-Seite.

Cherry Studio

Cherry Studio unterstützt benutzerdefinierte OpenAI-kompatible Anbieter am direktesten:

  1. Einstellungen → Modellanbieter: einen OpenAI-kompatiblen Anbieter hinzufügen/wählen;
  2. API-Adresse: https://www.4-4.vip/v1 (manche Versionen ergänzen /v1 automatisch – auf Doppelung achten);
  3. API-Schlüssel: den Gateway-Schlüssel eintragen;
  4. In der Modellverwaltung die verfügbaren Modellnamen manuell ergänzen, speichern und im Chat auswählen.

Das allgemeine Muster: jedes OpenAI-kompatible Tool

Zahllose Tools (LobeChat, Open WebUI, Immersive Translate, diverse IDE-Plugins) folgen demselben Konfigurationsschema – merke dir das Dreier-Set:

KonfigurationselementWertTypische Stolperfallen
Base URLhttps://www.4-4.vip/v1Manche Tools brauchen /v1, andere nicht – bei 404 zuerst mit/ohne /v1 testen
API KeyGateway-Schlüssel (sk-...)Leerzeichen am Anfang/Ende, abgelaufener Schlüssel, aufgebrauchtes Guthaben
ModellnameName wie im Gateway-KanalMuss exakt mit der Gateway-Seite übereinstimmen; Namen, die das Tool nicht kennt, funktionieren nicht

Fehler-Schnellcheck

401 Unauthorized

404 Not Found

400 Model Not Found / kein Kanal verfügbar

Streaming bricht ab / keine Antwort

Häufige Fragen (FAQ)

Sind meine Daten über das Gateway sicher?

Deine Anfragen werden über das Gateway an den Upstream-Modellkanal weitergeleitet. Prüfe bei der Gateway-Wahl dessen Log- und Datenschutzrichtlinien; bei sensiblen Daten die Speicherung von Chat-Logs auf Gateway-Seite deaktivieren oder Kanäle ohne Datenpersistenz nutzen.

Kann ein Tool mehrere Gateways gleichzeitig konfigurieren?

Die meisten Tools unterstützen mehrere Anbieter mit sofortigem Wechsel (z. B. Cherry Studio, Cursor). Mit unterschiedlichen Tokens pro Tool lassen sich Nutzung und Limits getrennt auswerten und setzen.

Warum wird ein einheitliches Gateway statt Direktanschlüsse pro Tool empfohlen?

Drei Gründe: zentrale Schlüsselverwaltung (kleinere Angriffsfläche), einheitliche Abrechnung und sichtbare Nutzung (kein Abgleich über mehrere Plattformen), Modelle jederzeit austauschbar (Anbieterentkopplung, Wechsel nur in der Gateway-Konfiguration).

Verwandte Artikel

4-4 AI Schnellstart: In 5 Minuten mit einer einheitlichen KI-API verbinden OpenAI-kompatible Schnittstelle: Ein Schlüssel für GLM, DeepSeek, Qwen und weitere Modelle. Mit lauffähigen Be 7 Engineering-Praktiken zur Senkung der Token-Kosten von KI-Anwendungen Modell-Tier-Routing, Kontext-Kürzung, Prefix-Caching, Budget-Guardrails — sieben dauerhaft wirksame Sparprakti
Bereit loszulegen?

Ein Schlüssel für GLM, DeepSeek, Qwen und weitere gängige Modelle – einheitliche Abrechnung und veranschaulichte Nutzung.

Modelle & Preise ansehen Kostenlos testen