← Claude Docs

Claude Code on Claude Platform on AWS - Claude Code Docs

Claude Docs · June 5, 2026
Claude Code can be configured to use Claude Platform on AWS through AWS authentication and environment variable setup. Users must authenticate using either AWS credentials with SigV4 or a workspace API key, set required environment variables like CLAUDE_CODE_USE_ANTHROPIC_AWS and ANTHROPIC_AWS_WORKSPACE_ID, and optionally pin specific model versions to ensure consistent deployments. The setup also supports routing through corporate proxies and includes troubleshooting guidance for common authentication and configuration issues.

Detailed Analysis

Anthropic has released official documentation detailing how to configure Claude Code — its agentic coding assistant — to operate through Claude Platform on AWS, a deployment model that combines Anthropic's native API with AWS authentication infrastructure, IAM access controls, and AWS Marketplace billing. The integration is notably distinct from Amazon Bedrock, Anthropic's existing AWS partnership channel, in that requests route directly to Anthropic's own API rather than through AWS-managed model endpoints. This means developers using Claude Platform on AWS receive the same models and features on the same release schedule as direct Claude API customers, while benefiting from enterprise-grade AWS identity management and consolidated cloud billing. Two authentication pathways are supported: SigV4 request signing using the standard AWS credential chain, and workspace API keys for teams that prefer long-lived static credentials over federated identity management.

The technical architecture described in the documentation reveals deliberate design choices around enterprise deployment flexibility. The system uses environment variables — specifically `CLAUDE_CODE_USE_ANTHROPIC_AWS`, `ANTHROPIC_AWS_WORKSPACE_ID`, and `AWS_REGION` — to route Claude Code traffic away from Anthropic's default API endpoint toward a region-specific AWS URL. The documentation explicitly notes that Claude Platform on AWS is opt-in even when AWS credentials are present in the environment, and that Bedrock and Foundry integrations take precedence in provider routing, requiring those flags to be unset if a team wants to use this pathway. This layered opt-in design suggests Anthropic is carefully managing the coexistence of multiple AWS-adjacent deployment channels without breaking existing Bedrock customers.

The inclusion of the Agent SDK integration signals that Claude Platform on AWS is not merely a credential-routing convenience for individual developers but a production deployment target for programmatic, automated systems. The SDK reads the same environment variables as the CLI, meaning any subprocess-spawning orchestration layer can target the platform simply by exporting the appropriate variables before invocation. Features like `awsAuthRefresh` — which re-executes a login command when SSO credentials expire mid-session — and the `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` flag for corporate proxy environments indicate that Anthropic is anticipating long-running, enterprise-scale agentic deployments where credential lifecycle management and network topology are non-trivial operational concerns.

This release reflects a broader trend in frontier AI development toward deep integration with established cloud identity and procurement infrastructure. By threading Claude Code through AWS IAM and AWS Marketplace, Anthropic removes a significant adoption barrier for enterprise customers whose procurement, security, and compliance teams already operate within AWS governance frameworks. Pinnable model version variables like `ANTHROPIC_DEFAULT_OPUS_MODEL` further address enterprise change-management concerns by giving organizations explicit control over when model upgrades propagate across their deployed tooling. The documentation's mention of a 1-hour prompt caching TTL option, billed at a premium over the default 5-minute cache, also points to Anthropic's effort to offer performance-cost tradeoffs appropriate for large-scale automated coding workflows rather than interactive single-user sessions.

Taken together, the Claude Platform on AWS documentation represents Anthropic's continued push to make Claude Code a credible tool for enterprise software engineering teams rather than solely a developer-facing productivity product. The architecture balances Anthropic's interest in maintaining direct API relationships — preserving feature parity and release cadence — with the operational reality that large organizations procure, authenticate, and govern AI services through incumbent cloud platforms. As competitors including OpenAI and Google DeepMind pursue similar enterprise distribution strategies through Azure and Google Cloud respectively, Anthropic's dual-track AWS presence through both Bedrock and Claude Platform on AWS positions the company to serve organizations at different points on the build-versus-buy spectrum for AI infrastructure.

Read original article →