KI-Programmierwerkzeuge per Ein-Klick übernehmen

Die Ein-Klick-Übernahme (Takeover) ermöglicht es dir, deine gängigen KI-Programmier-CLI-Tools auf das lokale KI-Gateway zu verweisen, ohne manuell Konfigurationsdateien bearbeiten zu müssen. Nach der Übernahme werden die Anfragen dieser Tools über http://127.0.0.1:11580 einheitlich an die von dir im Gateway konfigurierten Anbieter-Kanäle weitergeleitet und in die einheitliche Nutzungs- und Kostenstatistik aufgenommen.

Funktionsweise

Bei der Ein-Klick-Übernahme für ein Tool führt das Gateway nacheinander Folgendes aus:

1. Gateway-Status prüfen und bestätigen, dass der Proxy-Endpunkt verfügbar ist.
2. Automatisch einen dedizierten virtuellen Schlüssel erstellen (das Gateway schreibt ihn in die Tool-Konfiguration; der Klartext kann jederzeit auf der Schlüsselseite abgerufen werden).
3. Die ursprüngliche Konfigurationsdatei sichern mit der Endung .bak (z. B. ~/.claude/settings.json.bak).
4. Die auf das Gateway verweisende Konfiguration präzise schreiben / tief zusammenführen und deine übrigen Einstellungen unangetastet lassen.
5. Den Oberflächenstatus aktualisieren, um die aktuelle Übernahme anzuzeigen.

Das Beenden der Übernahme erfolgt ebenfalls als „präzises Entfernen“: Nur wenn die Konfiguration tatsächlich auf dieses Gateway verweist, werden die entsprechenden Schlüssel entfernt, um ein versehentliches Löschen anderer manuell konfigurierter Einstellungen zu vermeiden; gleichzeitig wird der bei der Übernahme automatisch erstellte virtuelle Schlüssel widerrufen.

Übernahmestatus

Jedes Tool zeigt auf der Seite KI-Gateway → Zugriffsverwaltung → Clients einen von vier Zuständen an:

Status	Bedeutung
Übernommen (dieses Gateway)	Das Tool verweist bereits auf das lokale KI-Gateway
Verbunden (andere Adresse)	Das Tool ist mit einer anderen Adresse konfiguriert (manuell von dir konfiguriert oder auf ein anderes Gateway verweisend); das Gateway überschreibt dies nicht ungefragt
Nicht übernommen	Das Tool wurde erkannt, verweist aber noch nicht auf das Gateway
Nicht erkannt	Das Konfigurationsverzeichnis des Tools wurde auf diesem Rechner nicht gefunden

Voraussetzungen

• Du bist bei einem ServBay-Konto angemeldet und hast auf der Seite Kanäle mindestens einen nutzbaren Kanal konfiguriert.
• Das Ziel-KI-Tool ist auf diesem Rechner installiert (das Gateway ermittelt anhand seines Konfigurationsverzeichnisses, ob es vorhanden ist).

Ein-Klick-Übernahme durchführen

Rufe die Seite KI-Gateway → Zugriffsverwaltung → Clients auf, suche das Ziel-Tool in der Werkzeugliste und klicke auf Ein-Klick-Übernahme. Nach erfolgreicher Übernahme ändert sich der Status zu „Übernommen (dieses Gateway)“. Zum Zurücknehmen klickst du auf Übernahme beenden.

Übernahmedetails für die einzelnen Tools

Die folgende Tabelle listet die Konfigurationsdateien und Inhalte auf, die bei der Übernahme der einzelnen Tools tatsächlich geändert werden, damit du dies nachvollziehen und Fehler eingrenzen kannst:

Tool	Konfigurationsdatei	Geschriebener Inhalt	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] + oberste Ebene model_provider = "servbay"	http://127.0.0.1:11580/v1
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	Tiefes Zusammenführen des servbay-Modellknotens	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	Tiefes Zusammenführen des Knotens provider.servbay (aggregiert Modelle aller Kanäle)	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	Tiefes Zusammenführen des Knotens providers.servbay	http://127.0.0.1:11580/v1

Warum die Adresse von Claude Code kein /v1 enthält

Claude Code verwendet das Anthropic-Protokoll; das Gateway setzt Pfade wie /v1/messages selbst zusammen. Daher muss ANTHROPIC_BASE_URL die Gateway-Basisadresse sein (ohne /v1). Die meisten anderen Tools verwenden das OpenAI-kompatible Protokoll und benötigen das Suffix /v1. Die Ein-Klick-Übernahme trägt die Werte automatisch gemäß den jeweiligen Tool-Konventionen ein; du musst nicht manuell unterscheiden.

Wiederherstellung und Fehlersuche

• Ursprüngliche Konfiguration wiederherstellen — Klicke auf Entfernen, und das Gateway entfernt präzise die auf dieses Gateway verweisende Konfiguration. Du kannst auch manuell die .bak-Sicherungsdatei im selben Verzeichnis zur Wiederherstellung verwenden.
• Status zeigt „Verbunden (andere Adresse)“ — Das bedeutet, dass das Tool derzeit auf eine andere Adresse verweist (manuell von dir konfiguriert oder auf ein anderes Gateway verweisend). Um deine Einstellungen nicht zu überschreiben, übernimmt das Gateway nicht automatisch; du kannst diese Konfiguration zuerst manuell bereinigen und dann übernehmen.
• Tool meldet nach der Übernahme weiterhin Fehler — Stelle sicher, dass der Gateway-Proxy-Dienst läuft, der entsprechende Kanal fehlerfrei ist und der virtuelle Schlüssel nicht widerrufen wurde. Auf der Seite Statistiken und Überwachung kannst du prüfen, ob die Anfragen das Gateway erreichen.

Häufig gestellte Fragen (FAQ)

• F: Beschädigt die Ein-Klick-Übernahme meine vorhandene Tool-Konfiguration?
  • A: Nein. Das Gateway schreibt / führt nur die gatewaybezogenen Schlüssel präzise ein / zusammen und sichert die Originaldatei vor dem Schreiben als .bak. Andere Einstellungen bleiben unverändert.
• F: Kann ich nach der Übernahme manuell zurückändern?
  • A: Ja. Klicke auf „Entfernen“, damit das Gateway die Änderungen zurücknimmt, oder stelle sie manuell mit der .bak-Sicherung wieder her.
• F: Wo befindet sich der für die Übernahme verwendete virtuelle Schlüssel?
  • A: Das Gateway erstellt für jedes übernommene Tool automatisch einen dedizierten virtuellen Schlüssel. Du kannst ihn auf der Seite Schlüssel anzeigen und verwalten.
• F: Das Tool wird in der Liste als „Nicht erkannt“ angezeigt?
  • A: Das bedeutet, dass das Konfigurationsverzeichnis des Tools auf diesem Rechner nicht gefunden wurde. Installiere das Tool und führe es einmal aus, damit es das Konfigurationsverzeichnis erzeugt, und übernimm es dann.

Zusammenfassung

Die Ein-Klick-Übernahme reduziert das mühsame und fehleranfällige manuelle Bearbeiten der Konfigurationsdateien einzelner Tools auf einen einzigen Klick: automatische Schlüsselerstellung, automatische Sicherung, präzises Schreiben und jederzeitige Wiederherstellung. In Verbindung mit einheitlichen Kanälen und Nutzungsstatistiken können alle deine KI-Programmierwerkzeuge dieselbe Anbieterkonfiguration und Kostenansicht nutzen. Wenn du das Gateway in deinem eigenen Code aufrufen möchtest, lies bitte Endpunkte und Umgebungsvariablen.