Native Claude Code-cloudsessies werken niet met Amazon Bedrock als ingestelde provider: Anthropic documenteert dat --cloud een Anthropic-account vereist. AWS beschrijft wel een aparte, zelf te implementeren route: een voorbeeld dat afgebakende taken uitvoert in Amazon Bedrock AgentCore Runtime en daarna een GitHub-pullrequest klaarzet voor menselijke beoordeling. De agent voegt die wijziging niet zelf samen. (Anthropic-documentatie; AWS-uitleg van het AgentCore-voorbeeld)
Kies de AgentCore-route als je taken via je eigen AWS-implementatie wilt laten uitvoeren; verwacht niet dat claude --cloud daarvoor als Bedrock-schakelaar werkt.
Twee verschillende routes voor Claude Code
| Route | Account- en providervereiste | Uitvoering | Resultaat voor menselijke beoordeling |
Native Claude Code --cloud | Vereist een Anthropic-account; niet beschikbaar als Claude Code is ingesteld op Amazon Bedrock. | Claude Code-cloudsessie. | De documentatie over deze functie noemt in de hier beschreven voorwaarden geen uitkomst voor een GitHub-pullrequest. |
| AWS-voorbeeld met AgentCore | Taken draaien via Amazon Bedrock in het AWS-account waarin het voorbeeld is uitgerold. | Een aangepaste AWS-implementatie met een AgentCore Runtime-sessie per taak. | Het voorbeeld opent een pullrequest; een mens beoordeelt en voegt de wijziging eventueel samen. |
De native cloudfunctie en het AWS-voorbeeld zijn dus afzonderlijke uitvoeringspaden. Anthropic beschrijft de account- en providervereisten voor --cloud; AWS beschrijft een eigen implementatie met een plugin of webconsole en AWS-infrastructuur. (Anthropic-documentatie; AWS-uitleg)
Wat er met een taak gebeurt
AWS beschrijft een taakstroom die begint met planning door Claude Opus, gevolgd door coderen met Claude Sonnet. Daarna voert de omgeving de setup- en testcommando’s van de repository uit. Claude Opus beoordeelt het resultaat; de taak kan teruggaan naar de planningsfase, tot maximaal drie pogingen in totaal. De besturing loopt via onder meer API Gateway, Lambda, DynamoDB en SQS. Elke taak krijgt volgens AWS een eigen AgentCore Runtime-sessie en microVM.
De taak komt binnen via een lokale MCP-server die met een Claude Code-plugin werkt, of via een webconsole. De pluginroute gebruikt een IAM-geautoriseerd API-pad; de webconsole gebruikt een Cognito-geautoriseerd pad. Na afloop opent het voorbeeld een GitHub-pullrequest. Als de verificatie niet slaagt, is die pullrequest een concept. De agent merge’t nooit: een mens beoordeelt de wijziging en beslist wat ermee gebeurt. (AWS-uitleg van de taakstroom)
Voorbereiding en implementatie
Zorg vóór de uitrol voor een AWS-account en CLI-inloggegevens, een actieve Docker-installatie, Python 3.11 of hoger, uv en Node.js 22.12 of hoger. De repository moet vertrouwd zijn en de setup- en testcommando’s bevatten die het voorbeeld kan uitvoeren. Ondersteuning voor een Claude Code-pluginmarketplace is optioneel als je taken vanuit de terminal wilt insturen.
AWS noemt vijf AgentCore Runtime V2-regio’s voor de tutorial: us-east-1, us-east-2, us-west-2, ap-northeast-1 en eu-west-1. De walkthrough gebruikt us-west-2. Dat zijn de regio’s die AWS in deze tutorial noemt, geen algemene beschikbaarheidsgarantie.
- Controleer de vereisten en kies een vertrouwde repository. Zorg dat de benodigde tools en AWS CLI-toegang klaarstaan en dat de repository eigen setup- en testcommando’s heeft.
- Rol het voorbeeld uit. AWS schat de uitroltijd op 15 tot 25 minuten. Dit is de tijdsinschatting van AWS.
- Installeer en autoriseer de GitHub App. De app krijgt toegang tot repository-inhoud en pullrequests; koppel GitHub voordat je een repository registreert.
- Registreer de repository. AWS schat dat deze registratie nog eens 8 tot 12 minuten duurt.
- Dien een afgebakende taak in. Gebruik de Claude Code-plugin met de lokale MCP-server of de webconsole. Houd de opdracht concreet en gericht op werk in de vertrouwde repository.
- Beoordeel de pullrequest zelf. Controleer de code en de uitkomsten van de repositorycommando’s voordat je beslist of de wijziging wordt samengevoegd.
De geschatte tijden zijn afkomstig van AWS; ze zijn geen meting van een onafhankelijke uitrol. (AWS-handleiding)
Beveiligingsgrenzen en kosten
AWS beschrijft afzonderlijke microVM’s voor taken, private subnetten en private endpoints voor AWS-diensten. GitHub-toegang loopt via een GitHub App en AgentCore Identity. De gebruiker-naar-server-token verloopt volgens AWS na acht uur en wordt automatisch vernieuwd.
De promptguardrail controleert de ingediende taakprompt, niet de repositorybestanden of de uitvoer van commando’s. Daardoor vallen instructies die in repository-inhoud staan buiten die controle. Ook is uitgaand internetverkeer niet volledig afgesloten: via een NAT-gateway kan de runtime HTTPS-verkeer naar GitHub en pakketregisters sturen. De beschreven DNS Firewall blokkeert geselecteerde domeinen; het is geen algemene lijst met toegestane HTTPS-bestemmingen. AWS noemt het voorbeeld daarom ongeschikt voor onbetrouwbare repositories en open opdrachten. (AWS over de beveiligingsgrenzen)
De omgeving kan ook kosten veroorzaken wanneer er geen taak draait, onder meer door de NAT-gateway, interface-endpoints, AWS WAF, de Cognito-gebruikerspool, DNS Firewall, images en logs. Het standaardbudget voor Amazon Bedrock is US$ 200 per maand en stuurt een e-mailmelding; het begrenst de uitgaven niet. AWS geeft in de tutorial geen totale uitrol- of prijs per taak. (AWS over kosten en het budget)
Opruimen na gebruik
Deregistreer eerst de repositories en verbreek daarna de GitHub-koppeling. Verwijder vervolgens de AWS-stacks en verwijder ten slotte de GitHub App. Achtergebleven resources kunnen kosten blijven veroorzaken totdat ze afzonderlijk zijn verwijderd. (AWS-handleiding voor het voorbeeld)
