Cursor / Claude Code / Cherry Studio mit einem eigenen KI-Gateway verbinden
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.
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:
Settings → Modelsöffnen (oder dieModels-Einstellungsseite);- Im Bereich
OpenAI API Keydie Konfiguration aufklappen: Gateway-Schlüssel (sk-...) eintragen; Override OpenAI Base URLankreuzen/ausfüllen:https://www.4-4.vip/v1;- In der Modellliste die im Gateway verfügbaren Modellnamen ergänzen (exakt identisch mit dem Gateway-Kanalnamen, Groß-/Kleinschreibung beachten);
- 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"
Cherry Studio
Cherry Studio unterstützt benutzerdefinierte OpenAI-kompatible Anbieter am direktesten:
Einstellungen → Modellanbieter: einen OpenAI-kompatiblen Anbieter hinzufügen/wählen;- API-Adresse:
https://www.4-4.vip/v1(manche Versionen ergänzen /v1 automatisch – auf Doppelung achten); - API-Schlüssel: den Gateway-Schlüssel eintragen;
- 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:
| Konfigurationselement | Wert | Typische Stolperfallen |
|---|---|---|
| Base URL | https://www.4-4.vip/v1 | Manche Tools brauchen /v1, andere nicht – bei 404 zuerst mit/ohne /v1 testen |
| API Key | Gateway-Schlüssel (sk-...) | Leerzeichen am Anfang/Ende, abgelaufener Schlüssel, aufgebrauchtes Guthaben |
| Modellname | Name wie im Gateway-Kanal | Muss exakt mit der Gateway-Seite übereinstimmen; Namen, die das Tool nicht kennt, funktionieren nicht |
Fehler-Schnellcheck
401 Unauthorized
- Beim Kopieren des Schlüssels kamen Leerzeichen/Umbrüche mit → neu kopieren;
- Schlüssel deaktiviert oder Guthaben aufgebraucht → Token-Seite der Gateway-Konsole prüfen;
- Falsches Format des Authorization-Headers → muss
Bearer sk-...sein.
404 Not Found
- Base-URL-Pfad falsch → zwischen „mit /v1" und „ohne /v1" wechseln und testen;
- Das angefragte Protokoll-Endpunkt wird vom Gateway nicht unterstützt → prüfen, ob das Gateway das Protokoll unterstützt (OpenAI /v1/chat/completions oder Anthropic /v1/messages).
400 Model Not Found / kein Kanal verfügbar
- Modellname stimmt nicht mit dem Gateway-Kanal überein → auf der Modell-/Kanalseite der Konsole abgleichen;
- Kanal deaktiviert oder Gruppe ohne Rechte → Modellbereich und Gruppeneinstellungen des Tokens prüfen.
Streaming bricht ab / keine Antwort
- Firmenproxy puffert SSE → mit Direktverbindung testen;
- Tool-Timeout zu kurz → Timeout erhöhen; bei Langtext-Aufgaben zuerst prüfen, ob das Gateway ein erzwungenes Timeout hat.
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
Ein Schlüssel für GLM, DeepSeek, Qwen und weitere gängige Modelle – einheitliche Abrechnung und veranschaulichte Nutzung.
Modelle & Preise ansehen Kostenlos testen