Claude Code-provider wisselen: een CC Switch-tutorial in 5 minuten

Deze tutorial is gebaseerd op CC Switch v4.0.26 (november 2026). Knoplabels kunnen in latere versies veranderen; het configuratiemodel blijft hetzelfde.

Claude Code tussen aanbieders wisselen betekent meestal dat je ~/.claude/settings.json bewerkt: de basis-URL, de API-sleutel en soms het model. Met één aanbieder is dat te doen. Met twee of drie wordt het een klein onderhoudsklusje — en de fout blijft vaak onopgemerkt, omdat een verouderde ANTHROPIC_*-variabele in je shell de waarden kan overschrijven van het bestand dat je net hebt bewerkt.

Met CC Switch wordt wisselen een kwestie van op een kaart klikken. De ingebouwde AiHubMix-preset vult het eindpunt in; jij hoeft alleen een API-sleutel te plakken. Claude Code laadt de wijziging meestal opnieuw zonder opnieuw op te starten. In deze tutorial doorlopen we de volledige configuratie en leggen we daarna uit wat CC Switch wegschrijft, welke valkuil er is met omgevingsvariabelen en wanneer de directe modus volstaat.

Wil je alleen de korte versie? Installeer CC Switch, maak een AIHubMix-sleutel aan, kies de AiHubMix-preset onder Claude Code, plak de sleutel, voeg ANTHROPIC_MODEL=claude-sonnet-5-5 toe aan de aanbieder, klik op Wisselen en voer claude -p "1+1, output only the answer" --model claude-sonnet-5-5 uit. De rest van dit artikel geeft meer uitleg bij die stappen.

Wat is CC Switch?

CC Switch is een open-source desktopapp (MIT, Tauri + Rust + React) waarmee je aanbiederconfiguraties beheert voor Claude Code, Codex, Gemini CLI, OpenCode en andere programmeertools. De app bevat meer dan 90 presets voor aanbieders en ondersteunt aangepaste aanbieders.

Het is meer dan alleen een manier om van API-sleutel te wisselen:

• Directe modus past de sleutelvelden in het configuratiebestand van de client aan, waarna de client rechtstreeks met de aanbieder communiceert.
• Routeringsmodus start een lokale gateway op 127.0.0.1:15721, met conversie tussen API-indelingen, failover, statuscontroles en verzoeklogboeken.
• Aggregatiemodus voegt modellen van meerdere aanbieders samen in één lijst met /model-modellen.

Je vindt de repository en de gebruikershandleiding op github.com/farion1231/cc-switch. Alleen ccswitch.io en de GitHub Releases-pagina zijn officiële downloadbronnen; websites die om betaling of accountgegevens vragen, zijn dat niet.

Voordat je begint

Je hebt drie dingen nodig:

• Claude Code moet zijn geïnstalleerd en vanuit een terminal kunnen worden gestart. Controleer dit met claude --version. Ontbreekt het programma, gebruik dan het officiële installatieprogramma: curl -fsSL https://claude.ai/install.sh | bash, of npm i -g @anthropic-ai/claude-code met Node.js 22 of hoger.
• Een AIHubMix-account en API-sleutel. Maak die aan in de AIHubMix-console. De sleutel begint meestal met sk-.
• Een installatieprogramma voor CC Switch. Download het via ccswitch.io of GitHub Releases.

Stap 1: CC Switch installeren

Bij de eerste start importeert CC Switch de bestaande Claude Code-configuratie als aanbieder met de naam default en voegt het een officiële aanbieder toe. Je oorspronkelijke configuratie gaat niet verloren; je kunt op elk moment terugschakelen.

Als Claude Code nog niet is geïnstalleerd, kun je het installeren of bijwerken via de pagina Apps in CC Switch.

Stap 2: Een AIHubMix API-sleutel aanmaken

Open de pagina met AIHubMix API-sleutels, maak een sleutel aan en kopieer die.

De tijdelijke aanduiding AIHUBMIX_API_KEY in de documentatie is geen echte sleutel. Als je die letterlijk plakt, mislukt het verzoek met 401 invalid key: AIHUBMIX_API_KEY.

Stap 3: AIHubMix toevoegen aan Claude Code

1. Selecteer Claude Code in de linkerzijbalk.
2. Klik rechtsboven op de knop +.
3. Zoek naar AiHubMix of zoek het onder de categorie platforms van derden.
4. De naam en het eindpunt worden automatisch ingevuld: https://aihubmix.com. Plak je sleutel bij API-sleutel.
5. Klik op Toevoegen.

De preset slaat twee omgevingsvariabelen op:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com"
  }
}

De preset stelt geen model in. In de handleiding van AIHubMix wordt ANTHROPIC_MODEL als een essentiële variabele beschouwd. Voeg die daarom vóór het wisselen toe aan hetzelfde env-blok:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}

Zonder model verstuurt Claude Code de standaardmodel-ID die het zelf gebruikt; mogelijk wordt dat model niet door AIHubMix aangeboden.

Er zijn twee details die je moet weten.

Voeg geen /v1 toe aan de basis-URL. Claude Code gebruikt het Anthropic Messages-protocol en stelt het verzoekpad zelf samen. https://aihubmix.com is correct; https://aihubmix.com/v1 is de OpenAI-compatibele basis-URL voor andere clients, waaraan Claude Code zelf /v1/messages zou toevoegen.

De preset gebruikt ANTHROPIC_API_KEY, terwijl de eigen Claude Code-handleiding van AIHubMix ANTHROPIC_AUTH_TOKEN gebruikt. AIHubMix accepteert beide: ANTHROPIC_AUTH_TOKEN verstuurt een Bearer-header en ANTHROPIC_API_KEY verstuurt x-api-key. Kies er één. Vul ze niet allebei in met verschillende waarden. De configuratiedetails, model-ID's en foutreferentie van AIHubMix vind je in de AIHubMix-documentatie voor Claude Code.

Ontbreekt de preset — bijvoorbeeld in een oudere versie of nadat je de kaart hebt verwijderd — kies dan Aangepaste configuratie en plak de bovenstaande JSON. Met de eindpuntbeheerder van de aanbiederskaart kun je de latentie testen; de preset bevat ook https://api.aihubmix.com als alternatief eindpunt als aihubmix.com niet kan worden gevonden.

Stap 4: Wisselen en controleren

Klik op het tabblad Direct op Wisselen op de AiHubMix-kaart. Zodra de configuratie is weggeschreven, verandert de knop in In gebruik.

Claude Code laadt de configuratie automatisch opnieuw; opnieuw opstarten is doorgaans niet nodig. Blijft de huidige sessie de oude aanbieder gebruiken, sluit Claude Code dan af en start het opnieuw.

Controleer de volledige verbinding:

claude -p "1+1, output only the answer" --model claude-sonnet-5-5

Een antwoord van 2 betekent dat het verzoek AIHubMix heeft bereikt. In een interactieve sessie hoort bij de regel Anthropic base URL in /status https://aihubmix.com te staan.

Gebruik voor snelle wijzigingen het systeemvak: klik met de rechtermuisknop op het CC Switch-pictogram, open het submenu Claude Code en klik op een aanbieder. De titel van het submenu toont de actieve aanbieder en een saldo-overzicht.

Wil je terug naar de officiële aanbieder, schakel dan over naar Claude Official, start Claude Code opnieuw en doorloop de aanmeldprocedure.

Wat er precies verandert bij het wisselen

In de directe modus vervangt CC Switch alleen de verbindings- en compatibiliteitsvelden in ~/.claude/settings.json: ANTHROPIC_*, AWS_*, protocolselectoren zoals CLAUDE_CODE_USE_BEDROCK, model, apiKeyHelper en enkele aanbiedergebonden compatibiliteitsopties zoals CLAUDE_CODE_DISABLE_ARTIFACT en het contextvenster.

permissions, hooks, enabledPlugins, statusLine, de MCP-configuratie, opmerkingen en alles wat je verder hebt toegevoegd, blijven behouden. De volledige lijst staat in de referentie voor configuratiebestanden.

Voordat CC Switch de configuratie van een tool voor het eerst herschrijft, maakt het een back-up van het origineel in ~/.cc-switch/backups/live-first-write/. Als de JSON ongeldig is, weigert CC Switch het bestand weg te schrijven, meldt het de regel en kolom en laat het bestand ongewijzigd.

De valkuil: verouderde ANTHROPIC_*-variabelen

Dit is de storing waardoor het lijkt alsof CC Switch niet heeft gewerkt.

Heb je eerder een handmatige installatiehandleiding gevolgd en export ANTHROPIC_BASE_URL=... of export ANTHROPIC_AUTH_TOKEN=... toegevoegd aan ~/.zshrc of ~/.bash_profile, dan kunnen die variabelen de waarden overschrijven die CC Switch wegschrijft. Je schakelt de kaart over naar AIHubMix, maar verzoeken gaan nog steeds naar het oude eindpunt.

CC Switch detecteert het conflict. Een gele banner bovenaan het venster waarschuwt dat omgevingsvariabelen je configuratie mogelijk overschrijven; de details tonen de variabelenaam, de waarde en de bron. Met Geselecteerde verwijderen verwijder je ze; eerst wordt er een back-up gemaakt in ~/.cc-switch/backups/env-backup-<timestamp>.json.

Handmatig controleren:

grep -n "ANTHROPIC" ~/.zshrc ~/.bash_profile 2>/dev/null

Zet de oude exportregels in commentaar en voer daarna source ~/.zshrc uit of open een nieuwe terminal. In de eigen documentatie van AIHubMix wordt aanbevolen om globale ANTHROPIC_*-variabelen te verwijderen wanneer CC Switch de configuratie beheert. De volledige procedure voor conflicten staat in de referentie voor omgevingsvariabelen.

Modelaliassen en wisselen

Als ANTHROPIC_MODEL is ingesteld, gebruikt Claude Code standaard Sonnet 5.5. De /model-aliassen (opus, sonnet, haiku, fable) moeten nog steeds worden gekoppeld als je wilt dat ze naar de model-ID's van AIHubMix verwijzen. Voeg deze sleutels toe binnen env:

De volledige configuratie van de aanbieder ziet er dan zo uit:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1"
  }
}

De prioriteit voor modelselectie, van hoog naar laag: /model <name> → claude --model <name> → ANTHROPIC_MODEL → het veld model in settings.json. Kopieer model-ID's uit de AIHubMix-modellenlijst; er wordt onderscheid gemaakt tussen hoofdletters en kleine letters.

Wanneer je routering of aggregatie gebruikt

De directe modus is de beste standaardkeuze voor AIHubMix. Het eindpunt gebruikt al Anthropic Messages, dus protocolconversie is niet nodig.

Gebruik routering als je een failoverwachtrij wilt of een aanbieder met OpenAI-indeling via Claude Code wilt gebruiken. Routering laat Claude Code verbinding maken met http://127.0.0.1:15721, vervangt de sleutel in de configuratie door PROXY_MANAGED en voegt de echte sleutel toe vanuit CC Switch. De app moet actief blijven; als je CC Switch afsluit, wordt de directe configuratie teruggeschreven. Officiële Claude-abonnementen lopen niet via routering; gebruik daarvoor de directe modus.

Gebruik aggregatie wanneer je modellen van meerdere aanbieders in één lijst met /model wilt. De standaardaanbieder verwerkt verzoeken zonder prefix; modellen van andere aanbieders verschijnen met de prefix ccs-. Aggregatie biedt geen failover. Deze functie is alleen beschikbaar voor Claude Code en Codex; Claude-abonnementen bij de officiële aanbieder worden niet ondersteund in de aggregatiemodus. Voor de modellenlijst met ccs- is Claude Code 2.1.243 of nieuwer vereist. Claude Code neemt wijzigingen in de modellenlijst direct over; Codex moet volledig opnieuw worden gestart.

Wat CC Switch nog meer beheert

• Gebruik: het dashboard combineert logboeken van gerouteerde verzoeken met lokale sessielogboeken. Sessies kunnen ook zonder routering worden gescand; de kosten worden berekend op basis van het model dat in het logboek staat. Gerouteerde verzoeken worden apart gelogd.
• MCP: één centraal paneel voor MCP-servers, gesynchroniseerd met de apps die je selecteert.
• Skills: ontdek, installeer en verwijder skills op één plek.
• Sessies: zoek, bekijk, exporteer en hervat lokale sessies.
• Projecten: sla de aanbieder, MCP-servers, skills en geheugenbestanden van een project op als momentopname en schakel vervolgens per project tussen complete sets.

De gegevens staan in ~/.cc-switch/, met een SQLite-database als kern. Automatische back-ups bewaren standaard de 10 meest recente; synchronisatie via WebDAV of S3-compatibele opslag is ook beschikbaar. De database en geëxporteerde back-ups bevatten aanbiedersconfiguraties, inclusief sleutels. Behandel ze dus als geheimen.

Problemen oplossen

De onderstaande foutmeldingen zijn overgenomen uit de Claude Code-documentatie van AIHubMix.

Bij andere problemen:

• Inlogscherm of Not logged in: controleer /status; schakel onder Settings → App config → Claude Code de optie Skip Claude Code first-run confirmation in; start opnieuw op en controleer of de sleutel is ingevuld.
• De schakelaar heeft geen effect: er staat mogelijk een verouderde shellvariabele of sessiecache. Open een nieuwe terminal of start Claude Code opnieuw.
• De verbindingstest op de kaart slaagt, maar verzoeken mislukken: de test controleert de bereikbaarheid, niet de sleutel of het model. Voer de end-to-endopdracht claude -p uit.
• Je wilt terug naar de officiële aanbieder: schakel over naar Claude Official, start Claude Code opnieuw en log weer in.

Als de opdracht claude op macOS niet wordt gevonden, plaatst het officiële installatieprogramma deze meestal in ~/.local/bin/claude. Voeg export PATH="$HOME/.local/bin:$PATH" toe aan je shellprofiel en open een nieuwe terminal.

Checklist

• [ ] Installeer CC Switch via ccswitch.io of GitHub Releases.
• [ ] Maak een API-sleutel aan in de AIHubMix-console.
• [ ] Ga in Claude Code naar + → AiHubMix → plak de sleutel → Add.
• [ ] Voeg ANTHROPIC_MODEL=claude-sonnet-5-5 toe aan de JSON-configuratie van de aanbieder.
• [ ] Klik op Switch en controleer of op de kaart In use staat.
• [ ] Verwijder verouderde ANTHROPIC_*-exports uit je shellprofiel.
• [ ] Voer claude -p "1+1, output only the answer" --model claude-sonnet-5-5 uit en controleer of je 2 krijgt.

Als de laatste opdracht 2 oplevert, is de overstap naar de andere aanbieder voltooid. Daarna hoef je alleen nog eventuele modelaliassen toe te voegen en te bepalen of je routering of aggregatie nodig hebt. Voor de meeste AIHubMix-gebruikers volstaat de directe modus.

Veelgestelde vragen

Is CC Switch gratis?
Ja. Het is open source onder de MIT-licentie. Je betaalt alleen voor de aanbieder waarvan je de API gebruikt.

Verwijdert het omschakelen mijn hooks, MCP-servers of plug-ins?
Nee. Direct omschakelen vervangt het eindpunt, de sleutel, het model en enkele opties die specifiek zijn voor de aanbieder. Hooks, machtigingen, MCP-servers, plug-ins en instellingen voor de statusregel blijven in het bestand staan.

Uploadt CC Switch mijn API-sleutel?
Aanbiedersconfiguraties worden lokaal opgeslagen in ~/.cc-switch/cc-switch.db. Als je WebDAV- of S3-synchronisatie inschakelt, worden ze gesynchroniseerd met opslag die je zelf beheert. Databases en back-ups bevatten sleutels; behandel ze dus als geheimen.

Moet CC Switch actief blijven?
Niet in de directe modus. Routering en aggregatie vereisen dat de app actief is; als je CC Switch afsluit, schakelt de client terug naar de directe modus.

Kan ik Claude Official en AIHubMix tegelijk gebruiken?
In de directe modus kan er maar één aanbieder tegelijk actief zijn. Met aggregatie kun je modellen van meerdere aanbieders in één lijst zetten, maar Claude-abonnementen bij de officiële aanbieder worden daar niet ondersteund. Schakel terug naar de directe modus om die te gebruiken.

Werkt het op Windows?
Ja. CC Switch ondersteunt Windows 10 en hoger en is beschikbaar als .msi-installatieprogramma of draagbare versie. Voor Linux is glibc 2.35+ en WebKitGTK 4.1 vereist.

Waarom geeft de aanbiederskaart aan dat de verbinding goed is, terwijl Claude Code nog steeds fouten geeft?
De verbindingstest van de kaart controleert of het eindpunt bereikbaar is. De test valideert de API-sleutel of het model niet. Gebruik de end-to-endopdracht claude -p om het volledige traject te testen.

Bronnen

• CC Switch-repository
• CC Switch-gebruikershandleiding: aanbieder toevoegen
• CC Switch-gebruikershandleiding: van aanbieder wisselen
• CC Switch-gebruikershandleiding: configuratiebestanden
• AIHubMix-documentatie: Claude Code