One-Click Takeover voor AI Programmeertools

Met de One-Click Takeover (Takeover) hoef je nooit meer handmatig configuratiebestanden te bewerken om je favoriete AI programmeer-CLI tools te koppelen aan je lokale AI Gateway. Na overname worden alle verzoeken van deze tools via http://127.0.0.1:11580 automatisch doorgezet naar de door jou ingestelde leverancierskanalen in de gateway, waaronder uniforme rapportage van gebruik en kosten plaatsvindt.

Hoe werkt het?

Bij het uitvoeren van een One-Click Takeover voor een tool, doorloopt de gateway de volgende stappen:

1. Controleren van de gateway-status en zekerstellen dat de proxy-endpoint beschikbaar is.
2. Automatisch aanmaken van een unieke virtuele sleutel (deze wordt maar éénmalig in leesbare vorm getoond en direct in het toolconfiguratiebestand opgeslagen).
3. Back-uppen van het originele configuratiebestand met de extensie .bak (bijv. ~/.claude/settings.json.bak).
4. Precies schrijven / diep samenvoegen van de gateway-instellingen in de configuratie, zonder jouw andere instellingen te wijzigen.
5. Interface-status bijwerken en het actuele takeover-overzicht tonen.

Bij het verwijderen van de takeover gebeurt hetzelfde: eliminatie is exact en vindt alleen plaats als de configuratie daadwerkelijk naar deze gateway wijst, zodat je niet per ongeluk andere handmatig ingestelde opties verliest.

Statusoverzicht Takeover

Voor elke tool zie je in AI Gateway → Endpoints één van vier statussen:

Status	Betekenis
Overgenomen (deze gateway)	De tool verwijst naar de lokale AI Gateway
Verbonden (ander adres)	De tool is ingesteld op een ander adres (door jou aangepast of via andere gateway); deze instellingen worden niet overschreven
Niet overgenomen	De tool is herkend maar nog niet gekoppeld aan de gateway
Niet gevonden	Geen configuratiemap van deze tool gevonden op het systeem

Vereisten

• Je bent ingelogd met een ServBay-account en hebt op de pagina Kanalen minimaal één bruikbaar kanaal geconfigureerd.
• De beoogde AI tool is op dit systeem geïnstalleerd (de gateway controleert dit via de configuratiemap).

Zo gebruik je One-Click Takeover

Navigeer naar AI Gateway → Endpoints, zoek de gewenste tool in de lijst, en klik op One-Click Takeover. Na een succesvolle takeover verandert de status naar “Overgenomen (deze gateway)”. Wil je het ongedaan maken, klik dan op Verwijderen / Herstel.

Details per tool

Onderstaande tabel toont per tool welke configuratiebestanden en -instellingen daadwerkelijk worden aangepast, handig voor volledig inzicht en zelf troubleshooting:

Tool	Configuratiebestand	Ingevoegde instellingen	Gatewayadres
Claude Code	~/.claude/settings.json	env.ANTHROPIC_BASE_URL + env.ANTHROPIC_AUTH_TOKEN	http://127.0.0.1:11580 (zonder /v1)
Codex	~/.codex/config.toml	[model_providers.servbay] sectie + hoofd model_provider = "servbay"	http://127.0.0.1:11580/v1
Gemini CLI	~/.gemini/.env	Twee regels: GOOGLE_GEMINI_BASE_URL + GEMINI_API_KEY	http://127.0.0.1:11580
Qwen Code	~/.qwen/.env	OPENAI_BASE_URL + OPENAI_API_KEY (OpenAI compatibel)	http://127.0.0.1:11580/v1
Kimi CLI	~/.kimi/config.toml	[model_providers.servbay] sectie + definities voor modellen	http://127.0.0.1:11580/v1
CodeBuddy	~/.codebuddy/models.json	Diepe samenvoeging van servbay-modeldefinities	http://127.0.0.1:11580/v1
opencode	~/.config/opencode/opencode.json	Diepe samenvoeging van provider.servbay (meerdere kanaalmodellen)	http://127.0.0.1:11580/v1
Crush	~/.config/crush/crush.json	Diepe samenvoeging van providers.servbay	http://127.0.0.1:11580/v1

Waarom is er geen /v1 bij Claude Code's adres?

Claude Code gebruikt het Anthropic protocol, waarbij de gateway automatisch paden zoals /v1/messages toevoegt. Daarom moet ANTHROPIC_BASE_URL het rootadres van de gateway zijn (zonder /v1). De andere tools volgen het OpenAI-compatibele protocol en vereisen wel de /v1 toevoeging. De One-Click Takeover vult deze details automatisch voor elke tool in; handmatige aanpassing is dus niet nodig.

Herstel en Troubleshooting

• Herstel originele configuratie – Klik op Verwijderen, waarna de gateway enkel de eigen instellingen uit de configuratie haalt. Handmatig herstellen kan altijd door het .bak-bestand terug te plaatsen.
• Status is ‘Verbonden (ander adres)’ – Dit betekent dat de tool momenteel op een ander adres is ingesteld (handmatig door jou of naar een andere gateway). Om overschrijven van jouw voorkeur te voorkomen, neemt de gateway het niet automatisch over. Maak de instellingen handmatig schoon voordat je het alsnog overneemt.
• Tool geeft fouten na takeover – Controleer of de gateway actief is, het gekozen kanaal gezond is, en de virtuele sleutel niet is ingetrokken. Je kunt ook op de pagina Statistieken & Monitoring zien of aanvragen de gateway bereiken.

Veelgestelde vragen (FAQ)

• Vraag: Vernielt de One-Click Takeover mijn bestaande toolconfiguraties?
  • Antwoord: Nee. De gateway vult alleen sleutelwaarden in of voegt deze toe. Vóór elke wijziging wordt een .bak back-up gemaakt; overige instellingen blijven onaangetast.
• Vraag: Kan ik na de takeover handmatig alles terugzetten?
  • Antwoord: Ja. Je kunt de wijzigingen laten verwijderen door op “Verwijderen” te klikken, of het .bak-bestand zelf terugzetten.
• Vraag: Waar staan de gebruikte virtuele sleutels?
  • Antwoord: De gateway maakt automatisch per tool een unieke virtuele sleutel aan die je op de pagina Virtuele Sleutels kunt inzien en beheren.
• Vraag: Mijn tool wordt als ‘Niet gevonden’ weergegeven?
  • Antwoord: De gateway vindt geen configuratiemap van deze tool. Installeer en start de tool één keer op zodat de map aangemaakt wordt, en probeer het dan nogmaals.

Samenvatting

One-Click Takeover maakt het omslachtige, foutgevoelige handmatige bewerken van toolinstellingen overbodig en automatiseert het aanmaken van virtuele sleutels, back-ups, nauwkeurige aanpassing en eenvoudig herstel. Met eenduidig kanaalbeheer en rapportage deel je moeiteloos dezelfde leveranciersconfiguratie en kostenoverzicht tussen al je AI programmeertools. Wil je de gateway vanuit eigen code aanroepen, raadpleeg dan Endpoints en Omgevingsvariabelen.