Vercel AI Gateway met Claude Code: Instellingsgids

Met Claude Code kunnen ontwikkelaars direct vanuit de terminal code schrijven, debuggen en refactoren met AI. Maar wanneer u het gebruik wilt monitoren, tussen modelproviders wilt wisselen of AI-verkeer wilt beheren via een gedeeld eindpunt, kan het verbinden van Claude Code met een AI gateway die workflow eenvoudiger te beheren maken.

Vercel AI Gateway biedt een met Anthropic compatibel eindpunt waarmee u Claude Code-verzoeken via de gateway kunt routeren zonder uw gebruikelijke terminalworkflow te wijzigen. Eenmaal geconfigureerd kunt u het tokenverbruik en de uitgaven monitoren, verzoeksporen inspecteren en ondersteunde functies voor modelrouting en provider-fallback gebruiken vanuit het Vercel-dashboard.

Voor individuele ontwikkelaars biedt dit een handige manier om modeltoegang en gebruiks-zichtbaarheid te centraliseren. Voor engineeringteams roept het ook een bredere vraag op: wanneer moeten monitoring en routing op gatewayniveau worden uitgebreid naar organisatiebrede toegangscentra, governance en implementatievereisten?

Deze gids behandelt het verbinden van Claude Code met Vercel AI Gateway, het configureren van authenticatie, het verifiëren van verzoeken, het oplossen van veelvoorkomende fouten en het evalueren wanneer een enterprise AI Gateway zoals TrueFoundry beter zou passen.

Wat is AI Gateway voor Claude Code?

AI Gateway is een universele interface voor toegang tot modellen van verschillende providers via een gemeenschappelijke API. Het biedt modelrouting, gebruiks- en uitgavenmonitoring, observabiliteit van verzoeken en ondersteunde provider-fallbackopties.

Claude Code maakt normaal gesproken rechtstreeks verbinding met de API van Anthropic. Met AI Gateway kunt u die verzoeken in plaats daarvan omleiden via het met Anthropic compatibele eindpunt, zodat u Claude Code kunt blijven gebruiken vanuit uw terminal terwijl Vercel de routing en monitoring aan de gatewayzijde afhandelt.

De verbinding maakt gebruik van drie omgevingsvariabelen:

• ANTHROPIC_BASE_URL specificeert het AI Gateway-eindpunt.
• ANTHROPIC_AUTH_TOKEN levert uw AI Gateway API-sleutel.
• ANTHROPIC_API_KEY wordt ingesteld op een lege tekenreeks om te voorkomen dat een niet-lege Anthropic API-sleutel voorrang krijgt boven de gateway-token.

Eenmaal geconfigureerd stuurt Claude Code ondersteunde verzoeken via Vercel AI Gateway in plaats van rechtstreeks naar Anthropic.

Waarom AI Gateway gebruiken met Claude Code?

Geünificeerde modeltoegang: Routeer ondersteunde verzoeken via een gemeenschappelijke gateway in plaats van voor elke provider een afzonderlijk eindpunt te configureren.

Gebruiks- en uitgavenmonitoring: Bekijk modelgebruik en uitgaven via het dashboard van Vercel AI Gateway, wat u helpt te begrijpen hoe coding-agent-sessies tokens verbruiken.

Observabiliteit van verzoeken: Inspecteer gedetailleerde sporen en metrieken om het gedrag van verzoeken te onderzoeken en problemen op te lossen.

Provider-fallback: Gebruik ondersteunde fallback-configuraties om de veerkracht te vergroten wanneer een provider of modeleindpunt een fout tegenkomt.

Een vertrouwde ontwikkelaarsworkflow: Blijf Claude Code starten vanuit de terminal zonder een afzonderlijke SDK in uw project te integreren.

Deze mogelijkheden maken AI Gateway nuttig wanneer u een meer gecentraliseerd overzicht van modelverkeer wilt zonder de manier waarop u met Claude Code communiceert te wijzigen.

Routing en observabiliteit zijn echter slechts een deel van het plaatje voor organisaties die coding agents over meerdere teams uitrollen. Vereisten zoals gecentraliseerd identiteitsbeleid, kostentoewijzing op teamniveau, guardrails en infrastructuurcontrole kunnen vragen om een bredere enterprise gateway-strategie.

Vereisten

Zorg er voordat u Claude Code verbindt met Vercel AI Gateway voor dat u beschikt over:

• Claude Code geïnstalleerd: Volg de officiële installatiegids.

• Een Vercel-account: Meld u aan bij Vercel.

• Een AI Gateway API-sleutel: Maak of verkrijg een sleutel via Vercel AI Gateway.

• Terminaltoegang: U configureert omgevingsvariabelen in uw shell.

Hoe u Claude Code verbindt met Vercel AI Gateway

Stap 1: Configureer de omgevingsvariabelen

Open uw terminal en stel het gateway-eindpunt en het authenticatietoken in. Vervang de tijdelijke aanduiding door uw daadwerkelijke Vercel AI Gateway API-sleutel.

Deze variabelen sturen Claude Code-verzoeken naar Vercel AI Gateway en gebruiken uw gateway-sleutel voor authenticatie.

Stap 2: Start Claude Code

Navigeer naar uw projectmap en start Claude Code:

Vervang /path/to/your/project door het pad naar uw daadwerkelijke project.

Stap 3: Verifieer de verbinding

Voer binnen Claude Code het volgende uit:

Controleer of de sessie uw gateway-configuratie weerspiegelt. U kunt ook het dashboard van Vercel AI Gateway inspecteren na het verzenden van een testprompt om te bevestigen dat verzoeken verschijnen.

Voor een permanente configuratie kunt u de omgevingsvariabelen toevoegen aan uw shell-configuratiebestand, zoals ~/.zshrc of ~/.bashrc, en dit opnieuw laden met source ~/.zshrc of source ~/.bashrc.

Gebruik monitoren en van model wisselen

Zodra Claude Code verzoeken via Vercel AI Gateway routeert, kunt u het Vercel-dashboard gebruiken om modelgebruik te inspecteren, uitgaven bij te houden en individuele verzoeken te onderzoeken.

Monitor tokenverbruik en kosten

Open uw Vercel-dashboard en navigeer naar AI Gateway. In de secties Overview en Observability kunt u gebruiksmetrieken bekijken en verzoeksporen inspecteren.

Wissel van model in Claude Code

Vercel AI Gateway ondersteunt toegang tot verschillende modellen via een gemeenschappelijk eindpunt. Met Claude Code geconfigureerd om de gateway te gebruiken, kunt u de modelkiezer gebruiken om te wisselen tussen ondersteunde Claude-modellen.

Voer binnen Claude Code het volgende uit:

Kies een beschikbaar model uit de kiezer. De beschikbaarheid van modellen hangt af van de gateway-catalogus en uw configuratie.

Als u een model van een andere provider wilt gebruiken, controleer dan de compatibiliteit met Claude Code voordat u erop vertrouwt voor tool-intensieve coding-workflows. Dat een model beschikbaar is via de gateway garandeert niet dat elke Claude Code-functie ermee werkt.

Houd gateway-inloggegevens veilig

Voor een snelle test volstaan omgevingsvariabelen in uw huidige terminal. Voor herhaald gebruik slaat u de configuratie op in uw shell-profiel of gebruikt u een toegewezen sleutel met passende uitgavenlimieten.

Voorkom dat u API-sleutels in bronbeheerde projectbestanden plaatst. Als u Claude Code Max gebruikt met Vercel AI Gateway, volg dan de afzonderlijke abonnementconfiguratie van Vercel in plaats van deze te mengen met de bovenstaande API-sleutelinstelling.

Waar teams op limieten stuiten bij Vercel AI Gateway

Voor individuele ontwikkelaars en teams die al op Vercel zitten, is deze instelling echt goed: snel te configureren, catalogusprijzen voor tokens en meer controle over uitgaven dan de meeste gehoste gateways. De beperkingen worden zichtbaar wanneer Claude Code een organisatiebrede uitrol wordt.

1. Het draait alleen op de infrastructuur van Vercel

Vercel vermeldt duidelijk dat AI Gateway niet zelf te hosten is. Als de gateway binnen uw VPC, on-premise of air-gapped moet draaien, is dit geen optie. Regionale inferentie regelt waar de provider een verzoek uitvoert (VS, EU, Australië of Japan), maar het is een opt-in, en Claude Code kan het alleen gebruiken via een virtueel model.

2. Het beheert modelaanroepen, geen toolaanroepen

Claude Code maakt verbinding met MCP-servers voor GitHub, databases en interne tools. Op de vraag of AI Gateway uw MCP gateway kan zijn, antwoordt Vercel's eigen FAQ nee: toegangscontrole op toolniveau hoort thuis in een afzonderlijke laag. Als security wil controleren welke MCP-servers ontwikkelaars vanaf hun laptops bereiken, heeft u een andere laag nodig. We behandelen de opties in onze gids over de beste MCP gateway voor Claude Code.

3. Guardrails bevinden zich buiten de gateway

Vercel's beveiligings- en compliancecontroles richten zich op gegevensverwerking: zero data retention, geen prompt-training, en allowlists voor providers en modellen. Het inspecteren of blokkeren van prompts, PII en de toolaanroepen van Claude Code is iets wat u afzonderlijk moet toevoegen.

4. Identiteit verloopt via API-sleutels

Budgetten per gebruiker werken via sleuteltoewijzing: een sleutel telt mee voor het lid dat deze heeft aangemaakt. Bij honderden engineers betekent dat waarschijnlijk het distribueren en roteren van individuele sleutels, in plaats van ontwikkelaars te authenticeren via de SSO die uw bedrijf al gebruikt.

Vercel AI Gateway handelt modeltoegang en uitgavenzichtbaarheid goed af. Maar zodra Claude Code deel uitmaakt van de dagelijkse werkwijze van uw engineeringorganisatie, hebben platformteams controle nodig over wie welke modellen mag gebruiken, welke tools agents kunnen bereiken, en wat er tussentijds met prompts en toolaanroepen gebeurt.

Beheer Claude Code op schaal met TrueFoundry AI Gateway

TrueFoundry AI Gateway geeft u een Claude Code gateway waar uw platformteam de controle over heeft: één controlevlak voor modeltoegang, MCP-governance, guardrails en kostenallocatie, geïmplementeerd waar uw infrastructuur zich ook bevindt.

Claude Code instellen op TrueFoundry

Claude Code instellen op onze gateway is dezelfde soort wijziging die u zojuist heeft gemaakt. In API-sleutelmodus vervangt u de basis-URL en het token in settings.json

Dit is wat elke variabele doet:

• ANTHROPIC_BASE_URL is de basis-URL van uw gateway, afkomstig uit het geünificeerde codefragment van de Playground.
• ANTHROPIC_AUTH_TOKEN is uw TrueFoundry-sleutel, die de gebruiker identificeert. De Anthropic-, Bedrock- of Vertex-inloggegevens blijven op de gateway en komen nooit op de laptop terecht.
• ANTHROPIC_MODEL en de ANTHROPIC_DEFAULT_*_MODEL variabelen koppelen de opus-, sonnet- en haiku-aliassen van Claude Code aan gatewaymodellen in provider-account/model-name-indeling.
• CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS houdt het gedrag stabiel over providers heen, terwijl ANTHROPIC_CUSTOM_HEADERS specifieke Anthropic beta's doorstuur via x-tfy-anthropic-beta.

Stuur een prompt, en deze verschijnt in AI Gateway → Analytics onder uw gebruiker, met model, tokens en kosten. De volledige instelling staat in onze Claude Code documentatie.

Wat wij toevoegen voor Claude Code

• Twee facturatiemodi, één gateway: API-sleutelmodus voor één organisatiefactuur, of abonnementspassthrough zodat Claude Enterprise-, Team-, Pro- of Max-seats blijven betalen. Een virtueel model kan van het abonnement terugvallen op een account met betaling per token wanneer de seat zijn limiet bereikt.
• MCP-governance op hetzelfde platform: Routeer de MCP-servers van Claude Code via de TrueFoundry MCP Gateway, met allowlists, authenticatie en audit.
• Guardrails op prompts en toolaanroepen: Gateway guardrails dekken PII, prompt injection en moderatie af. Claude Code hooks breiden dat uit naar shell-commando's, bestandsbewerkingen en MCP-toolaanroepen, die de gateway kan blokkeren of herschrijven.
• Flootbrede afdwinging: tfy-local-ai-setup schrijft een vergrendelde managed-settings.json met een token per gebruiker, gedistribueerd via MDM.
• Enterprise identiteit en toegang: SSO en RBAC, zodat toegang de identiteitsprovider volgt die uw bedrijf al gebruikt, met audit-logging op elk verzoek.
• Implementatie waar uw infrastructuur zich bevindt: Draai de gateway in uw VPC, on-premise, hybride of air-gapped, met SOC 2-, HIPAA- en GDPR-compliance.
• Brede modeltoegang met minimale overhead: 1.600+ modellen via één gateway, met een interne latentie van minder dan 3 ms.

Vercel AI Gateway vs TrueFoundry AI Gateway voor Claude Code

Conclusie

Het gebruik van Vercel AI Gateway met Claude Code is een van de eenvoudigste manieren om een gateway voor uw coding agent te plaatsen. Eén CLI-commando configureert het eindpunt, de sleutel en de modelkiezer, en budgetten geven u echte controle over wat coding agents uitgeven. Laat ANTHROPIC_API_KEY leeg, laat /v1 weg uit de basis-URL, onthoud dat BYOK-verkeer buiten uw budgetten valt, en verifieer met /status voordat u erop vertrouwt.

Als Claude Code een tool is voor u en uw team, is dat mogelijk alles wat u nodig heeft. Als u het uitrolt over een gehele engineeringorganisatie, met MCP-servers om te beheren, toolaanroepen om te inspecteren en infrastructuur die binnen uw netwerk moet blijven, lees dan hoe TrueFoundry AI Gateway Claude Code-governance afhandelt.

Veelgestelde vragen

V: Rekent Vercel AI Gateway een toeslag op Claude-tokens?

A: Nee. Vercel geeft aan dat AI Gateway geen toeslag en geen platformkosten rekent op tokens, inclusief met BYOK. U betaalt de catalogusprijs van de provider vanuit vooraf betaalde credits; add-ons zoals Custom Reporting en Trace Drains worden afzonderlijk gefactureerd.

V: Waarom geeft Claude Code een 404-fout via Vercel AI Gateway?

A: Meestal omdat de basis-URL eindigt op /v1. De Anthropic SDK voegt zelf /v1/messages toe, dus de basis-URL moet exact https://ai-gateway.vercel.sh/claude-code zijn.

V: Kan ik mijn Claude Max-abonnement gebruiken met Vercel AI Gateway?

A: Ja. Behoud de Vercel basis-URL, meld u aan met uw Claude-account en stuur uw AI Gateway-sleutel mee in een aangepaste header: ANTHROPIC_CUSTOM_HEADERS="x-ai-gateway-api-key: Bearer your-ai-gateway-api-key". De Vercel CLI schrijft deze header niet, dus stel deze handmatig in.

V: Kan ik TrueFoundry implementeren in mijn eigen VPC of on-premise?

A: Ja. Wij ondersteunen SaaS-, VPC-, on-premise, hybride en air-gapped implementaties, zodat model- en toolverkeer binnen uw infrastructuur kan blijven.

V: Ondersteunt TrueFoundry MCP en AI-agents?

A: Ja. Onze MCP Gateway bevindt zich naast de AI Gateway, zodat agents zoals Claude Code goedgekeurde MCP-servers bereiken met allowlists, authenticatie en audit, onder dezelfde toegangscontroles als modelverkeer.

V: Hoeveel LLM's ondersteunt TrueFoundry?

A: TrueFoundry AI Gateway geeft u toegang tot 1.600+ modellen via één gateway, met een interne latentie van minder dan 3 ms, dus het routeren van Claude Code hier doorheen voegt minimale overhead toe.

V: Integreert TrueFoundry met mijn bestaande observabiliteitsstack?

A: Ja. De gateway registreert model, tokens, latentie en kosten voor elk verzoek per gebruiker, en sporen kunnen worden geëxporteerd naar de observabiliteitstools die u al gebruikt via OpenTelemetry.

Gerelateerde artikelen

• Beste AI Gateway voor Claude Code in 2026: hoe de leidende gateways zich verhouden zodra Claude Code in productie is
• OpenRouter gebruiken in Claude Code: Instellingsgids: hetzelfde instellingspatroon met een andere gehoste gateway
• Vercel AI Gateway vs OpenRouter: Welke is het beste voor u?: als u nog twijfelt tussen gehoste gateways
• LiteLLM vs Vercel AI Gateway: Welk platform past het beste bij AI engineeringteams?: hoe een zelfgehoste proxy zich verhoudt tot de beheerde gateway van Vercel
• Claude Code met LiteLLM: Instellingsgids + Wanneer TrueFoundry AI Gateway te gebruiken: de zelfgehoste route voor Claude Code, en wanneer dat niet meer volstaat