Claude Code router met Ollama of OpenRouter: zo doe je het, stap voor stap

Eerst kiezen

Claude Code met andere modellen: vier routes die op elkaar lijken

Zoek je op "claude code router", "claude code ollama" of "claude code openrouter", dan vind je vier opstellingen door elkaar. Ze doen technisch hetzelfde: Claude Code blijft het programma in je terminal, alleen het taalmodel erachter wisselt. Het verschil zit in waar dat model draait, wat het kost en wie je code te zien krijgt.

Hoe het onder de motorkap werkt

Claude Code stuurt elke vraag naar een webadres in het Anthropic Messages-formaat. Normaal is dat de server van Anthropic. Met ANTHROPIC_BASE_URL wijs je een ander adres aan, met ANTHROPIC_AUTH_TOKEN geef je de sleutel mee. Ollama (vanaf versie 0.14.0, januari 2026), OpenRouter en LM Studio spreken dat formaat zelf. Claude Code Router is een tussenstation op je eigen computer dat het vertaalt naar aanbieders die het niet spreken. Daarom is "Claude Code router" eigenlijk de naam van één tool, maar ook van het hele principe.

Wat Anthropic hierover zegt

De documentatie is duidelijk: Anthropic onderschrijft, onderhoudt en controleert geen gateways van derden, en ondersteunt het sturen van Claude Code naar niet-Claude-modellen niet. Het mag wel. De voorwaarden vragen dat je het programma zelf ongewijzigd laat, en dat doe je hier ook: je verandert alleen instellingen. Maar werkt een functie niet, dan helpt de support van Anthropic je niet verder. Zie Other LLM gateways.

Voorbereiding

Wat heb je nodig voor Claude Code met Ollama of OpenRouter?

Zet dit klaar voordat je begint. De grootste vertraging zit bij lokaal werken in het downloaden van een model van 14 GB of meer; start die download dus als eerste.

Je Claude-abonnement wordt overgeslagen, niet opgezegd

Ben je al ingelogd met een Claude-account, dan blijft die login bewaard maar ongebruikt zolang ANTHROPIC_AUTH_TOKEN gezet is. Haal je de variabele weg, dan werkt Claude Code weer met je abonnement. Je gebruik via Ollama of OpenRouter telt dus niet mee in je Claude-limieten. Wat Claude Code normaal kost, lees je op Wat kost Claude Code?.

Nog geen Claude Code?

Installeer het eerst. macOS, Linux en WSL: curl -fsSL https://claude.ai/install.sh | bash. Windows PowerShell: irm https://claude.ai/install.ps1 | iex. Alle opties en valkuilen staan in de installatiegids. Log nog niet in als je alleen met Ollama of OpenRouter wilt werken: zet eerst de variabelen uit de stappen hieronder.

Route 1 en 2

Claude Code met Ollama koppelen in zes stappen

Dit is de route voor wie lokaal wil werken. Ollama is een gratis programma dat open modellen op je eigen computer draait. Sinds januari 2026 heeft het een eigen opstartcommando voor Claude Code, waardoor je de variabelen niet zelf hoeft te zetten.

Ollama cloud: grote modellen zonder download

Modellen met :cloud in de naam draaien niet op je computer maar bij Ollama, altijd op hun volledige contextlengte. Ze zijn groter dan wat op een laptop past. Je hebt dan een Ollama-account nodig en start bijvoorbeeld met ollama launch claude --model gevolgd door een cloudmodel uit ollama.com/search?c=cloud. Ollama rekent af met tegoed: pay as you go zonder abonnement, of Pro voor $20 per maand met $60 tegoed. Let op: je code gaat dan wel de deur uit. Ollama host volgens de prijspagina vooral in de Verenigde Staten en kan voor extra capaciteit naar Europa routeren.

Liever LM Studio?

LM Studio werkt op dezelfde manier, alleen op poort 1234. Start de server in de app of met lms server start --port 1234, zet ANTHROPIC_BASE_URL=http://localhost:1234, ANTHROPIC_AUTH_TOKEN=lmstudio en CLAUDE_CODE_ATTRIBUTION_HEADER=0, en start met claude --model openai/gpt-oss-20b. LM Studio adviseert meer dan ongeveer 25.000 tokens context. Kies wat je al kent: beide doen voor Claude Code hetzelfde.

Wat Ollama niet doorgeeft

De Anthropic-koppeling van Ollama ondersteunt berichten, streaming, afbeeldingen, tools en thinking. Niet ondersteund zijn onder meer tokens tellen, prompt caching, PDF-bestanden en het afdwingen van een tool. Afbeeldingen werken alleen als base64, niet via een webadres. Merk je dat Claude Code een PDF niet kan lezen of dat de tokenteller niet klopt, dan ligt dat hieraan en niet aan jouw instellingen.

Route 3

Claude Code met OpenRouter koppelen in zes stappen

OpenRouter is een tussenpartij die meer dan 500 modellen van ruim 80 aanbieders achter één sleutel zet. Je kunt er Claude zelf mee gebruiken, betaald per token, of een ander model. Doe de privacystap vóór je eerste vraag, niet erna.

Het env-blok om te plakken

Vervang alleen de sleutel. Het lege ANTHROPIC_API_KEY is bewust: OpenRouter vraagt dat expliciet, zodat Claude Code niet rechtstreeks bij Anthropic probeert in te loggen.

{
"env": {
"ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
"ANTHROPIC_AUTH_TOKEN": "sk-or-jouw-sleutel",
"ANTHROPIC_API_KEY": ""
}
}

Claude via OpenRouter of een ander model via OpenRouter?

Dat is een groot verschil. Claude via OpenRouter werkt zoals je gewend bent, alleen betaal je per token in plaats van een vast abonnement. OpenRouter adviseert zelf om dan Anthropic als eerste aanbieder in te stellen, omdat Claude Code alleen daar gegarandeerd goed werkt. Een ander model via OpenRouter is goedkoper of gratis, maar OpenRouter waarschuwt dat Claude Code is afgestemd op Anthropic-modellen en met andere modellen niet altijd goed werkt. Wat Claude per token kost, staat op de API-pagina.

Meer weten over OpenRouter zelf?

Wat OpenRouter is, hoe het geld verdient en wat de overname door Stripe betekent, lees je in onze analyse van de overname.

Route 4

Claude Code Router installeren: zo werkt versie 3

Claude Code Router (CCR) is een open-source project van musistudio met een MIT-licentie en 37.896 sterren op GitHub (peildatum 28 oktober 2026). Het draait een kleine server op je computer die per verzoek kiest naar welke aanbieder het gaat. De laatste versie is 3.1.3 van 9 oktober 2026, en die werkt anders dan de meeste video's en blogs laten zien.

Waarom oude handleidingen niet meer kloppen

Veel tutorials tonen ccr code en een bestand config.json met een Router-blok. In de huidige CLI-documentatie staan die niet meer. Versie 3 bewaart de instellingen in config.sqlite in ~/.claude-code-router (Windows: %APPDATA%\claude-code-router) en start Claude Code via een profiel. Volg je een oude video en krijg je een onbekend commando, dan is dit de oorzaak.

Wanneer CCR wel en niet de moeite waard is

CCR loont als je meerdere aanbieders combineert: een goedkoop model voor eenvoudige taken, een sterker model voor lastige, en een reserve als een aanbieder plat ligt. Gebruik je maar één aanbieder, dan is CCR een extra onderdeel dat kan breken. Zet dan gewoon de twee variabelen uit de Ollama- of OpenRouter-route. Ollama staat niet tussen de voorinstellingen in de README; CCR ondersteunt wel eigen compatibele adressen.

Controle

Werkt het? Zo test je Claude Code met een ander model

Test twee dingen: of Claude Code echt met het andere adres praat, en of het model tools kan gebruiken. Het tweede is waar het bij lokale modellen meestal misgaat.

De eerste prompt om te plakken

Plak dit in Claude Code, in een testmap of een project met een eigen git-branch:

Bekijk de bestanden in deze map. Maak een nieuw bestand MODELTEST.md met drie regels: hoeveel bestanden je hebt gevonden, welke programmeertaal het meest voorkomt en één concreet verbeterpunt. Voer daarna git status uit en vertel me welke bestanden zijn gewijzigd. Wijzig verder niets.

Waar je op let

Een goed werkend model vraagt toestemming om een bestand te maken en een commando uit te voeren, maakt MODELTEST.md echt aan en noemt in zijn antwoord alleen dat ene bestand. Een model dat niet goed met tools overweg kan, toont in plaats daarvan een stuk JSON of een "ik zou nu dit commando uitvoeren" zonder iets te doen. Dan werkt de koppeling wel, maar is het model niet geschikt. Kies dan een ander model met tool-ondersteuning.

Vraag het model niet wie het is

Claude Code vertelt het model in zijn instructies dat het Claude Code is. Veel open modellen nemen dat over en zeggen dan dat ze Claude zijn. Dat bewijst dus niets. Vertrouw op /status en op het overzicht bij Ollama, OpenRouter of CCR.

Probleemoplossing

Claude Code met Ollama of OpenRouter werkt niet: meldingen en oplossingen

De meeste problemen vallen in drie groepen: de variabele komt niet aan, de sleutel klopt niet, of het model kan niet wat Claude Code vraagt. Zoek je melding in de eerste kolom.

Eerst testen buiten Claude Code

Twijfel je of het aan Claude Code of aan de server ligt? De documentatie van Anthropic geeft een curl-test die één klein verzoek rechtstreeks naar het adres stuurt. Krijg je JSON terug die begint met {"id":"msg_, dan werken adres en sleutel. Krijg je 401, dan klopt de sleutel of de variabele niet. Zo weet je binnen een minuut aan welke kant je moet zoeken.

Privacy en AVG

Claude Code lokaal draaien voor de AVG: wat blijft er echt op je computer?

Veel Nederlandse teams kijken naar Ollama omdat klantcode of persoonsgegevens de deur niet uit mogen. Met een lokaal model blijven je prompts en code op je computer. Claude Code zelf stuurt standaard nog wel een paar dingen naar buiten, en die zet je apart uit.

Het verkeer dat Claude Code zelf nog verstuurt

Claude Code stuurt standaard gebruiksstatistieken naar Anthropic en externe logdiensten. Volgens Anthropic zitten daar nooit je code, prompts of bestandspaden in. Zet CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC op 1 om dat en de versiechecks uit te zetten; dan werk je Claude Code wel zelf bij. De WebFetch-tool stuurt los daarvan de hostnaam van elke opgevraagde website naar api.anthropic.com voor een veiligheidscheck. Die zet je uit met "skipWebFetchPreflight": true in je settings.json, en beperk dan zelf welke sites Claude mag openen.

Je gesprekken staan als gewone tekst op je schijf

Claude Code bewaart sessies standaard 30 dagen onversleuteld in ~/.claude/projects, ook met een lokaal model. Staan er persoonsgegevens in, dan valt dat onder jouw bewaarbeleid. Pas de termijn aan met cleanupPeriodDays in je instellingen en zorg dat schijfversleuteling aan staat. Meer over wat Claude Code met je code doet, lees je op Claude Code en privacy en in het woordenboek bij AVG.

Lokaal is niet automatisch AVG-proof

Een lokaal model haalt een verwerker weg, maar de rest van je verantwoordelijkheid blijft. Werk met testdata of geanonimiseerde data waar dat kan, leg vast wie het mag gebruiken en op welke projecten, en bespreek het met je privacyverantwoordelijke voordat je echte klantgegevens gebruikt. Werk je in een Microsoft 365-omgeving met Intune of een ander beheersysteem, vraag dan eerst of je beheerder lokale AI-software toestaat.

Ons oordeel

Ons oordeel: wanneer Claude Code met een ander model zinvol is

Dit is onze blik als trainers die Claude Code met MKB-teams invoeren. Kort gezegd: met een ander model krijg je het gereedschap van Claude Code, maar niet het denkwerk van Claude. Dat is soms precies wat je wilt, en vaak niet.

Waar Claude Code met Ollama misgaat: verwachten dat je gratis Claude krijgt

De fout die we beginners het vaakst zien maken: ze lezen "Claude Code gratis met Ollama" en verwachten dezelfde resultaten als met Claude. Je krijgt de schil van Claude Code: de tools, de rechtenvragen, CLAUDE.md. Het denkwerk komt van een ander, meestal kleiner model. Op een laptop met 16 GB gaat een eenvoudige vraag over je code vaak goed, maar een taak die tien stappen vraagt, loopt vaker vast. Tweede klassieker: de contextlengte op 4.000 tokens laten staan. Dan lijkt het model dom, terwijl het simpelweg niet alles kan lezen.

Een MKB-voorbeeld

Stel: een webbureau van acht mensen onderhoudt maatwerk voor klanten met een geheimhoudingsclausule. De developers willen Claude Code, maar de directie wil eerst zeker weten dat klantcode niet extern verwerkt wordt. Een werkbare opzet is dan: Ollama op een werkplek met voldoende geheugen, gpt-oss of Qwen voor vragen als "leg deze functie uit" of "schrijf een eerste test", en het extra verkeer uitgezet. Voor nieuwe projecten zonder die clausule gebruikt het team Claude zelf. Zo leert iedereen dezelfde werkwijze, en kies je het model per project in plaats van voor het hele bedrijf.

Wat het kost, eerlijk vergeleken

Claude Pro kost vanuit Nederland €18 per maand, of €15 per maand bij jaarbetaling, exclusief btw (zie de abonnementen). Lokaal betaal je niets per vraag, maar een computer met genoeg geheugen voor een bruikbaar model is een flinke investering, en een langzaam model kost werktijd. OpenRouter is voordelig voor wie weinig gebruikt, maar een dag intensief bouwen met een sterk model kan meer kosten dan een maand Pro. Meet het daarom een week lang in het Activity-overzicht voordat je kiest.

Wanneer je het niet doet

Begin hier niet als je Claude Code nog nooit hebt gebruikt en gewoon wilt leren bouwen. Dan weet je bij een slecht resultaat niet of het aan jou, je prompt of het model ligt. Leer eerst de werkwijze met Claude zelf, bijvoorbeeld in onze Claude Code Masterclass, en wissel daarna bewust van model voor de projecten waar dat nodig is.

Vervolg

Wat nu? Volgende stappen met Claude Code

Werkt je koppeling? Dan zijn dit logische vervolgstappen. Ze werken met elk model, maar leveren het meest op met een model dat goed met tools omgaat.

Geef je project vaste regels mee

Een kleiner model heeft meer aan duidelijke regels dan Claude. Leg in een CLAUDE.md vast hoe je project werkt en wat het niet mag doen. Zie de CLAUDE.md-tutorial.

Laat Claude eerst plannen

Juist met een zwakker model loont het om eerst een plan te laten maken en dat te controleren voordat er iets verandert. Zie plan mode.

Werk vanuit je editor

Gebruik je VS Code, zet de variabelen dan in claudeCode.environmentVariables in je VS Code-gebruikersinstellingen; de extensie leest daar zijn login uit. De rest staat in de VS Code-tutorial.

Koppel externe tools

MCP-servers werken los van het model. Hoe je er een toevoegt, lees je in MCP-server toevoegen. Wat MCP is, staat bij MCP.

Liever een tool die voor elk model gebouwd is?

Aider is een open-source terminal-agent die van zichzelf met Ollama, OpenRouter en tientallen andere aanbieders werkt. Lees Aider en de juiste AI-CLI kiezen. Benieuwd naar open modellen die lokaal draaien? Zie onze analyse van Meta Muse Glimmer.

Terug naar Claude?

Haal ANTHROPIC_BASE_URL en ANTHROPIC_AUTH_TOKEN weg uit je shell en settings.json, start Claude Code opnieuw en log in met /login. Welke limieten dan gelden, lees je op Claude Code limieten.