Ein-Klick-Übernahme für KI-Programmierwerkzeuge

Mit der Ein-Klick-Übernahme (Takeover) kannst du gängige KI-Programmier-CLI-Tools ganz ohne das manuelle Bearbeiten von Konfigurationsdateien auf das lokale KI-Gateway umleiten. Nach der Übernahme werden sämtliche Tool-Anfragen zentral über http://127.0.0.1:11580 an die von dir im Gateway konfigurierten Anbieterkanäle weitergeleitet und einheitlich hinsichtlich Nutzung und Kosten ausgewertet.

Funktionsweise

Bei der Ein-Klick-Übernahme eines Tools führt das Gateway folgende Schritte aus:

1. Überprüfung des Gateway-Status, um sicherzustellen, dass der Proxy-Endpunkt erreichbar ist.
2. Automatisches Erstellen eines eigenen virtuellen Schlüssels (im Klartext nur bei Erstellung sichtbar, wird vom Gateway in die Tool-Konfiguration eingetragen).
3. Backup der Originalkonfigurationsdatei als .bak Suffix (z. B. ~/.claude/settings.json.bak).
4. Präzises Schreiben/Deep Merge der Gateway-Konfiguration, deine weiteren Einstellungen bleiben erhalten.
5. Aktualisierung der Statusanzeige und Übersicht des aktuellen Übernahmezustands.

Beim Entfernen der Übernahme arbeitet das System nach dem Prinzip “gezielte Entfernung”: Nur wenn das Tool wirklich auf das aktuelle Gateway zeigt, wird der zugehörige Eintrag entfernt – andere, manuelle Einstellungen bleiben unberührt.

Übernahmestatus

Für jedes Tool zeigt die Seite KI-Gateway → Endpunkte (Endpoints) einen der folgenden vier Status:

Status	Bedeutung
Übernommen (dieses Gateway)	Tool verweist auf das lokale KI-Gateway
Verbunden (andere Adresse)	Tool ist auf eine andere Adresse konfiguriert (manuell oder fremdes Gateway), automatische Übernahme unterbleibt
Nicht übernommen	Tool erkannt, zeigt aber noch nicht aufs Gateway
Nicht erkannt	Konfigurationsverzeichnis dieses Tools wurde nicht gefunden

Voraussetzungen

• Du bist im ServBay-Konto angemeldet und hast auf der Seite Kanäle mindestens einen nutzbaren Kanal eingerichtet.
• Das gewünschte KI-Tool ist bereits lokal installiert (das Gateway prüft über das Konfigurationsverzeichnis, ob es vorhanden ist).

Übernahme per Klick

Wechsle auf die Seite KI-Gateway → Endpunkte (Endpoints), finde das gewünschte Tool in der Liste und klicke auf Ein-Klick-Übernahme. Nach erfolgreicher Übernahme wird der Status zu „Übernommen (dieses Gateway)“. Zum Widerrufen klickst du auf Entfernen / Wiederherstellen.

Details zur Übernahme je Tool

Die folgende Tabelle zeigt, welche Konfigurationsdateien und Inhalte pro Tool tatsächlich geändert werden. Das hilft beim Verständnis und bei eventuellen Problemen:

Tool	Konfigurationsdatei	Schreiboperation	Gateway-Adresse
Claude Code	~/.claude/settings.json	env.ANTHROPIC_BASE_URL + env.ANTHROPIC_AUTH_TOKEN	http://127.0.0.1:11580 (ohne /v1)
Codex	~/.codex/config.toml	Abschnitt [model_providers.servbay] + Top-Level model_provider = "servbay"	http://127.0.0.1:11580/v1
Gemini CLI	~/.gemini/.env	Zwei Zeilen: GOOGLE_GEMINI_BASE_URL + GEMINI_API_KEY	http://127.0.0.1:11580
Qwen Code	~/.qwen/.env	OPENAI_BASE_URL + OPENAI_API_KEY (OpenAI-kompatibel)	http://127.0.0.1:11580/v1
Kimi CLI	~/.kimi/config.toml	Abschnitt [model_providers.servbay] + Modelldefinition	http://127.0.0.1:11580/v1
CodeBuddy	~/.codebuddy/models.json	Deep Merge des ServBay-Modell-Knotens	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	Deep Merge für provider.servbay-Knoten (Bündelung aller Kanäle)	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	Deep Merge des Knotens providers.servbay	http://127.0.0.1:11580/v1

Warum hat Claude Code keine Adresse mit /v1

Claude Code nutzt das Anthropic-Protokoll, das Gateway ergänzt automatisch Pfade wie /v1/messages. Daher muss die Variable ANTHROPIC_BASE_URL auf die Root-Adresse des Gateways zeigen (ohne /v1). Die meisten anderen Tools verwenden das OpenAI-kompatible Protokoll, bei dem /v1 erforderlich ist. Die Ein-Klick-Übernahme füllt dies für jedes Tool automatisch korrekt aus – du musst nichts manuell ändern.

Wiederherstellung und Fehlerbehebung

• Originalkonfiguration wiederherstellen – Klicke auf Entfernen, um die Konfiguration gezielt zu löschen. Alternativ kannst du die .bak-Sicherungsdatei im selben Verzeichnis von Hand wiederherstellen.
• Status „Verbunden (andere Adresse)“ – Das Tool verweist auf eine andere Adresse (manuell oder fremdes Gateway). Um deine Einstellungen nicht zu überschreiben, übernimmt das Gateway hier nicht automatisch. Lösche ggf. zunächst diese Einstellung, um die Übernahme zu aktivieren.
• Trotz Übernahme Fehler beim Tool – Stelle sicher, dass der Proxy-Dienst des Gateways läuft, der Kanal verfügbar ist und der virtuelle Schlüssel nicht gesperrt wurde. Unter Statistiken & Überwachung kannst du prüfen, ob Anfragen am Gateway ankommen.

Häufig gestellte Fragen (FAQ)

• F: Zerreißt die Ein-Klick-Übernahme meine bestehenden Tool-Einstellungen?
  • A: Nein. Das Gateway schreibt gezielt oder merged nur die mit dem Gateway zusammenhängenden Keys und legt vorher eine .bak-Sicherung der alten Datei an. Alle anderen Einstellungen bleiben erhalten.
• F: Kann ich nach der Übernahme manuell zurückstellen?
  • A: Ja. Entweder über „Entfernen“ zurücknehmen lassen oder manuell mit der .bak-Sicherung wiederherstellen.
• F: Wo finde ich den virtuellen Schlüssel für die Übernahme?
  • A: Für jedes übernommene Tool erstellt das Gateway automatisch einen eigenen virtuellen Schlüssel, der unter Schlüssel eingesehen und verwaltet werden kann.
• F: Tool erscheint in der Liste als „Nicht erkannt“?
  • A: Dann wurde auf dem Rechner kein Konfigurationsverzeichnis gefunden. Bitte zuerst installieren und einmal starten, damit Konfigurationsdateien angelegt werden können.

Fazit

Ein-Klick-Übernahme verwandelt das mühsame und fehleranfällige Bearbeiten einzelner Konfigurationsdateien in einen einzigen Klick: automatische Schlüsselgenerierung, Sicherung, gezielte Eintragung, und jederzeitige Wiederherstellung. Kombiniert mit einheitlicher Kanal- und Verbrauchsstatistik kannst du alle deine KI-Entwicklungswerkzeuge auf dieselbe Lieferanten- und Kostenbasis stellen. Möchtest du das Gateway direkt in eigenen Programmen nutzen, siehe Endpunkte und Umgebungsvariablen.