Magpie vs CC Switch: welke manager voor agent-aanbieders moet je gebruiken?

Claude Code, Codex en Gemini CLI zijn agents. Het model dat hun verzoeken beantwoordt en de aanbieder die dat model beschikbaar maakt, zijn afzonderlijke keuzes. Software als Magpie, CC Switch, Claude Code Router en CLIProxyAPI is handig om die keuzes voor meerdere tools te beheren.

Het korte antwoord: zet Magpie op je shortlist voor een gedeelde gateway voor meerdere agents, CC Switch voor een geïntegreerde desktopconfiguratiewerkruimte, Claude Code Router voor expliciete routeringsregels voor verzoeken en CLIProxyAPI voor een compatibele proxy op basis van accounts. Dit zijn overlappende sterke punten, geen vier exclusieve categorieën. CC Switch heeft routering; Magpie heeft werkruimtefuncties; Claude Code Router ondersteunt meer dan alleen Claude Code.

De nuttige vraag is niet welk product de langste functielijst heeft. Het gaat om welk onderdeel van je agentconfiguratie je eraan wilt toevertrouwen.

Afbakening: de officiële documentatie is gecontroleerd op 3 november 2026. Dit is een vergelijking op basis van documentatie, geen praktijktest, betrouwbaarheidstest of beveiligingsaudit. De genoemde ondersteuning garandeert geen identiek gedrag voor elke agent, aanbieder en release. AIHubMix heeft deze vergelijking opgesteld; in de README van Claude Code Router wordt AIHubMix als sponsor vermeld. Die vermelding wordt hier bekendgemaakt, maar niet als technisch bewijs behandeld.

Maak eerst onderscheid tussen de agent en de upstream

Een agent biedt de werkomgeving: toegang tot bestanden, shell-tools, goedkeuringsregels en de gesprekslus. Een model levert antwoorden. Een aanbieder geeft via een eindpunt, een API-sleutel of, waar ondersteund, een accountaanmelding toegang tot dat model.

Als je het upstreammodel wijzigt, wordt Claude Code geen Codex. Een geslaagde API-respons bewijst evenmin dat elke tool-aanroep, afbeelding, redeneerveld of langdurig gesprek zich hetzelfde gedraagt.

Daarom richt deze vergelijking zich op software die bestaande codeeragents aanstuurt. Een gehoste modeldienst of een gateway voor applicatiebackends lost een aanverwant probleem op, maar is niet per se de tool waarmee je de configuratie van je lokale agent beheert.

Vijf handelingen zijn makkelijk met elkaar te verwarren:

• Configuratie wisselen wijzigt het eindpunt, de sleutel of het model dat een agent gebruikt.
• Lokale routering plaatst een gateway tussen de agent en zijn upstream. De gateway kan een bestemming kiezen of API-indelingen vertalen.
• Modellen aggregeren maakt modellen van meerdere aanbieders beschikbaar in één keuzelijst. Dit biedt niet automatisch failover.
• Accounts bundelen kiest uit inloggegevens of accounts. Round-robin is een distributiestrategie, geen garantie dat elk mislukt verzoek alsnog slaagt.
• Failover probeert na een daarvoor in aanmerking komende fout een andere geconfigureerde bestemming. De reikwijdte en voorwaarden hangen af van de implementatie.

Begin met de handeling die je nodig hebt en kies daarna het product.

Een snelle shortlist

Gebruik deze tabel om te bepalen waar je begint en controleer daarna de gedetailleerde beperkingen hieronder.

CCR staat voor Claude Code Router. Deze redactionele shortlists overlappen; het zijn geen exclusieve mogelijkheden of gemeten ranglijsten. Magpie heeft een andere bruikbare bestemming nodig voor failover; de aggregatie van CC Switch biedt geen failover; CCR-regels moeten worden gevalideerd; de desktopaanvulling en statistieken van CLIProxyAPI zijn afzonderlijke onderdelen. De ondersteuning verschilt per agent en aanbieder.

Magpie: plaats meerdere agents achter één modelgateway

Magpie combineert native beheer van agentconfiguraties met een gedeelde lokale gateway. De gedocumenteerde integraties omvatten onder meer Claude Code, Codex, Gemini CLI, OpenCode, Cline en Cursor CLI. De interface toont gedetecteerde installaties; ook een client die een compatibele basis-URL accepteert, kan de gateway gebruiken. Dat is iets anders dan een speciale native integratie.

De gateway vertaalt de indelingen OpenAI Chat, OpenAI Responses, Anthropic Messages en Gemini. Aanbieders kunnen diensten met API-sleutels omvatten, compatibele aangepaste eindpunten, lokale modelservers en ondersteunde abonnementsaccounts. Profielen slaan configuraties voor meerdere agents op onder één naam.

Het onderscheidende idee is een routeringsgroep: meerdere modellen of aanbieders die aan een agent als één keuze worden gepresenteerd. De gedocumenteerde modi omvatten:

• order: gebruik het eerste lid totdat het geen antwoord meer kan geven; probeer daarna het volgende.
• rotate: ga bij elke beurt naar een ander lid.
• usage: geef de voorkeur aan het minst gebruikte lid.
• smart: geef van de geschikte abonnementen met resterend tegoed de voorkeur aan het abonnement dat het eerst wordt gereset.
• pace: selecteer op basis van de resterende wekelijkse capaciteit in verhouding tot de tijd tot de reset.

Groepen kunnen genest zijn. Magpie beschrijft ook hoe een gesprek op het account kan blijven dat antwoordde, wanneer het behoud van de promptcache de moeite waard is. Dat is een routeringsbeleid, geen bewijs dat willekeurige wijzigingen van aanbieder de gecachete status behouden. Bij optionele routering op basis van intentie leest een door de gebruiker gekozen model nieuwe beurten; de documentatie bewijst niet dat dit altijd geld bespaart.

Er is een eenvoudige maar belangrijke grens aan failover: er moet een andere bruikbare bestemming zijn. De README vermeldt expliciet dat er met één account zonder routeringsgroep niets is om naar over te schakelen, zodat de fout bij de agent terechtkomt.

Magpie is meer dan alleen een router. De Library beheert instructies, MCP-servers, skills en subagents. De documentatie beschrijft ook weergaven voor gebruik, quota, kosten en sessies. Er zijn desktop-, terminal-, browser- en CLI-interfaces, met macOS, Windows, Linux, Docker en Termux als ondersteunde omgevingen.

De privacyinstellingen verdienen een afzonderlijke afweging

Maskering in Magpie staat standaard uit. Wanneer deze functie is ingeschakeld, detecteert Magpie lokaal ondersteunde gevoelige waarden, vervangt die vóór verzending door tijdelijke aanduidingen en herstelt ze in antwoorden, ook in toolargumenten. Detectie kan misgaan; een model kan de oorspronkelijke waarde van iets dat is gemaskeerd niet inspecteren. Als ingeschakelde maskering niet kan worden uitgevoerd, beschrijft de README dat het verzoek wordt tegengehouden met HTTP 503.

Dit garandeert niet dat elk geheim wordt gedetecteerd. Lees de privacydocumentatie, waaronder de uitleg over het ontdekken van accounts: Magpie kan bestaande aanmeldingen van agents uitlezen en je kunt het ontdekken uitschakelen.

De README beschrijft ook telemetrie in dagelijkse releasebuilds, met daarin een willekeurige identificatie, versie, systeem- en productgebruiksidentificaties. Privacyinstellingen of DO_NOT_TRACK=1 kunnen die telemetrie uitschakelen. Klikken op partnerlinks en het ophalen van partnerlijsten worden los van die instellingen geteld; volgens de README worden daarbij geen identificatie of adres bewaard. “Lokale gateway” betekent dus niet “geen andere netwerkactiviteit”.

Zet Magpie op je shortlist als: je wilt dat meerdere agents provider-, model- en accountrouteringskeuzes delen. De keerzijde is dat je verantwoordelijkheid neemt voor routeringsbeleid, toegang tot inloggegevens en privacyinstellingen, in plaats van alleen een model uit een menu te kiezen.

CC Switch: een desktopwerkruimte die ook verzoeken routeert

CC Switch alleen een configuratiewisselaar noemen doet zijn gedocumenteerde mogelijkheden tekort. Naast beheer van aanbieders biedt het MCP, skills, promptbibliotheken, projectconfiguraties, sessies, gebruiksregistratie, back-ups en synchronisatie. De vermelde clients omvatten Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode en andere, maar de beschikbare functies verschillen per client.

De drie verbindingsmodi verklaren een groot deel van de vergelijking:

Direct verbindt de agent rechtstreeks met de geselecteerde aanbieder. Bij het wisselen blijven volgens het project niet-gerelateerde hooks, plug-ins, MCP-instellingen en opmerkingen behouden; alleen verbindingsgerelateerde velden veranderen.

Routing stuurt verzoeken lokaal door CC Switch. Het zet Anthropic Messages, OpenAI Chat Completions, OpenAI Responses en Gemini Native om en ondersteunt failoverwachtrijen per tool, circuit breaking en bewaking van de status van aanbieders.

Aggregatie plaatst voor Claude Code en Codex modellen van meerdere aanbieders in de modelkiezer van de client. Verzoeken gaan naar de aanbieder van het gekozen model. Aggregatie biedt geen failover. Er gelden ook beperkingen voor aanbieders, waaronder dat officiële Claude-abonnementen niet beschikbaar zijn in aggregatie. Aanbieders met officiële aanmelding kunnen doorgaans niet worden gebruikt in Routing; OpenAI Official voor Codex is gedocumenteerd als uitzondering.

Daardoor is CC Switch een geloofwaardige optie voor zowel eenvoudiger configuratiewisselen als lokale routering. De nadruk op een desktopwerkruimte is een redactionele reden om het op de shortlist te zetten, geen bewijs dat alternatieven geen bibliotheken of sessieweergaven hebben.

Praktische beperkingen zijn belangrijker dan het aantal voorinstellingen

CC Switch documenteert hot switching voor Claude Code. Voor directe wijzigingen van de aanbieder in Codex, Gemini CLI en Grok Build is doorgaans een herstart nodig; bij Routing kan dat ook nodig zijn wanneer het model verandert. Wijzigingen in de aggregatielijst van Codex vereisen dat je de betreffende daemon, applicatie of editoromgeving opnieuw start. Plan dit buiten een actieve taak.

Een ander nuttig onderscheid staat in de FAQ: de connectiviteitscontrole op de aanbiederskaart test de bereikbaarheid, niet of de API-sleutel of het model werkt. Een groen vinkje is geen end-to-end-acceptatietest.

Gegevens worden standaard opgeslagen in ~/.cc-switch, met een SQLite-database en bijbehorende bestanden. De README beschrijft back-ups van de oorspronkelijke configuratie vóór de eerste wijziging, automatische back-ups en synchronisatie via WebDAV/S3-compatibele diensten. Sommige apparaatinstellingen, statusgegevens en back-ups van de oorspronkelijke configuratie blijven lokaal en worden niet met de cloud gesynchroniseerd. Ga er niet van uit dat synchronisatie van de app elk herstelbaar onderdeel overdraagt.

De officiële app is bedoeld voor desktops met een grafische interface op macOS, Windows en Linux. Raadpleeg de gebruikershandleiding voor de exacte functiematrix per agent en de beperkingen van de modi.

Zet CC Switch op je shortlist als: wijzigingen van aanbieders deel uitmaken van een bredere desktopworkflow met MCP, skills, prompts en projecten. Als je alleen een herbruikbare headless proxy nodig hebt, beoordeel die behoefte dan afzonderlijk; ga niet uit van dezelfde functionaliteit als in de desktopapp.

Claude Code Router: maak routeringsbeslissingen expliciet

Claude Code Router, ofwel CCR, omschrijft zichzelf nu als een gateway en control plane voor meerdere agents. In de README staan Codex, OpenCode, Pi, Kimi CLI, Grok CLI en andere clients naast Claude Code.

De gedocumenteerde mogelijkheden plaatsen het verzoekbeleid centraal: voorwaarden voor headers en requestbodies, prefixen, verzoekherschrijving, retries en geordende fallbackmodellen. Credentialpools en sleutelrotatie staan naast agentprofielen, modeloverschrijvingen en omgevingsinstellingen.

Die combinatie is handig wanneer ‘een andere aanbieder selecteren’ te vaag is. Je wilt misschien dat een bepaalde verzoekvoorwaarde een specifieke upstream selecteert, en vervolgens kunnen nagaan waarom die regel van toepassing was.

CCR documenteert details over verzoeken en antwoorden, de opgeloste aanbieder/het model/de credential, status, latentie, tokens, geschatte kosten, tool-aanroepen en traces. Kostenramingen zijn niet de factuur van de upstream. Logs maken beleid inzichtelijk; ze bewijzen niet dat het beleid de taakprestaties verbetert.

Het project biedt desktopdownloads voor macOS, Windows en Linux, een npm-CLI met een beheerinterface in de browser en Docker-implementatie. Voor de npm-CLI is Node.js 22 of nieuwer vereist. De aanbiedersgids behandelt aangepaste eindpunten, protocolkeuze en credentialpools; er staat ook een waarschuwing in dat verbindingstests verzoeken naar upstreams versturen en gebruik of verzoeklimieten kunnen verbruiken.

Zet CCR op je shortlist als: je expliciete routeringsregels en uitleg over de opgeloste route nodig hebt. De keerzijde is het beleid dat je moet onderhouden. Meer voorwaarden en fallbackpaden betekenen meer combinaties om te valideren, niet automatisch betere resultaten.

CLIProxyAPI: begin met accounts en een compatibele proxy

CLIProxyAPI is gebaseerd op een proxyservermodel. Het biedt OpenAI-compatibele interfaces, waaronder Responses, Gemini-compatibele interfaces, waaronder Interactions, en Claude-compatibele interfaces voor clients en SDK's.

De README documenteert OAuth-ondersteuning voor Codex en Claude Code, toegang tot Gemini-accounts en round-robinverdeling over meerdere accounts voor verschillende aanbieders. Het accepteert ook geconfigureerde OpenAI-compatibele upstreams en biedt een herbruikbare Go-SDK.

Dit is een nuttig vertrekpunt wanneer de belangrijkste vereiste een compatibel eindpunt is dat wordt ondersteund door accounts of credentials. Het bewijst niet dat het kernproject de profielen van elke agent zelf kan bewerken.

Twee details over de distributie zijn van invloed op de keuze:

• De README raadt een aparte desktopapp EasyCLIProxyAPI aan voor grafische configuratie, updates, bediening via het systeemvak en het starten/stoppen van de service.
• Sinds v6.10.0 worden gebruiksstatistieken niet meer meegeleverd met CLIProxyAPI en CPAMC; de README verwijst naar afzonderlijke statistiek- en beheerprojecten.

Behandel de proxy, desktopapp en analyseservice als afzonderlijke onderdelen wanneer je het onderhoud inschat. Leid niet af dat CLIProxyAPI geen retries of herstelopties heeft: controleer de configuratie van de gekozen release. Verwar de round-robinverdeling van accounts evenmin met een gegarandeerd fallbackbeleid tussen modellen.

Zet CLIProxyAPI op je shortlist als: je een proxy op basis van accounts nodig hebt en het prima vindt om de omliggende beheercomponenten afzonderlijk te kiezen.

Voordat je een echt project koppelt

Deze tools werken dicht bij credentials, broncodecontext en uitvoerbare acties van agents. Ook een lokaal proces valt binnen je vertrouwensgrens.

Maak om te beginnen onderscheid tussen een API-sleutel en een abonnementslogin. Dat software een OAuth-flow ondersteunt, betekent niet dat de aanbieder elk gebruik vanuit andere clients toestaat. CC Switch waarschuwt expliciet voor abonnementsgebruik buiten officiële clients. Controleer de actuele voorwaarden van de aanbieder en de regels van je organisatie; een manager verleent geen extra gebruiksrechten en heft geen limieten op.

Bepaal vervolgens wie elk configuratiebestand beheert. Neem als voorzorgsmaatregel niet meerdere managers die automatisch dezelfde agentinstellingen herschrijven. Maak een back-up van de oorspronkelijke bestanden en weet hoe je terugkeert naar directe toegang. Deze aanbeveling is geen bewering dat er een concreet defect in deze producten is aangetoond.

Controleer tot slot hoe credentials en logs worden verwerkt. In deze vergelijking is versleuteling in rust niet geverifieerd. Controleer machtigingen, de reikwijdte van back-ups en synchronisatie, accountdetectie en de inhoud van verzoeklogs voordat je productiecredentials importeert. Als je externe toegang inschakelt, controleer dan de instellingen voor authenticatie en blootstelling; ga er niet van uit dat een lokale standaardinstelling veiligheid garandeert.

Test ten slotte protocolgedrag, niet alleen protocolnamen. OpenAI Chat Completions en Responses zijn verschillende API's; Anthropic Messages en Gemini hebben hun eigen structuren. Een claim over conversie garandeert niet dat elk hulpmiddel, redeneerveld of elke afbeelding zonder informatieverlies wordt verwerkt.

Een kleine acceptatietest

Dit is een voorgestelde oefening voor de lezer, geen test die voor dit artikel is uitgevoerd:

1. Gebruik een tijdelijke repository en testcredentials met beperkte rechten. Leg de oorspronkelijke agentconfiguratie vast.
2. Verbind één agent met één aanbieder. Controleer een gewoon antwoord en bekijk welke aanbieder en welk model daadwerkelijk zijn geselecteerd.
3. Vraag de agent een onschuldig bestand te lezen en een kleine wijziging voor te stellen. Controleer een volledige cyclus van tool-aanroep en resultaat en laat streaming afronden voordat je schrijfbewerkingen toestaat.
4. Voeg alleen een tweede route toe als dat nodig is. Controleer met een veilige lokale mock of een geautoriseerde testopstelling of de bedoelde foutconditie optreedt en de gedocumenteerde alternatieve bestemming wordt geselecteerd. Vermijd het bewust opgebruiken van betaalde quota.
5. Controleer of retries of herstel in je workflow niet leiden tot herhaalde toolacties met neveneffecten. Dit is een acceptatiecriterium, geen geconstateerde productfout.
6. Stop de manager en controleer de gedocumenteerde procedure om terug te keren naar directe toegang of de oorspronkelijke configuratie te herstellen. Controleer of een herstart nodig is en vergelijk de gebruiksramingen daarna met de gegevens van de aanbieder.

Kies de eenvoudigste configuratie die deze oefening doorstaat. Als één agent met zijn officiële aanbieder al aan je behoeften voldoet, lost een lokale gateway misschien helemaal geen probleem op.

Het oordeel: kies een beheerder, geen winnaar

Voor gedeelde routering van modellen en accounts tussen agents begin je met Magpie. Voor desktopconfiguratie en werkruimtenbeheer begin je met CC Switch. Voor expliciet verzoekbeleid en route-inspectie begin je met CCR. Voor een herbruikbare proxy op basis van accounts begin je met CLIProxyAPI en reken je de bijbehorende componenten mee.

Deze aanbevelingen beschrijven de gedocumenteerde focus, geen gemeten superioriteit. De juiste uitkomst is een configuratie waarbij je kunt uitleggen welk model een verzoek heeft verwerkt, welke credentials het heeft gebruikt, wat er bij een fout gebeurt en hoe je de wijziging ongedaan maakt.

Veelgestelde vragen

Is CC Switch alleen een configuratieschakelaar?
Nee. Het documenteert de modi Direct, Routing en Aggregation, waaronder lokale formaatconversie en failoverwachtrijen per tool. De beschikbaarheid verschilt per client en aanbieder.

Biedt aggregatie automatisch fallback?
Nee. CC Switch maakt expliciet onderscheid tussen aggregatie en failover. Een gecombineerde modelkiezer is geen herstelbeleid.

Verwerkt Magpie elk verzoek lokaal?
Nee. De gateway draait lokaal, maar bij inferentie via externe aanbieders worden verzoeken naar upstreams verstuurd. De README documenteert ook instellingen voor telemetrie en een afzonderlijke telling van partnerevenementen. Optionele maskering staat standaard uit en kan waarden missen of verkeerd classificeren.

Verandert het wisselen van model de tools en machtigingen van de agent?
Niet vanzelf. De agent blijft verantwoordelijk voor zijn toolomgeving en machtigingsregels; ook de manier waarop het nieuwe model met die tools omgaat, moet worden gevalideerd.

Kan een abonnementslogin in elke client een API-sleutel vervangen?
Ga daar niet van uit. Technische ondersteuning voor inloggen, beschikbare modellen, accountrechten en toestemming van de aanbieder zijn verschillende zaken. Controleer de actuele voorwaarden en het beleid van je organisatie.

Welk product is het snelst of het veiligst?
Dat kan deze vergelijking niet vaststellen. Ze is gebaseerd op officiële documentatie en bevat geen onafhankelijke prestatietest, betrouwbaarheidsmeting of beveiligingsaudit.

Bronnen

Officiële bronnen geraadpleegd op 3 november 2026:

1. README van Magpie — gateway, agents, groepen, bibliotheek en privacygedrag.
2. README van CC Switch — verbindingsmodi, ondersteuning per agent, herstarts en opslag.
3. README van Claude Code Router — agentprofielen, routering, credentials en implementatie.
4. README van CLIProxyAPI — compatibele interfaces, accounts, bijbehorende software en afbakening van statistieken.
5. CCR-aanbiedersgids — upstreamprotocollen, aangepaste aanbieders, credentialpools en kosten van testverzoeken.