← Claude Docs

Deploy Claude apps gateway on AWS - Claude Code Docs

Claude Docs · July 29, 2026
The article provides a guide for provisioning Claude apps gateway on AWS with Amazon Bedrock as the model upstream, using either Amazon ECS on Fargate or Amazon EKS for compute infrastructure. The gateway runs as a private HTTPS endpoint where developers authenticate through an identity provider and access Claude models via the gateway's IAM role, keeping model credentials off developer machines. The reference architecture includes detailed prerequisites, setup instructions, and Terraform templates for deploying AWS resources including ECS services, RDS PostgreSQL, Secrets Manager, IAM roles, and internal load balancers.

Detailed Analysis

Anthropic's documentation for deploying a Claude apps gateway on AWS reveals a significant piece of enterprise infrastructure aimed at organizations that need centralized control over how their developers access Claude models through Claude Code. The architecture described routes developer traffic through a private HTTPS endpoint secured by an organization's existing identity provider (with Okta used as the reference example, though any OIDC-compliant IdP is supported), rather than distributing model credentials directly to individual developer machines. Instead, authenticated sessions reach Claude models on Amazon Bedrock via the gateway's own IAM role, which is scoped narrowly to bedrock:InvokeModel and bedrock:InvokeModelWithResponseStream permissions. This is a classic enterprise security pattern—centralizing secret management, enforcing identity-based access, and eliminating credential sprawl—applied specifically to AI coding assistant deployment.

The technical design reflects mature cloud-native practices: the gateway runs on ECS Fargate or EKS, stores state in a private, non-publicly-accessible RDS PostgreSQL instance, and keeps all secrets (JWT signing keys, OIDC client secrets, database URLs) in AWS Secrets Manager rather than baked into configuration files or container images. Notably, the gateway's configuration file itself holds no secret values—everything resolves at boot through environment variable expansion—which means config changes require rebuilding and retagging the container image rather than exposing sensitive data in version control or build artifacts. This attention to secure-by-design defaults, including TLS via ACM certificates, sslmode=verify-full database connections anchored to AWS's RDS certificate bundle, and an internal-only Application Load Balancer, signals that Anthropic is positioning Claude Code not just as a developer tool but as infrastructure that must satisfy enterprise security and compliance review before adoption.

This deployment pattern matters because it addresses one of the central barriers to enterprise AI adoption: the tension between giving developers fast, frictionless access to powerful AI coding tools and maintaining the governance, auditability, and credential hygiene that security teams demand. By stamping every telemetry export with identity attributes (user.id, user.email, user.groups) pulled from the IdP, the gateway enables per-developer usage analytics and cost attribution without requiring manual OpenTelemetry configuration on each machine—a capability that finance and platform engineering teams need to justify and manage AI tool spend at scale. The inclusion of a companion Terraform bundle alongside imperative AWS CLI scripting also shows Anthropic meeting infrastructure teams where they are, supporting both declarative infrastructure-as-code workflows and more hands-on provisioning approaches, while explicitly caveating that the example is a starting point rather than a production-ready deployment.

More broadly, this documentation is emblematic of a maturing phase in enterprise AI tooling, where vendors like Anthropic are building out the "plumbing" layer—identity integration, network isolation, credential management, observability—that large organizations require before they'll roll out AI coding assistants broadly. The choice to build atop Amazon Bedrock as a model upstream (with an architecture note that a "Claude Platform on AWS" upstream occupies the same position) also reflects the reality that many enterprises want Claude's capabilities without direct dependency on Anthropic's own API infrastructure, instead consuming models through their existing cloud vendor relationships and governance frameworks. As AI coding tools move from experimental adoption to standard developer tooling, this kind of gateway architecture—private, identity-aware, and cloud-native—is likely to become table stakes for any AI vendor competing for enterprise engineering budgets, alongside similar patterns from competitors deploying through Azure OpenAI or Google Vertex AI.

Read original article →