OpenRouter gebruiken in Claude Code: Handleiding voor instelling

Met Claude Code kunnen ontwikkelaars rechtstreeks vanuit de terminal met AI werken, van het schrijven van code en het oplossen van fouten tot het begrijpen van onbekende codebases. OpenRouter biedt ontwikkelaars een andere manier om toegang te krijgen tot ondersteunde modellen via een uniforme API, waardoor het mogelijk wordt om te experimenteren met verschillende modellen zonder voor elke provider een afzonderlijke integratie te configureren.

Door OpenRouter te verbinden met Claude Code, kunt u verzoeken routeren via de API van OpenRouter, compatibele modellen selecteren en het gebruik beheren via uw OpenRouter-account. De instelling vereist een paar omgevingsvariabelen en een geldige API-sleutel, maar er zijn enkele belangrijke compatibiliteits- en authenticatiedetails om rekening mee te houden.

In deze handleiding leert u hoe u OpenRouter verbindt met Claude Code, modellen configureert, verifieert dat de integratie werkt, veelvoorkomende fouten oplost en begrijpt wanneer een gecentraliseerde AI Gateway beter kan passen bij organisatiebrede vereisten.

Wat is OpenRouter en waarom zou u het gebruiken met Claude Code?

OpenRouter is een API-platform dat toegang biedt tot modellen van meerdere providers via één uniforme interface. In plaats van afzonderlijk te integreren met elke provider, kunnen ontwikkelaars de API van OpenRouter gebruiken om ondersteunde modellen te ontdekken en te openen via een gemeenschappelijk eindpunt.

Wanneer gebruikt met Claude Code, fungeert OpenRouter als een tussenpersoon tussen de coderingsassistent en de geselecteerde modelprovider. In plaats van verzoeken rechtstreeks naar Anthropic te sturen, stuurt Claude Code ze naar OpenRouter, dat het verzoek afhandelt volgens het geconfigureerde model en de routeringsopties.

Deze opzet kan om verschillende redenen nuttig zijn:

• Toegang tot meerdere modellen: Experimenteer met ondersteunde modellen van verschillende providers zonder uw hele integratie opnieuw te bouwen.
• Eenvoudiger van model wisselen: Wijzig het geconfigureerde model wanneer u de outputkwaliteit, latentie of kosten wilt vergelijken.
• Gebruik een uniforme API: Beheer verzoeken aan ondersteunde modellen via een gemeenschappelijk API-eindpunt en authenticatiemechanisme.
• Gebruik en uitgaven bijhouden: Bekijk het gebruik en de kosten via de besturingselementen op accountniveau van OpenRouter, afhankelijk van de facturering en modelconfiguratie.

Er is één belangrijke kanttekening: niet elk model dat beschikbaar is via OpenRouter ondersteunt elke functionaliteit van Claude Code. Claude Code is ontworpen rond de API en het tool-gebruiksgedrag van Anthropic, dus de compatibiliteit kan variëren afhankelijk van het model en de functies die het ondersteunt.

OpenRouter is het meest nuttig wanneer u flexibiliteit wilt in modelselectie. Als uw primaire vereiste gecentraliseerde toegangscontrole, governance en observeerbaarheid in een engineeringorganisatie is, moet u mogelijk ook een enterprise AI Gateway evalueren.

Vereisten

Zorg ervoor dat u het volgende heeft voordat u OpenRouter verbindt met Claude Code:

• Claude Code geïnstalleerd: Installeer de CLI met behulp van de officiële installatiehandleiding.
• Een OpenRouter-account: Meld u aan bij OpenRouter en maak een API-sleutel aan in de sleutelinstellingen van uw account.
• Beschikbare credits of geconfigureerde facturering: Het gebruik van OpenRouter wordt gefactureerd volgens het geselecteerde model en de provider, dus controleer de prijzen van het model voordat u grote coderingssessies uitvoert.
• Terminaltoegang: U moet omgevingsvariabelen configureren in uw shell.

De onderstaande instelling gebruikt omgevingsvariabelen om de API-verzoeken van Claude Code om te leiden naar OpenRouter. U hoeft geen afzonderlijke proxyserver uit te voeren.

Hoe OpenRouter te verbinden met Claude Code

Volg deze stappen om Claude Code te verbinden met OpenRouter en te verifiëren dat uw verzoeken correct worden gerouteerd.

Stap 1: Genereer een OpenRouter API-sleutel

Meld u aan bij OpenRouter en navigeer naar uw API-sleutelinstellingen. Maak een nieuwe sleutel aan en kopieer deze naar een veilige locatie.

U gebruikt deze sleutel om verzoeken van Claude Code te authenticeren. Behandel het als een wachtwoord: deel het niet in het openbaar, voeg het niet toe aan een repository en neem het niet op in screenshots.

Stap 2: Configureer de omgevingsvariabelen

Claude Code ondersteunt aangepaste API-eindpunten via omgevingsvariabelen. OpenRouter biedt een met Anthropic compatibel API-eindpunt, zodat u Claude Code kunt configureren om verzoeken daarheen te sturen.

Open uw shell-configuratiebestand. Voor macOS- en Linux-gebruikers die Zsh gebruiken, is dit meestal ~/.zshrc; voor Bash is het meestal ~/.bashrc.

Voeg de volgende configuratie toe en vervang de tijdelijke aanduiding door uw werkelijke OpenRouter API-sleutel:

Dit is wat elke variabele doet:

• OPENROUTER_API_KEY slaat uw OpenRouter-referentie op.
• ANTHROPIC_BASE_URL stuurt Claude Code-verzoeken naar het API-eindpunt van OpenRouter.
• ANTHROPIC_AUTH_TOKEN levert de OpenRouter-sleutel voor authenticatie.
• ANTHROPIC_API_KEY="" wist expliciet de directe Anthropic API-sleutelvariabele om authenticatieconflicten te voorkomen.

Sla het bestand op en laad uw shell-configuratie opnieuw:

Als u Bash gebruikt, voert u in plaats daarvan source ~/.bashrc uit.

Belangrijk: Plaats deze variabelen niet in een gewoon .env-projectbestand in de veronderstelling dat Claude Code ze automatisch zal laden. De systeemeigen installer leest standaard .env-bestanden niet automatisch. Zorg er ook voor dat u uw API-sleutel niet vastlegt in een shell-configuratie of projectbestand.

Stap 3: Wis eventuele bestaande Anthropic-aanmeldingen

Als u zich eerder hebt aangemeld bij Claude Code met uw Anthropic-account, kan de opgeslagen aanmelding conflicteren met de nieuwe omgevingsvariabelen.

Open Claude Code en voer uit:

Verlaat vervolgens de sessie en start Claude Code opnieuw vanuit uw terminal. Als u zich niet eerder hebt aangemeld met een Anthropic-account, kunt u deze stap overslaan.

Stap 4: Start Claude Code

Navigeer naar het project waaraan u wilt werken en start Claude Code:

cd /path/to/your/project
claude

Vervang /path/to/your/project door uw werkelijke projectmap.

Claude Code moet nu verzoeken verzenden via OpenRouter met behulp van het geconfigureerde eindpunt en de API-sleutel.

Stap 5: Verifieer de verbinding

Voer in Claude Code het volgende uit:

/status

Controleer of de uitvoer de volgende configuratie toont:

Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://openrouter.ai/api

U kunt ook het OpenRouter Activity Dashboard openen en controleren of uw verzoeken verschijnen nadat u een prompt hebt verzonden.

Als de basis-URL of authenticatiemethode niet overeenkomt, laadt u uw shell-configuratie opnieuw en start u Claude Code opnieuw op. Als u nog steeds authenticatiefouten ziet, controleer dan op een opgeslagen Anthropic-aanmelding of een andere ANTHROPIC_API_KEY-definitie elders in uw omgeving.

Raadpleeg de officiële OpenRouter Claude Code-integratiehandleiding voor de nieuwste ondersteunde configuratie- en probleemoplossingsrichtlijnen.

Modellen configureren in Claude Code met OpenRouter

Zodra Claude Code is verbonden met OpenRouter, kunt u configureren welke modellen verschillende soorten werk afhandelen. Claude Code ondersteunt modelinstellingen voor Opus-, Sonnet- en Haiku-taken, zodat u verschillende modellen kunt kiezen voor complexe redeneringen, dagelijkse codering en lichtere bewerkingen.

Voor de meest betrouwbare ervaring begint u met Anthropic-modellen die beschikbaar zijn via OpenRouter. Claude Code is geoptimaliseerd voor het modelgedrag van Anthropic, en het gebruik van andere providers kan compatibiliteitsproblemen introduceren met functies zoals tool-gebruik of uitgebreide redenering.

Stap 1: Stel uw voorkeursmodellen in

Open uw shell-configuratiebestand, zoals ~/.zshrc, en voeg de volgende variabelen toe naast uw bestaande OpenRouter-configuratie:

Deze variabelen configureren het model dat wordt gebruikt voor elke klasse van taken:

VariabeleDoelANTHROPIC_DEFAULT_OPUS_MODELComplexe redeneringen en veeleisende coderingstakenANTHROPIC_DEFAULT_SONNET_MODELAlgemene codering, debugging en dagelijkse ontwikkelingANTHROPIC_DEFAULT_HAIKU_MODELSnellere, lichtere takenCLAUDE_CODE_SUBAGENT_MODELTaken gedelegeerd aan sub-agents

De ~anthropic/...-latest-aliassen verwijzen naar het nieuwste model in de overeenkomstige familie. Controleer de OpenRouter-modelcatalogus voor momenteel beschikbare modellen en hun prijzen.

Sla het bestand op en herlaad uw shell:

Start Claude Code opnieuw op om er zeker van te zijn dat de bijgewerkte configuratie is geladen.

Stap 2: Schakel over van model vanuit Claude Code

U kunt ook rechtstreeks vanuit een actieve Claude Code-sessie van model veranderen.

Voer uit:

Hiermee opent u de modelkiezer, waar u een beschikbaar model kunt selecteren. U kunt ook een model opgeven bij het starten van een sessie:

claude --model claude-sonnet-4-20250514

Vervang het voorbeeld door een model-id die wordt ondersteund door uw huidige Claude Code-versie en OpenRouter-configuratie. De modelkiezer en opdrachtregelopties kunnen zich anders gedragen, afhankelijk van hoe de gateway modelontdekking beschikbaar stelt, dus verifieer het geselecteerde model in plaats van aan te nemen dat elke OpenRouter-vermelding compatibel is.

Stap 3: Verifieer de modelselectie

Na het wisselen van model voert u uit:

Controleer vervolgens het model dat in de sessie wordt weergegeven en bekijk het OpenRouter Activity Dashboard om te bevestigen welk model het verzoek heeft afgehandeld.

Als een model mislukt, verifieert u de precieze ID, providerbeschikbaarheid en ondersteuning voor de vereiste API-functies van Claude Code. Een model dat in de catalogus van OpenRouter verschijnt, garandeert niet dat het zal werken met elke Claude Code-workflow.

Beste praktijk: Begin met een Anthropic-model via OpenRouter, bevestig dat uw normale coderings- en tool-gebruiksworkflows werken en test vervolgens alternatieve modellen op een kleine taak voordat u ze gebruikt voor grotere projecten.

Claude Code uitvoeren via een beheerde gateway

OpenRouter is nuttig als u een uniforme API wilt voor toegang tot modellen van verschillende providers. Voor individuele ontwikkelaars en kleine teams kan dat genoeg zijn om te experimenteren met modellen, te schakelen tussen ondersteunde opties en het gebruik via één account te monitoren.

Naarmate de adoptie van Claude Code groeit, kunnen organisaties echter besturingselementen nodig hebben die verder gaan dan modelselectie. Platformteams moeten mogelijk de toegang van ontwikkelaars beheren, een consistent beveiligingsbeleid toepassen, het gebruik toewijzen aan teams en audit-trails onderhouden voor alle AI-toepassingen.

TrueFoundry AI Gateway biedt een gecentraliseerde controlelaag voor Claude Code en andere AI-toepassingen, waarbij modeltoegang en routering worden gecombineerd met enterprise toegangsbeleid, kostenbeheersing, guardrails en observeerbaarheid.

Omdat Claude Code zijn modelroutering leest uit omgevingsvariabelen, is het richten op TrueFoundry dezelfde wijziging van twee regels die u al voor OpenRouter heeft gemaakt; u wisselt de basis-URL en het token:

Haal de basis-URL en modelnamen op uit het uniforme codefragment van de gateway Playground, voer claude "summarize this repo" uit en het verzoek verschijnt in AI Gateway → Analytics met het bijbehorende model, het aantal tokens en de kosten toegewezen aan uw sleutel. Dat laatste punt is waar het om draait.

Dit is wat u krijgt als Claude Code via ons wordt gerouteerd in plaats van een ruwe proxy:

• Kostentewijzing per gebruiker, geen gedeelde factuur. Elk verzoek wordt geregistreerd onder de ontwikkelaar die het heeft gedaan, met token-aantallen en uitgaven, zodat u budgetten per team kunt instellen en trends kunt zien in plaats van aan het einde van de maand een enkele ondoorzichtige factuur te moeten verifiëren.
• Eén OpenAI-compatibele API voor meer dan 1.000 LLM's. Hetzelfde eindpunt bereikt Anthropic, OpenAI, Bedrock, Vertex en zelfgehoste modellen, dus Claude Code zit niet vast aan één upstream, en u kunt van provider wisselen of providers toevoegen zonder de configuratie op elke machine opnieuw te bewerken.
• Fallbacks en routering zonder settings.json aan te raken. Richt Claude Code op een virtueel model en de gateway regelt de herhaalde pogingen en failover. Als een abonnementaccount midden in de sessie zijn snelheidslimiet bereikt, wordt het overschot automatisch omgeleid naar een account op basis van betaling per token, zodat de sessie niet simpelweg mislukt.
• Guardrails op prompts en tool-calls, niet alleen modelverzoeken. Met behulp van Claude Code-hooks kunnen prompt-inzendingen en tool-calls worden gevalideerd, geblokkeerd of herschreven in de client voordat ze de machine ooit verlaten - iets wat een pass-through router niet kan.
• Enterprise authenticatie en vlootbeheer. Verzoeken volgen dezelfde RBAC als de rest van het platform, en de gatewayconfiguratie kan op elke ontwikkelaarsmachine worden vergrendeld via MDM, zodat de modeltoegang centraal wordt beheerd in plaats van in een bestand te staan dat elke engineer kan bewerken.

De prestatie-impact voor dit alles is minimaal - de gateway voegt ~3–4 ms latentie toe en ondersteunt 350+ RPS op een enkele vCPU, dus de governance-laag is vrijwel onzichtbaar voor de persoon die in de terminal typt.

Zie de TrueFoundry Claude-integratiedocumentatie voor details over de implementatie.

Het verschil is niet dat OpenRouter geen governancefuncties heeft. De beslissing hangt eerder af van de vraag of de mogelijkheden en het implementatiemodel voldoen aan de vereisten van uw organisatie, dan wel of u een gateway nodig heeft die is geïntegreerd met uw bredere identiteits-, infrastructuur- en governance-architectuur.

Als u gecentraliseerde governance specifiek voor Claude Code evalueert, lees dan Claude Code Governance: How to Govern Agent Rollouts with an AI Gateway.

Het komt hierop neer: Gebruik OpenRouter wanneer uw prioriteit ligt bij gemakkelijke modeltoegang en experimenteren. Evalueer TrueFoundry AI Gateway wanneer u gecentraliseerd toegang beleid, kostenbeheersing, observeerbaarheid en enterprise implementatie-opties nodig heeft voor uw AI-infrastructuur.

Verken TrueFoundry AI Gateway om te leren hoe het in de AI-stack van uw organisatie kan passen.

Conclusie

OpenRouter maakt het mogelijk om Claude Code-verzoeken te routeren via een uniforme API en te experimenteren met ondersteunde modellen van verschillende providers. Door het API-eindpunt, de authenticatievariabelen en de modelinstellingen te configureren, kunnen ontwikkelaars aan de slag zonder voor elke provider een afzonderlijke integratie te bouwen.

Het belangrijke onderdeel is het verifiëren van de instellingen, het testen van de modelcompatibiliteit en het monitoren van het gebruik, in plaats van aan te nemen dat elk beschikbaar model even goed zal werken.

Voor individuele ontwikkeling en modelexperimenten is OpenRouter misschien alles wat u nodig heeft. Wanneer Claude Code onderdeel wordt van een grotere engineering-workflow, is TrueFoundry AI Gateway het evalueren waard voor gecentraliseerd toegangsbeleid, kostenbeheersing, guardrails, observeerbaarheid en enterprise uitrol-opties.

Verken TrueFoundry AI Gateway om te zien hoe gecentraliseerde AI-governance Claude Code kan ondersteunen naast de rest van uw AI-stack.

Veelgestelde vragen

1. Hoe kan ik TrueFoundry AI Gateway gebruiken met Claude Code?

U kunt Claude Code configureren om modelverzoeken te routeren via TrueFoundry AI Gateway door de gateway-URL, authenticatiegegevens en ondersteunde model-id's in te stellen in uw Claude Code-configuratie. Hiermee kunt u een vertrouwde Claude Code-workflow gebruiken terwijl ondersteunde verzoeken via een gecentraliseerde gateway worden gerouteerd.

Zie de TrueFoundry Claude-integratiehandleiding voor installatie-instructies.

2. Kan TrueFoundry AI Gateway helpen de kosten van Claude Code te beheersen?

Ja. TrueFoundry AI Gateway biedt inzicht in het gebruik en de kosten van ondersteunde verzoeken die via de gateway worden gerouteerd. Teams kunnen het gebruik toewijzen via metadata en budgetten en snelheidslimieten configureren om AI-uitgaven te beheren. De beschikbare zichtbaarheid hangt af van de gebruikte Claude-interface en authenticatiemethode.

3. Kan TrueFoundry AI Gateway toegangscontroles afdwingen voor Claude Code?

Ja. TrueFoundry ondersteunt gecentraliseerde authenticatie en op rollen gebaseerd toegangsbeleid voor beheerd modelverkeer. Dit helpt platformteams de toegang tot goedgekeurde modellen te beheren en een consistent beleid toe te passen op ontwikkelaars en toepassingen.

4. Ondersteunt TrueFoundry AI Gateway Claude Code-abonnementen?

TrueFoundry documenteert de doorgifte van abonnementen voor ondersteunde Claude Code-instellingen met behulp van in aanmerking komende Claude Team-, Pro- of Max-abonnementen. Het ondersteunt ook authenticatie via gateway-sleutels, ondersteund door geconfigureerde referenties van de modelprovider. Beschikbaarheid en gedrag hangen af van het abonnement en de configuratie.

Zie de Claude-integratiedocumentatie voor de ondersteunde authenticatie-opties.

5. Kan TrueFoundry AI Gateway guardrails toepassen op Claude Code?

TrueFoundry ondersteunt beleid voor het controleren, blokkeren of herschrijven van prompts en tool-calls in ondersteunde configuraties. Claude Code-hooks kunnen prompts en tool-call-activiteit via de gateway sturen voor beleidshandhaving, wat teams helpt om agent-workflows verder te beheren dan alleen basisselectie van modellen.

6. Kan TrueFoundry AI Gateway Claude Code-verzoeken en -gebruik bijhouden?

Ja. Voor ondersteund via de gateway gerouteerd verkeer biedt TrueFoundry observability op verzoekniveau, inclusief tokengebruik, latency, fouten en kosteninformatie. Op metadata gebaseerde opsplitsingen kunnen teams helpen om het gebruik over gebruikers, teams en applicaties heen te begrijpen.

7. Kan TrueFoundry AI Gateway Claude Code-verzoeken naar verschillende model providers routen?

TrueFoundry ondersteunt routing over geconfigureerde model providers, inclusief ondersteunde Anthropic, Amazon Bedrock en Google Vertex AI-integraties. De beschikbare modellen en authenticatiemethoden zijn afhankelijk van uw modelaccounts en gateway-configuratie.