Takeover van AI-programmeertools met één klik
Met Takeover kun je je veelgebruikte AI-programmeer CLI-tools naar de lokale AI Gateway laten verwijzen, zonder handmatig configuratiebestanden te bewerken. Na de Takeover worden de verzoeken van deze tools via http://127.0.0.1:11580 uniform gerouteerd naar de providerkanalen die je in de Gateway hebt geconfigureerd, en opgenomen in uniforme verbruiks- en kostenstatistieken.
Hoe het werkt
Wanneer je Takeover uitvoert voor een tool, voert de Gateway achtereenvolgens het volgende uit:
- Controleer de gezondheidsstatus van de Gateway en bevestig dat het proxy-endpoint beschikbaar is.
- Maak automatisch een exclusieve virtuele sleutel aan (de Gateway schrijft deze naar de toolconfiguratie; de leesbare tekst kan op elk moment worden opgehaald op de sleutelpagina).
- Back-up het originele configuratiebestand met de
.bak-extensie (bijv.~/.claude/settings.json.bak). - Schrijf nauwkeurig / voeg diep samen de configuratie die naar de Gateway verwijst, en behoud je overige instellingen ongewijzigd.
- Ververs de interfacestatus om de huidige Takeover-status weer te geven.
Bij het stoppen van de Takeover wordt ook 'nauwkeurig verwijderd': alleen wanneer de configuratie daadwerkelijk naar deze Gateway verwijst, worden de betreffende sleutels ingetrokken, om te voorkomen dat je andere handmatig geconfigureerde instellingen per ongeluk worden verwijderd; tegelijkertijd wordt de virtuele sleutel die automatisch bij de Takeover is aangemaakt, ingetrokken.
Takeover-status
Elke tool toont een van vier statussen op de pagina AI Gateway → Toegangsbeheer → Clients:
| Status | Betekenis |
|---|---|
| Overgenomen (deze Gateway) | De tool verwijst naar de lokale AI Gateway |
| Verbonden (ander adres) | De tool is geconfigureerd met een ander adres (handmatig geconfigureerd of verwijst naar een andere Gateway); de Gateway overschrijft dit niet automatisch |
| Niet overgenomen | De tool is gedetecteerd, maar verwijst nog niet naar de Gateway |
| Niet gedetecteerd | De configuratiemap van de tool is niet op deze computer gevonden |
Voorwaarden
- Je bent ingelogd op je ServBay-account en hebt ten minste één beschikbaar kanaal geconfigureerd op de pagina Kanalen.
- De doel-AI-tool is op deze computer geïnstalleerd (de Gateway bepaalt het bestaan aan de hand van de configuratiemap).
Takeover uitvoeren
Ga naar de pagina AI Gateway → Toegangsbeheer → Clients, zoek de doel-tool in de takenlijst en klik op Takeover. Na een succesvolle Takeover verandert de status in 'Overgenomen (deze Gateway)'. Om dit ongedaan te maken, klik je op Takeover stoppen.
Takeover-details per tool
De onderstaande tabel toont de configuratiebestanden en inhoud die daadwerkelijk worden gewijzigd wanneer elke tool wordt overgenomen, zodat je dit kunt begrijpen en problemen kunt oplossen:
| Tool | Configuratiebestand | Geschreven inhoud | Gateway-adres |
|---|---|---|---|
| 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 + top-level model_provider = "servbay" | http://127.0.0.1:11580/v1 |
| 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 + modeldefinitie | http://127.0.0.1:11580/v1 |
| CodeBuddy | ~/.codebuddy/models.json | Diep samenvoegen van het servbay-modelknooppunt | http://127.0.0.1:11580/v1 |
| opencode | ~/.config/opencode/opencode.json | Diep samenvoegen van het provider.servbay-knooppunt (aggregeert modellen uit alle kanalen) | http://127.0.0.1:11580/v1 |
| Crush | ~/.config/crush/crush.json | Diep samenvoegen van het providers.servbay-knooppunt | http://127.0.0.1:11580/v1 |
Waarom het adres van Claude Code geen /v1 bevat
Claude Code gebruikt het Anthropic-protocol en de Gateway voegt zelf paden zoals /v1/messages samen. Daarom moet ANTHROPIC_BASE_URL het rootadres van de Gateway zijn (zonder /v1). De meeste andere tools gebruiken een OpenAI-compatibel protocol en vereisen het achtervoegsel /v1. Takeover vult dit automatisch in volgens de conventies van elke tool; je hoeft dit niet handmatig te onderscheiden.
Herstellen en probleemoplossing
- Originele configuratie herstellen — Klik op Verwijderen en de Gateway trekt de configuratie die naar deze Gateway verwijst nauwkeurig in. Je kunt ook handmatig herstellen met het
.bak-back-upbestand in dezelfde map. - Status toont 'Verbonden (ander adres)' — Dit betekent dat de tool momenteel naar een ander adres verwijst (handmatig geconfigureerd of naar een andere Gateway). Om te voorkomen dat je instellingen worden overschreven, neemt de Gateway niet automatisch over; je kunt eerst de configuratie handmatig opschonen en daarna overnemen.
- De tool geeft nog steeds fouten na Takeover — Controleer of de Gateway-proxyservice actief is, of het betreffende kanaal gezond is en of de virtuele sleutel niet is ingetrokken. Op de pagina Statistieken en monitoring kun je controleren of verzoeken de Gateway bereiken.
Veelgestelde vragen (FAQ)
- V: Beschadigt Takeover mijn bestaande toolconfiguratie?
- A: Nee. De Gateway schrijft / voegt alleen de sleutels samen die verband houden met de Gateway en maakt vóór het schrijven een back-up van het oorspronkelijke bestand als
.bak. Andere instellingen blijven ongewijzigd.
- A: Nee. De Gateway schrijft / voegt alleen de sleutels samen die verband houden met de Gateway en maakt vóór het schrijven een back-up van het oorspronkelijke bestand als
- V: Kan ik het na de Takeover nog handmatig terugdraaien?
- A: Ja. Klik op 'Verwijderen' om het door de Gateway te laten intrekken, of herstel handmatig met de
.bak-back-up.
- A: Ja. Klik op 'Verwijderen' om het door de Gateway te laten intrekken, of herstel handmatig met de
- V: Waar is de virtuele sleutel die voor de Takeover wordt gebruikt?
- A: De Gateway maakt automatisch een exclusieve virtuele sleutel aan voor elke overgenomen tool. Deze kun je bekijken en beheren op de pagina Sleutels.
- V: De tool in de lijst toont 'Niet gedetecteerd'?
- A: Dit betekent dat de configuratiemap van de tool niet op deze computer is gevonden. Installeer en start de tool eerst eenmaal zodat de configuratiemap wordt aangemaakt, en voer daarna de Takeover uit.
Samenvatting
Takeover vereenvoudigt het omslachtige en foutgevoelige 'handmatig bewerken van configuratiebestanden van elke tool' tot één klik: automatisch sleutels aanmaken, automatisch back-uppen, nauwkeurig schrijven en op elk moment herstellen. In combinatie met uniforme kanaal- en verbruiksstatistieken kun je al je AI-programmeertools dezelfde providerconfiguratie en kostenoverzicht laten delen. Als je de Gateway vanuit je eigen code wilt aanroepen, raadpleeg dan Endpoints en omgevingsvariabelen.
