Claude Code gebruiken met Amazon Bedrock

Met Claude Code kunnen ontwikkelaars code schrijven, debuggen, refactoren en navigeren met behulp van AI, rechtstreeks vanuit de terminal. Voor organisaties die al AWS gebruiken, biedt Amazon Bedrock een manier om toegang te krijgen tot Claude-modellen binnen hun bestaande AWS-omgeving, met AWS-authenticatie, IAM-machtigingen en regionale configuratie.

Door Claude Code te verbinden met Amazon Bedrock kunt u ondersteunde Claude-modellen gebruiken zonder afhankelijk te zijn van een directe Anthropic API key. In plaats daarvan verstuurt Claude Code verzoeken via Bedrock, en verwerkt AWS de authenticatie en toegang tot het geconfigureerde model.

De installatie omvat het inschakelen van Anthropic-modellen in uw AWS-account, het configureren van AWS-referenties, het inschakelen van de Bedrock-modus in Claude Code, het vastzetten van de juiste modelidentificaties en het verifiëren dat uw account over de vereiste machtigingen beschikt.

Deze gids behandelt het installatieproces, legt uit hoe u modellen kiest, behandelt veelvoorkomende fouten en onderzoekt wanneer een enterprise AI Gateway zoals TrueFoundry teams kan helpen bij het beheren van Claude Code-toegang, kosten en governance op schaal.

Wat is Amazon Bedrock voor Claude Code?

Amazon Bedrock is een door AWS beheerde service die toegang biedt tot foundation models van Anthropic en andere modelaanbieders via AWS API's. Hiermee kunnen organisaties ondersteunde modellen gebruiken zonder zelf de onderliggende infrastructuur voor het serveren van modellen te beheren.

Wanneer u Claude Code configureert om Bedrock te gebruiken, gaan verzoeken via AWS in plaats van rechtstreeks naar de API van Anthropic. Dit verandert de manier waarop authenticatie, machtigingen en modelselectie werken.

In plaats van te vertrouwen op een Anthropic API key, gebruikt Claude Code AWS-referenties en de machtigingen die zijn gekoppeld aan uw AWS-identiteit. Toegang tot een model hangt af van de beschikbaarheid in de door u geselecteerde AWS Region, de in uw account ingeschakelde inference profiles en de aan uw identiteit verleende machtigingen.

Hoe werkt de integratie?

De stroom van verzoeken is eenvoudig:

1. U start Claude Code in uw terminal.
2. Claude Code achterhaalt uw AWS-referenties via de standaard AWS SDK credential chain.
3. Amazon Bedrock controleert uw machtigingen en het gevraagde model of inference profile.
4. Bedrock verwerkt het verzoek met het geselecteerde model en streamt de respons terug naar Claude Code.

Het belangrijkste verschil met een directe Anthropic-setup is dat AWS-referenties, IAM-machtigingen en Bedrock inference profile ID's de gebruikelijke directe API-key-configuratie vervangen. Claude Code roept Bedrock aan via de Invoke API; het ondersteunt niet de Converse API.

Een paar functies van Claude Code werken anders op Bedrock: de WebSearch-tool is niet beschikbaar en /logout is uitgeschakeld omdat de authenticatie wordt afgehandeld door AWS.

Voor individuele ontwikkelaars kan dit een handige manier zijn om Claude-modellen te gebruiken binnen een AWS-omgeving. Voor grotere engineeringteams roept het ook vragen op over het beheren van de toegang tussen ontwikkelaars, het bijhouden van kosten per team en het toepassen van consistente controles over meerdere AI-toepassingen. Die vereisten vragen op termijn mogelijk om een extra gateway-laag.

Vereisten

Zorg ervoor dat u aan het volgende voldoet voordat u Claude Code verbindt met Amazon Bedrock:

• Claude Code geïnstalleerd: Volg de officiële installatiehandleiding.
• Een AWS-account: U hebt toegang nodig tot Amazon Bedrock in de door u gekozen AWS Region.
• Toegang tot Anthropic-modellen: Voordat u voor de eerste keer een Anthropic-model aanroept, dient u het formulier voor use case-details één keer per AWS-account in. Open in de Amazon Bedrock-console de Model catalog, selecteer een Anthropic-model en vul het formulier in. Toegang wordt onmiddellijk na indiening verleend. Als u AWS Organizations gebruikt, kunt u dit eenmalig indienen vanaf het management-account, waarna de goedkeuring zich uitstrekt tot onderliggende accounts.
• AWS-referenties: Configureer een AWS-profiel, IAM-rol, AWS IAM Identity Center (SSO), Amazon Bedrock API key of een andere ondersteunde authenticatiemethode. De AWS CLI is optioneel als u al een andere manier hebt om referenties op te geven.
• IAM-machtigingen: Uw AWS-identiteit heeft machtigingen nodig om Bedrock-modellen aan te roepen en inference profiles te lezen (zie het IAM-beleid hieronder).

Geef in productieomgevingen waar mogelijk de voorkeur aan tijdelijke referenties of IAM-rollen boven langdurige access keys. Raadpleeg de Amazon Bedrock-documentatie voor de actuele toegangseisen.

Vereiste IAM-machtigingen

De documentatie van Anthropic over Claude Code op Amazon Bedrock raadt een beleid aan in de volgende stijl:

Voor eenstriktere controle kunt u de Resource beperken tot specifieke inference profile ARN's. Anthropic stelt ook een toegewijd AWS-account voor Claude Code voor om het bijhouden van kosten en toegangsbeheer te vereenvoudigen.

Claude Code configureren met Amazon Bedrock

U kunt Claude Code verbinden met Bedrock via de setup wizard of door omgevingsvariabelen handmatig te configureren.

Optie 1: Gebruik de setup wizard

Voer claude uit. Selecteer bij de inlogprompt 3rd-party platform, en vervolgens Amazon Bedrock. Als u al bent aangemeld, typt u /setup-bedrock volledig; Claude Code verbergt het uit het opdrachtmenu totdat CLAUDE_CODE_USE_BEDROCK=1 is ingesteld.

De wizard vraagt hoe u zich authenticeert (een AWS-profiel, een Bedrock API key, een access key en secret, of referenties die al in uw omgeving aanwezig zijn), vraagt om uw Region, controleert welke Claude-modellen uw account kan aanroepen en laat u deze vastzetten. Het slaat alles op in het env-blok van ~/.claude/settings.json, zodat u zelf geen variabelen hoeft te exporteren.

Optie 2: Handmatig configureren

De handmatige aanpak is nuttig voor CI en herhaalbare setups voor ontwikkelaars en teams.

Stap 1: Configureer AWS-referenties

Claude Code gebruikt de standaard AWS SDK credential chain. Als de machine al referenties levert, zoals een EC2 instance profile of ECS task credentials, kunt u doorgaan naar Stap 2.

Als u de AWS CLI gebruikt, configureert u een profiel met uw referenties:

De CLI vraagt om uw access key, secret key, standaard Region en output format. Als uw organisatie AWS IAM Identity Center (SSO) gebruikt, configureert u uw profiel en meldt u zich in plaats daarvan aan:

Vervang your-profile-name door uw geconfigureerde AWS-profiel.

Andere ondersteunde opties:

• AWS Management Console-referenties: aws login (AWS CLI 2.32.0 of hoger) meldt u aan via de browser met een sessie die tot 12 uur geldig is.
• Amazon Bedrock API key: export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key. Wanneer dit is ingesteld, gebruikt Claude Code de sleutel en negeert het andere AWS-referenties. AWS geeft voor productie de voorkeur aan kortstondige sleutels (tot 12 uur).

Verifieer dat AWS uw huidige referenties kan identificeren:

Als het commando slaagt, retourneert het informatie over de gebruikte AWS-identiteit. Gebruik de authenticatiemethode die door uw organisatie is goedgekeurd. U hebt geen directe Anthropic API key nodig voor deze Bedrock-setup.

Stap 2: Kies uw AWS Region en controleer modeltoegang

Stel de Region in waar uw Claude-modellen en inference profiles beschikbaar zijn:

Dit is optioneel als uw AWS-profiel al een Region instelt. Claude Code achterhaalt de Region vanuit AWS_REGION, vervolgens AWS_DEFAULT_REGION, dan uw actieve AWS-profiel, en valt terug op us-east-1.

Claude Code roept modellen aan via inference profiles, dus geef deze weer in plaats van ruwe foundation models:

Zoek naar Anthropic profile ID's zoals us.anthropic.claude-sonnet-4-6. Het voorvoegsel weerspiegelt de geografie: us., eu., apac., us-gov. voor GovCloud, of global.. Het gebruiken van een ruwe foundation model ID in plaats van een profile ID is de meest voorkomende oorzaak van de fout "on-demand throughput isn't supported".

Stap 3: Schakel de Bedrock-modus in Claude Code in

Stel de omgevingsvariabele in die Claude Code vertelt om Amazon Bedrock te gebruiken:

Start vervolgens Claude Code:

claude

Claude Code gebruikt Bedrock in plaats van de standaard directe Anthropic-verbinding wanneer de Bedrock-modus is ingeschakeld en geldige AWS-referenties en -machtigingen beschikbaar zijn.

Stap 4: Zet uw modellen vast

Zet specifieke modelversies vast voordat u Claude Code uitrolt naar meerdere gebruikers. Het volgende gedeelte legt uit hoe u modellen kiest en vastzet.

Stap 5: Verifieer de verbinding

Start Claude Code vanuit uw projectmap:

Voer binnen Claude Code het volgende uit:

Controleer of de actieve provider Amazon Bedrock is, de achterhaalde Region correct is en het gewenste model is geselecteerd. Stuur vervolgens een kleine testprompt.

Als de verbinding mislukt, controleert u de AWS-identiteit met aws sts get-caller-identity, en controleert u vervolgens de Region, modeltoegang en IAM-machtigingen voordat u andere instellingen wijzigt.

Maak de configuratie permanent

Shell-exports zijn alleen van toepassing op de huidige terminal-sessie. Om ze te hergebruiken, voegt u ze toe aan ~/.zshrc of ~/.bashrc en laadt u ze opnieuw met source ~/.zshrc, of plaatst u ze in het env-blok van ~/.claude/settings.json zodat ze overal gelden waar Claude Code wordt uitgevoerd:

Voor SSO-gebruikers zorgt de instelling awsAuthRefresh (bijvoorbeeld "awsAuthRefresh": "aws sso login --profile your-profile-name") ervoor dat Claude Code verlopen referenties automatisch kan vernieuwen.

Gebruik voor teamomgevingen de door uw organisatie goedgekeurde methode voor het distribueren van configuraties en referenties. Commit nooit AWS-geheimen naar een project-repository.

Claude-modellen kiezen op Amazon Bedrock

Zodra Claude Code is verbonden met Amazon Bedrock, kunt u configureren welke Claude-modellen het gebruikt voor codeertaken. De beschikbare opties hangen af van uw AWS Region, Bedrock-modeltoegang en de in uw account ingeschakelde inference profiles.

Stap 1: Controleer beschikbare Claude-modellen

Geef de inference profiles in uw Region weer:

Bekijk de geretourneerde Anthropic profile ID's en bevestig dat het gewenste model beschikbaar is voor uw account.

Stap 2: Zet uw voorkeursmodellen vast

Zonder vastzetten verwijzen de aliases sonnet en opus van Claude Code naar de ingebouwde Bedrock-standaarden, die per versie kunnen veranderen en mogelijk niet zijn ingeschakeld in uw account. Het standaard primaire model is bovendien een Opus-model, dat tegen een hoger tarief per token wordt gefactureerd dan Sonnet.

Zet elke alias vast op een specifiek inference profile ID:

Om het primaire model rechtstreeks in te stellen:

U kunt ook een application inference profile ARN gebruiken, wat handig is voor het bijhouden van de kosten per team of project:

Vervang deze voorbeelden door ID's die bestaan in uw account en Region. Kopieer geen ID's uit een andere Region zonder het voorvoegsel te controleren.

Als u alleen het geografische voorvoegsel wilt wijzigen terwijl u de standaardmodellen van Claude Code behoudt, stelt u ANTHROPIC_BEDROCK_REGION_PREFIX in (bijvoorbeeld eu of global) in plaats van vastzetten.

Stap 3: Verifieer het geselecteerde model

Herstart Claude Code na het wijzigen van uw configuratie en voer het volgende uit:

/status


Bevestig dat Claude Code Amazon Bedrock en het verwachte model gebruikt. Als een verzoek mislukt, controleert u het exacte model-ID, het Region-voorvoegsel en de IAM-machtigingen.

Best practice: Begin met één ondersteund Claude-model, bevestig dat codeer- en toolgebruik-workflows werken, en configureer vervolgens aanvullende modellen. Dit maakt het eenvoudiger om compatibiliteits- of toegangsproblemen te isoleren.

Claude Code met Amazon Bedrock vs. TrueFoundry AI Gateway

Het rechtstreeks verbinden van Claude Code met Amazon Bedrock is een praktische optie voor ontwikkelaars en organisaties die al AWS gebruiken. U kunt AWS-referenties, IAM-machtigingen en de modelinfrastructuur van Bedrock gebruiken zonder een extra gateway aan het verzoekpad toe te voegen.

Wanneer meerdere teams Claude Code gaan gebruiken, moeten platform engineers echter mogelijk de toegang beheren, de uitgaven van verschillende teams begrijpen, een consistent beleid afdwingen en meerdere modelaanbieders ondersteunen via een gedeelde interface.

TrueFoundry AI Gateway kan tussen Claude Code en Amazon Bedrock worden geplaatst en voegt een gecentraliseerde laag toe voor modeltoegang, gebruikstransparantie, kostenbeheersing en governance.

Beheer Claude Code op schaal met TrueFoundry AI Gateway

TrueFoundry AI Gateway geeft u een Claude Code gateway die uw platformteam beheert: één control plane voor modeltoegang, MCP-governance, guardrails en kostentoewijzing, ingezet waar uw infrastructuur zich ook bevindt.

Claude Code naar TrueFoundry verwijzen

Het verwijzen van Claude Code naar onze gateway is dezelfde soort wijziging die u zojuist hebt gemaakt. Wijzig in API-key-modus de URL en het token in settings.json

Dit is wat elke variabele doet:

• ANTHROPIC_BASE_URL is uw gateway URL, vanuit het uniforme codefragment van de Playground.
• ANTHROPIC_AUTH_TOKEN is uw TrueFoundry-sleutel, die de gebruiker identificeert. De Anthropic-, Bedrock- of Vertex-referentie blijft op de gateway en komt nooit op de laptop terecht.
• ANTHROPIC_MODEL en de ANTHROPIC_DEFAULT_*_MODEL variabelen koppelen de aliases opus, sonnet en haiku van Claude Code aan gatewaymodellen in de provider-account/model-name indeling.
• CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS houdt het gedrag stabiel over verschillende providers, terwijl ANTHROPIC_CUSTOM_HEADERS specifieke Anthropic-bèta's doorstuurt via x-tfy-anthropic-beta.

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

Wat TrueFoundry toevoegt bovenop Bedrock

• Kostentoewijzing per gebruiker en per team: Elk verzoek is gekoppeld aan een ontwikkelaar en team, zodat u de uitgaven van Claude Code per persoon ziet, en niet als één Bedrock-regelitem.
• Budgetten en rate limits: Stel limieten in voor uitgaven of verzoeksnelheden per gebruiker, team of model voordat een doorgedraaide agent-loop op uw AWS-factuur verschijnt.
• Fallbacks over meerdere providers: Een virtueel model kan van Bedrock overschakelen naar Anthropic of Vertex AI wanneer u te maken krijgt met throttling of een storing.
• 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 tool-calls: Gateway guardrails dekken PII, prompt injection en moderatie af. Claude Code hooks breiden dat uit naar shell-commando's, bestandsbewerkingen en MCP tool-calls.
• Organisatiebrede handhaving: 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 identity provider volgt die uw bedrijf al gebruikt, met audit-logging bij elk verzoek.
• Implementatie binnen uw AWS-omgeving: Draai de gateway in uw eigen VPC naast Bedrock, of 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.

Gebruik Claude Code rechtstreeks met Amazon Bedrock wanneer een klein team Claude binnen AWS nodig heeft en IAM voldoende controle biedt. Voeg TrueFoundry AI Gateway toe voor Bedrock wanneer u kostencategorisatie per ontwikkelaar, budgetten, MCP-governance, guardrails op tool-calls en één uitrol voor uw gehele engineeringorganisatie nodig hebt. Lees voor de volledige architectuur onze gids voor Claude Code governance met een AI gateway.

Conclusie

Amazon Bedrock biedt een manier om Claude-modellen te gebruiken via AWS, met AWS-native authenticatie, IAM-machtigingen en modelinfrastructuur. Door de juiste referenties, Region en modelidentificaties te configureren, kunt u Claude Code verbinden met Bedrock en het gebruiken vanuit uw terminal.

Voor individuele ontwikkelaars en teams die al binnen AWS werken, kan directe Bedrock-toegang voldoende zijn. Naarmate het gebruik groeit, hebben organisaties echter mogelijk een gedeelde aanpak nodig voor modeltoegang, kostentoewijzing, observability en governance over toepassingen en providers heen.

TrueFoundry AI Gateway voegt die gecentraliseerde controlelaag toe, terwijl ondersteunde Claude Code-verzoeken geconfigureerde Bedrock-modellen kunnen blijven gebruiken.

Verken TrueFoundry AI Gateway om te zien hoe het uw organisatie kan helpen bij het beheren van Claude Code en andere AI-workloads.