Claude Code Proxy: Routeer Claude, GPT-5 & Gemini Via TrueFoundry AI Gateway

Introductie

Claude Code is de krachtigste AI-coderingsassistent die vandaag beschikbaar is. Engineers die het in gebruik nemen, gaan zelden nog terug. Maar wanneer tientallen of honderden engineers het tegelijkertijd beginnen te gebruiken, doet zich een nieuw probleem voor: Claude Code communiceert standaard rechtstreeks met de API van Anthropic. Elke ontwikkelaar authenticeert zich met zijn eigen sleutel, gebruikt uitsluitend Anthropic-modellen en genereert API-uitgaven die volledig onzichtbaar zijn voor het platformteam totdat de maandelijkse factuur binnenkomt.

Een Claude Code proxy is de oplossing. Door Claude Code te verwijzen naar een proxy-eindpunt in plaats van rechtstreeks naar Anthropic, krijgt u een gecentraliseerd controlepunt voor elke modelaanroep in uw gehele engineeringorganisatie: inzicht in wie wat uitgeeft, de mogelijkheid om budgetlimieten af te dwingen voordat ze worden overschreden, toegang tot modellen van elke provider - GPT-5, Gemini 2.5 Pro, Llama via Bedrock - via dezelfde interface die Claude Code al kent, en de mogelijkheid om gateway-configuraties één keer te implementeren en toe te passen op alle ontwikkelaars zonder individuele machines aan te raken.

TrueFoundry AI Gateway is de Claude Code proxy op enterprise-niveau. Het is een drop-in Anthropic-compatibel eindpunt waarmee Claude Code verbindt via een enkele omgevingsvariabele-wijziging. Eenmaal verbonden, stroomt elke Claude Code-aanvraag door de gateway, wat u observabiliteit, kostenbeheersing, multi-model routing en enterprise-beveiligingsbeleid biedt dat geldt voor de gehele organisatie, niet alleen voor de ontwikkelaars die eraan denken om het te configureren.

Deze gids legt precies uit wat een Claude Code proxy doet, waarom TrueFoundry AI Gateway de juiste keuze is voor enterprise engineering-teams, en hoe u deze configureert, inclusief voor zowel standaard API-sleutel- als Claude Max-abonnementsflows.

Wat is een Claude Code Proxy?

Claude Code wordt geleverd met één enkele configuratieknop om de backend te wijzigen: de omgevingsvariabele ANTHROPIC_BASE_URL. Wanneer deze is ingesteld, stuurt Claude Code al zijn API-aanvragen - berichten, modelaanroepen, streaming-antwoorden naar die URL in plaats van naar https://api.anthropic.com.

Die ene variabele is het fundament van elke Claude Code proxy. Een proxy is elke server die:

1. API-aanvragen in Anthropic-indeling van Claude Code accepteert
2. Controles, routing of observabiliteit toevoegt op de proxylaag
3. Aanvragen doorstuurt naar de daadwerkelijke modelprovider (Anthropic, OpenAI, Google, Bedrock, on-prem)
4. Antwoorden terugstuurt naar Claude Code in de indeling die het verwacht

De eenvoudigst mogelijke proxy is een reverse proxy met logging. De meest geavanceerde is een enterprise AI gateway die authenticatie, budgethandhaving, modelrouting over providers, semantische caching, guardrails en volledige audit-trails afhandelt - alles transparant, zonder wijzigingen in hoe Claude Code werkt voor de ontwikkelaar.

Waarom bouwen of gebruiken teams een Claude Code proxy?

• Kostenbeheersing: Meerdere ontwikkelaars die Claude Code gebruiken met individuele Anthropic-sleutels genereren uitgaven die pas aan het einde van de maand zichtbaar zijn. Een proxy onderschept elke aanvraag en dwingt dagelijkse limieten per ontwikkelaar af voordat de kosten het budget overschrijden.
• Multi-model toegang: De interface van Claude Code is krachtig, maar Claude-modellen zijn niet altijd de beste of meest kosteneffectieve keuze voor elke taak. Met een proxy kunt u taken op haiku-niveau routeren naar GPT-4o-mini of Gemini Flash, en taken op opus-niveau naar het beste beschikbare model zonder client-side wijzigingen.
• Enterprise-beveiliging: Directe API-sleutels op laptops van ontwikkelaars vormen een beveiligingsrisico. Een proxy centraliseert inloggegevens: ontwikkelaars authenticeren bij de proxy en de proxy beheert de provider-sleutels. Er hoeft nooit meer een Anthropic-sleutel op een machine van een ontwikkelaar te staan.
• Organisatiebrede governance: Individuele ontwikkelaars kunnen hun eigen ANTHROPIC_BASE_URL configureren. Maar om dit af te dwingen voor een heel team is een gecentraliseerd implementatiemechanisme nodig - MDM, door de server beheerde instellingen of een gedeelde project-.claude/settings.json die is opgenomen in versiebeheer.

Waarom TrueFoundry AI Gateway de Juiste Claude Code Proxy Is

Er zijn drie manieren om een proxy op te zetten voor Claude Code: bouw uw eigen proxy, gebruik een eenvoudige reverse proxy, of gebruik een speciaal gebouwde AI gateway. Uw eigen proxy bouwen betekent dat u verantwoordelijk bent voor het onderhoud, de beveiliging en de betrouwbaarheid van een productie API gateway. Een eenvoudige reverse proxy voegt logging toe, maar geen van de beheerelementen. TrueFoundry AI Gateway geeft u alles wat een enterprise engineering-team daadwerkelijk nodig heeft, zonder het zelf te hoeven bouwen of onderhouden.

TrueFoundry AI Gateway is een uniforme proxylaag tussen Claude Code en uw modelproviders. Het accepteert dezelfde Anthropic API-indeling die Claude Code al spreekt, dus Claude Code merkt niet eens dat het met een gateway communiceert in plaats van rechtstreeks met Anthropic. Achter de gateway kunt u elke provider verbinden: Anthropic direct, AWS Bedrock, Google Vertex AI, Azure OpenAI, OpenAI of uw eigen on-prem modellen.

Dit is wat Claude Code daadwerkelijk ziet:

Elke Claude Code-aanvraag die door TrueFoundry stroomt, krijgt automatisch:

~3–4ms p95 gateway overhead, 350+ RPS op een enkele vCPU. Gezien de responstijden van Claude Code (seconden, geen milliseconden), voegt de gateway geen merkbare latentie toe.

Stap 1: Wijs Claude Code naar TrueFoundry AI Gateway

De kernconfiguratie bestaat uit een enkele omgevingsvariabele:

Voor een permanente configuratie - wat u wilt voor productiegebruik - bewerkt u de settings.json van Claude Code. Twee paden worden ondersteund:

• Globaal (geldt voor alle projecten): ~/.claude/settings.json
• Projectspecifiek (opgenomen in versiebeheer): .claude/settings.json in uw projectmap

Standaard API-sleutel-configuratie

Gebruik dit wanneer ontwikkelaars zich authenticeren met een TrueFoundry API-sleutel (het aanbevolen enterprise-patroon — geen Anthropic-sleutels op ontwikkelaarsmachines):‍

Wat elk veld doet:

• ANTHROPIC_BASE_URL — omleiden van alle Claude Code-aanvragen naar TrueFoundry
• ANTHROPIC_AUTH_TOKEN — TrueFoundry API-sleutel; authenticeert de ontwikkelaar bij de gateway (vervangt de Anthropic API-sleutel)
• ANTHROPIC_MODEL — het standaardmodel voor Claude Code-sessies
• ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL — koppelt de ingebouwde model-aliassen van Claude Code (/model opus, /model sonnet, /model haiku) aan uw geconfigureerde TrueFoundry-modellen
• CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS — schakelt experimentele Claude Code-functies uit voor stabiel gateway-gedrag
• ANTHROPIC_CUSTOM_HEADERS — stuur de x-tfy-anthropic-beta-header door naar Anthropic voor beta-functies zoals contextbeheer

Belangrijk: Claude Code detecteert modelmogelijkheden (extended thinking, ToolSearch, beta tool blocks) door de model-ID te vergelijken via string-matching. Zorg ervoor dat ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL en ANTHROPIC_DEFAULT_HAIKU_MODEL een herkenbare Anthropic model-ID bevatten zoals claude-opus-4-7, claude-sonnet-4-6 of claude-haiku-4-5. Als u een TrueFoundry Virtual Model gebruikt, zorg er dan voor dat de weergavenaam de onderliggende model-ID bevat - bijv. your-account/claude-haiku-4-5 — zodat de string-matching slaagt.

Claude Code Max Abonnementsconfiguratie

Als uw team Claude Code Max-abonnementen gebruikt, reserveert Claude Code de Authorization-header voor Anthropic-accountauthenticatie. Gebruik in dat geval x-tfy-api-key in ANTHROPIC_CUSTOM_HEADERS:‍

Waarom dit patroon goed is voor Max-gebruikers:

• U behoudt uw Anthropic Max-abonnement voor de sessie-auth van Claude Code - de Authorization-header stroomt ongewijzigd door naar Anthropic
• TrueFoundry authenticeert afzonderlijk via x-tfy-api-key - de gateway beheert de aanvraag terwijl Anthropic de facturering afhandelt via uw abonnement
• U krijgt gecentraliseerde governance (zichtbaarheid, quota, RBAC, logs, guardrails) zonder uw dagelijkse Claude Code-workflow te wijzigen

Zie de TrueFoundry Claude Code documentatie voor de volledige integratiegids, en de Claude Code Max integratie voor de variant met een Max-abonnement.

Stap 2: Gebruik GPT-5, Gemini en Elk Ander Model Via Claude Code

Dit is waar een Claude Code proxy verandert van handig naar transformerend. Zodra Claude Code via TrueFoundry routeert, kan het elk model van elke provider bereiken, niet alleen van Anthropic. U voegt provider-accounts toe in het TrueFoundry gateway-dashboard (OpenAI, Google Vertex AI, AWS Bedrock, Azure OpenAI, xAI, of uw eigen on-prem-implementatie), en die modellen worden beschikbaar via hetzelfde gateway-eindpunt.

Claude Code Aliases Verwijzen naar Niet-Anthropic Modellen

Om GPT-5 te gebruiken voor het "opus"-slot van Claude Code (uw krachtigste model-tier), werkt u simpelweg de model-alias bij:

In deze configuratie:

• /model opus → GPT-5 (voor complexe architectuur- en plannings-taken)
• /model sonnet → Claude Sonnet 4 (voor standaard coderingstaken)
• /model haiku → Gemini 2.5 Flash (voor snelle, lichte taken zoals e-mailvalidatie, snelle opzoekingen)

De ontwikkelaarservaring is identiek. Ontwikkelaars gebruiken nog steeds /model opus of --model haiku. Ze hoeven niet te weten welke provider achter elke alias zit, of inloggegevens voor OpenAI of Google te beheren.

Virtuele Modellen Gebruiken voor Geavanceerde Routing

Met TrueFoundry's Virtual Models kunt u één enkele model-ID maken die aanvragen over meerdere providers routeert op basis van gewicht, prioriteit of latentie. Verwijs een Claude Code model-alias naar een virtueel model, en de gateway handelt de routinglogica transparant af.

Voorbeeld: Priority-based fallback over verschillende providers

Als uw primaire Anthropic-account rate limits bereikt, valt u automatisch terug op Bedrock Claude, en vervolgens op GPT-4 - zonder dat een ontwikkelaar hier iets van merkt:

Voorbeeld: Weight-based A/B-evaluatie

Test een nieuw model als canary op 10% van het Claude Code-verkeer voordat u het hele team overzet:‍


Wijs vervolgens de sonnet-alias van Claude Code naar dit virtuele model. 10% van de Claude Code sonnet-aanvragen gaat naar GPT-5 met volledige kosten- en kwaliteitsmetrieken in het gateway-dashboard om de resultaten te vergelijken.

Stap 3: Enterprise Controles Die Gelden voor Elke Claude Code-Aanvraag

Zodra Claude Code via TrueFoundry routeert, erft elke aanvraag automatisch enterprise-grade governance — niet omdat ontwikkelaars het configureren, maar omdat het wordt afgedwongen op de gateway-laag.

Budgetlimieten: Voorkom Kostenoverschrijdingen Voordat Ze Plaatsvinden

TrueFoundry's hiërarchische budgetbeheer grijpt in voordat de token wordt verbruikt, niet pas nadat de maandelijkse factuur binnenkomt. Regels stapelen en combineren:

Senior engineers krijgen $50/dag. Alle anderen krijgen standaard $10/dag. En de totale Opus-uitgaven binnen de gehele organisatie zijn gemaximeerd op $1000/maand — dus zelfs als elke ontwikkelaar binnen zijn persoonlijke limiet blijft, kan het modelbudget op organisatieniveau niet worden overschreden.

Rate Limiting: Bescherm On-Prem en Controle-Omgevingen

Rate limiting op het gateway-niveau behandelt drie specifieke Claude Code-scenario's:

• CI-pipelines: Claude Code-uitvoeringen in CI moeten onafhankelijk van interactieve ontwikkelaarsessies worden gelimiteerd. Een testsuite die Claude Code aanroept voor code reviews mag niet hetzelfde quota verbruiken als de actieve coderingssessie van een ontwikkelaar.
• Ontwikkel- vs. productiemodellen: Met op metadata afgestemde rate limits kunt u aanvragen met environment: dev naar een goedkoper model routeren en de frequentie beperken — zonder de productie te beïnvloeden.
• Bescherming van on-prem GPU's: Als u on-prem modellen gebruikt als primaire doel voor Claude Code, kunt u het on-prem eindpunt limiteren en automatisch uitwijken naar de cloud-API wanneer de capaciteit verzadigd is.

Kostenallocatie: Weet Precies Wie Wat Uitgeeft

Elke Claude Code-aanvraag die door TrueFoundry wordt verwerkt, wordt automatisch toegewezen aan de geauthenticeerde gebruiker. Het analytics dashboard toont de kosten opgesplitst per ontwikkelaar, team, model en datum - filterbaar op elke metadata-tag die u doorgeeft via de X-TFY-METADATA-header.

Voor teams die projectgebaseerde kostenallocatie gebruiken, kunt u Claude Code-aanvragen taggen met project_id- of feature-metadata, waarna elke aanvraag automatisch naar de juiste kostenplaats wordt geschreven:‍


Alle traces kunnen via OpenTelemetry worden geëxporteerd naar Grafana, Datadog, Splunk of uw bestaande observabiliteitsstack.

Stap 4: Implementeer Over Uw Gehele Engineeringteam

Het configureren van de settings.json van één ontwikkelaar is eenvoudig. Het afdwingen van een consistente proxy-configuratie voor elke ontwikkelaar in uw organisatie vereist echter een implementatiestrategie. TrueFoundry ondersteunt drie benaderingen:

Optie A: Via MDM Gepushte Beheerde Instellingen (Aanbevolen voor Enterprises)

Push een managed-settings.json-bestand naar elk bedrijfsapparaat via uw MDM-oplossing (Jamf, Kandji, Mosyle, Intune) en vergrendel het tegen wijzigingen op OS-niveau. Dit is de benadering van Claude Code voor endpoint-managed settings.‍


Paden op systeemniveau:

• macOS: /Library/Application Support/ClaudeCode/managed-settings.json
• Linux: /etc/claude-code/managed-settings.json

Deze configuratie is tamper-resistant (beveiligd tegen aanpassingen), geldt direct bij het opstarten zonder netwerkafhankelijkheid en vereist geen actie van ontwikkelaars. Elke machine die het MDM-profiel ontvangt, wordt automatisch via TrueFoundry geleid.

Optie B: Door Server Beheerde Instellingen Via Anthropic Admin Console

Configureer instellingen centraal via de Claude Admin Console (Admin Settings → Claude Code → Managed settings). Instellingen worden geleverd vanaf de servers van Anthropic wanneer ontwikkelaars zich authenticeren met hun organisatie-inloggegevens - er is geen bestandgebaseerde uitrol nodig.

Deze benadering vereist geen MDM-infrastructuur en werkt op BYOD-apparaten. Instellingen worden geleverd op het moment van authenticatie en zijn moeilijker door gebruikers te omzeilen.

Optie C: settings.json op Projectniveau in Versiebeheer

Commit een .claude/settings.json naar de root van elke repository. Elke ontwikkelaar die de repo clonet en Claude Code in die map uitvoert, gebruikt automatisch de projectinstellingen, inclusief de TrueFoundry gateway-URL en modelconfiguratie.‍


Dit is de optie met de laagste drempel voor teams met gestandaardiseerde repository-structuren. Nieuwe ontwikkelaars nemen de proxy-configuratie over zodra ze de code clonelen.

Stap 5: VS Code Extensie en Claude Agent SDK

VS Code Extensie

De Claude Code VS Code-extensie werkt naadloos met TrueFoundry zodra u de CLI hebt geconfigureerd. De extensie werkt niet op zichzelf - de Claude Code CLI moet eerst geïnstalleerd en geconfigureerd zijn.‍


De extensie gebruikt automatisch uw CLI-configuratie (base URL, API-sleutels, model-aliassen). Er is geen afzonderlijke instelling nodig.

Opmerking voor macOS/Linux: GUI-toepassingen nemen standaard geen shell-omgevingsvariabelen over. Start VS Code altijd vanuit een terminal waarin Claude Code is geconfigureerd, om er zeker van te zijn dat de extensie ANTHROPIC_BASE_URL overneemt.

Claude Agent SDK

De Claude Agent SDK (de opvolger van de Claude Code SDK) werkt met uw bestaande .claude/settings.json via TrueFoundry. Geef setting_sources=["project"] op om uw gateway-configuratie programmatisch te laden:

Alle TrueFoundry-configuraties - Anthropic Direct, AWS Bedrock, Google Vertex AI - werken identiek met de Agent SDK.

Zelfgebouwde Claude Code Proxy vs. TrueFoundry AI Gateway