SPB Git

Repository Public

claude-platform-on-aws.md 85.2 KB 1,176 lines markdown

1---2title: Claude Platform on AWS3url: https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws4description: Access Claude's full platform capabilities through AWS with Anthropic-managed infrastructure.5---67Claude Platform on AWS gives you the full Anthropic platform experience, including the Messages API, Agent Skills, code execution, and beta features, accessible through your AWS account. Unlike [Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock), where AWS operates the inference stack, Anthropic operates Claude Platform on AWS. AWS provides the authentication layer (SigV4 or API key), IAM-based access control, and billing integration through AWS Marketplace.89<Note>10  The Anthropic SDKs support Claude Platform on AWS.11</Note>1213## How the platform integration works1415Claude models run on Anthropic-managed infrastructure. This is a commercial integration for billing and access through AWS. Anthropic is the data processor for inference inputs and outputs. AWS processes billing and identity metadata under the marketplace model. Customers using Claude through Claude Platform on AWS are subject to Anthropic's [data use terms](https://www.anthropic.com/legal).1617Anthropic uses AWS infrastructure to process your API requests, run model inference, and store your workspace content (such as prompts, outputs, files, Skills, and batches). For workspaces created before September 18, 2026, 00:00 UTC, Anthropic might process requests, store data, and run inference outside AWS. In either case, subservices might change without notice. Set the [`inference_geo`](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#data-residency) parameter per request to pin inference to a specific geography.1819Claude Platform on AWS follows the same data retention policy as the first-party Claude API. Zero Data Retention (ZDR) is available on request. Contact your Anthropic account representative to enable it for your organization.2021## Claude Platform on AWS versus Amazon Bedrock2223Both offerings let you use Claude through AWS, but they differ in architecture, API surface, and feature availability.2425| Aspect                       | Claude Platform on AWS                                                                                                                                                      | [Claude in Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock) | [Amazon Bedrock (Opus 4.6 and earlier)](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy) |26| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |27| **Who operates the stack**   | Anthropic                                                                                                                                                                   | AWS                                                                                                        | AWS                                                                                                                            |28| **API surface**              | Claude API (`/v1/{endpoint}`)                                                                                                                                               | Messages API at `/anthropic/v1/messages`                                                                   | Bedrock Converse / InvokeModel                                                                                                 |29| **Feature availability**     | Typically same-day as Claude API (see [feature limitations](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#features-not-supported))           | Per Amazon Bedrock release schedule                                                                        | Per Amazon Bedrock release schedule                                                                                            |30| **Agent Skills**             | Available (beta)                                                                                                                                                            | Not available (requires code execution)                                                                    | Not available                                                                                                                  |31| **Beta features**            | Pass through with `anthropic-beta` headers (see [feature limitations](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#features-not-supported)) | `anthropic-beta` header not supported                                                                      | `anthropic-beta` header not supported                                                                                          |32| **Authentication**           | AWS IAM / SigV4 or API key                                                                                                                                                  | AWS IAM / SigV4                                                                                            | AWS IAM / SigV4 or bearer token                                                                                                |33| **Billing**                  | AWS Marketplace                                                                                                                                                             | AWS (native service)                                                                                       | AWS (native service)                                                                                                           |34| **Base URL**                 | `aws-external-anthropic.{region}.api.aws`                                                                                                                                   | `bedrock-mantle.{region}.api.aws`                                                                          | `bedrock-runtime.{region}.amazonaws.com`                                                                                       |35| **SDK client**               | Platform-specific client class (for example, `AnthropicAWS` in Python), in beta                                                                                             | `AnthropicBedrockMantle`                                                                                   | `AnthropicBedrock` / Bedrock SDK                                                                                               |36| **Console**                  | Claude Console (`platform.claude.com`, access through the AWS Console)                                                                                                      | Bedrock Console                                                                                            | Bedrock Console                                                                                                                |37| **Rate limits and quotas**   | Managed by Anthropic                                                                                                                                                        | Managed by AWS                                                                                             | Managed by AWS                                                                                                                 |38| **Inference data processor** | Anthropic                                                                                                                                                                   | AWS                                                                                                        | AWS                                                                                                                            |3940If you need AWS-operated Claude, see [Claude in Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock). Claude Platform on AWS uses a separate capacity pool from both the first-party Claude API and Amazon Bedrock. You can run workloads on more than one platform and fail over between them.4142[AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/privatelink/what-is-privatelink.html) is supported for connecting your VPC to the Claude Platform on AWS endpoint.4344**When to choose Bedrock:** Organizations in regulated industries that require FedRAMP High, IL4, IL5, or HIPAA-ready compliance, or that need AWS to be the sole data processor, should use [Claude in Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock). Bedrock runs entirely on AWS-controlled infrastructure with AWS as the operating party.4546**Which offering are you using?** Claude is available through several distinct products:4748* **Claude Platform on AWS** (this page): The Claude API platform billed through AWS Marketplace. Managed in the [Claude Console](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#using-the-claude-console) and the AWS Console.49* **[Claude in Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock):** An AWS-native service. Managed in the Amazon Bedrock console and billed as AWS service usage.50* **Claude Enterprise procured through AWS Marketplace:** A [claude.ai](https://claude.ai) plan (the Claude chat product), not an API platform. Managed at claude.ai, and its account and migration behavior differ from what this page describes. See the [Claude Help Center](https://support.claude.com).51* **Direct Anthropic accounts:** The first-party Claude API and claude.ai plans billed by Anthropic. Managed in the Claude Console and at claude.ai.5253## Set up your account5455Setting up Claude Platform on AWS happens in four phases: sign up on the AWS Console service page, complete your Anthropic organization setup, note your workspace ID, and sign in to the Claude Console.5657<Note>58  Signing up through the AWS Console provisions a new Anthropic organization tied to your AWS account. This organization is separate from any existing organizations your company has with Anthropic, including Claude Enterprise organizations procured through AWS Marketplace. API keys, workspaces, and Claude Console settings from a first-party Anthropic organization don't carry over.5960  If you have an existing Amazon Bedrock private offer, contact your Anthropic or AWS account representative before signing up so your discount applies from your first request. Discounts cannot be applied retroactively to usage incurred before your private offer is accepted. See [Private offers](https://platform.claude.com/docs/en/about-claude/pricing#private-offers).61</Note>6263<Steps>64  <Step title="Sign up in the AWS Console">65    1. Open the [AWS Console](https://console.aws.amazon.com/) and navigate to the **Claude Platform on AWS** service page.66    2. Choose **Sign up**.67    3. On the Sign-up page, review the terms (Anthropic's End User License Agreement, the AWS Privacy Notice, and the AWS Customer Agreement) and select the agreement checkbox.68    4. Choose **Continue**.6970    The page shows a **Sign-up in progress** banner. Stay on the page. Sign-up takes a few minutes while AWS handles the AWS Marketplace subscription for you, then redirects you automatically.7172    If your organization has a private offer from Anthropic, the Console looks it up and prompts you to accept it in AWS Marketplace. See [Private offers](https://platform.claude.com/docs/en/about-claude/pricing#private-offers) for details.7374    <Note>75      When you use Claude Platform on AWS, Anthropic processes and stores your content (such as prompts and outputs) on AWS infrastructure. For workspaces created before September 18, 2026, 00:00 UTC, Anthropic might process and store that content outside AWS. Anthropic's [data use policies](https://www.anthropic.com/legal) describe how content and metadata are processed and stored.76    </Note>77  </Step>7879  <Step title="Set up your Anthropic organization">80    After sign-up completes, you're redirected to `platform.claude.com/partner-signup`.8182    1. Enter the email address of your organization's owner and choose **Get started**.83    2. Check that email inbox for a setup link and follow it. If your browser shows a **Signed in as a different account** page, choose **Log out and continue**.84    3. Complete the organization details form (organization name, entity type, country, intended use) and choose **Complete setup**.8586    Completing setup creates your Anthropic organization and accepts Anthropic's Commercial Terms of Service and Usage Policy. The AWS Console service page now shows a left navigation with **Home**, **API keys**, **Quickstart**, and **Workspaces**.87  </Step>8889  <Step title="Create your workspace and note its ID">90    After you complete setup, the AWS Console prompts you to create a workspace. See [Workspaces](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#workspaces) for details on region binding, IAM resource scoping, and creating additional workspaces.9192    Find the workspace ID under **Workspaces** on the AWS Console **Claude Platform on AWS** service page or in the [Claude Console](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#using-the-claude-console). Workspace IDs use the format `wrkspc_` followed by an alphanumeric identifier.93  </Step>9495  <Step title="Sign in to the Claude Console">96    Access to the Claude Console is federated through AWS IAM:9798    1. Assume an IAM role with the `aws-external-anthropic:AssumeConsole` permission. See [IAM actions for Claude Platform on AWS](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions#console-access).99    2. From the **Claude Platform on AWS** service page, choose **Open Claude Console**. The AWS Console issues a JWT and redirects you to `platform.claude.com`.100    3. On first sign-in, you're prompted for an email address. Enter your work email. The platform provisions your Claude Console user just-in-time.101102    When you're signed in through the AWS Console, the Claude Console scopes to your Claude Platform on AWS organization. An **Account managed by AWS** indicator appears in the bottom-left of the Claude Console sidebar.103  </Step>104</Steps>105106### Moving from an existing Anthropic organization107108Signing up for Claude Platform on AWS always provisions a new Anthropic organization tied to your AWS account. There is no in-place conversion: an existing organization, such as a first-party Claude API organization, can't become a Claude Platform on AWS organization.109110Plan a move from an existing organization as a cutover to a new one:111112* **Create the new organization first.** Sign up through the AWS Console (see [Set up your account](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#set-up-your-account)). If your move involves a private offer, complete sign-up before the offer is accepted: discounts apply from acceptance, not retroactively. See [Private offers](https://platform.claude.com/docs/en/about-claude/pricing#private-offers).113* **Recreate access and configuration.** API keys, workspaces, and Claude Console settings don't carry over from an existing organization. Create workspaces in the new organization and switch your applications to [Claude Platform on AWS authentication](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#authentication).114* **Update your integration.** Claude Platform on AWS serves the Claude API (`/v1/{endpoint}`), so request and response shapes are unchanged from the first-party Claude API. What changes is the base URL, the authentication method, and the `anthropic-workspace-id` header on inference and resource requests; see [Making requests](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#making-requests). Some platform features differ; see [Features not supported](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#features-not-supported).115* **Cut over on your own schedule.** The new organization is independent of your existing one, and both can serve traffic in parallel. There's no need for a hard cutover: shift workloads gradually until all of your traffic is on the new organization.116117Once the new organization is running, the differences are concentrated in billing and authentication, which are handled through AWS:118119* **Billing** moves to AWS Marketplace: usage is billed in Claude Consumption Units rather than prepaid credits (see [Billing](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#billing)), and you set spend limits on the Billing page (see [Spend limits](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#spend-limits)). During the transition, billing stays separate: the existing organization continues to be billed as it is today.120* **Authentication and access** move to AWS: requests authenticate with AWS credentials or with API keys generated in the AWS Console, not the Claude Console (see [Authentication](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#authentication)). Organization membership is managed through AWS IAM rather than the Claude Console (see [Available pages](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#available-pages)), and Anthropic's client SDKs provide platform-specific client classes (see [Install an SDK](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#install-an-sdk)).121* **Day-to-day API usage** works the way it does on the first-party Claude API, except where noted in the [feature limitations](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#features-not-supported). Before shifting production traffic, check your rate limits: new organizations are placed on the Start tier, and limit increases go through your Anthropic account representative (see [Rate limits and quotas](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#rate-limits-and-quotas)).122123For Claude Enterprise (claude.ai) organizations, which behave differently, see the [offering comparison](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#claude-platform-on-aws-vs-amazon-bedrock).124125### Troubleshooting account setup126127* **"Sign-up failed: Failed to enable OutboundWebIdentityFederation":** If you see this banner on first submit, choose **Continue** again. The IAM enablement can take a moment to take effect.128* **No progress indicator during sign-up:** Sign-up takes a few minutes. The page shows a static **Sign-up in progress** banner without a progress bar while AWS provisions your account.129* **"Signed in as a different account" after following the setup link:** Choose **Log out and continue**. The page reauthenticates you with the email address you entered.130* **"Not found" message during sign-in:** This message might appear briefly during redirect. You can dismiss it.131* **Usage page shows no data after your first API call:** Usage data can take a few minutes to appear in the Claude Console.132* **"Outbound web identity federation is disabled" on your first API call:** Enable federation once per account. See [Enable outbound web identity federation](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#enable-outbound-web-identity-federation).133134## Before making API calls135136Ensure you have:1371381. An active AWS account with a subscription to Claude Platform on AWS (see [Set up your account](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#set-up-your-account))1392. The [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) installed and configured1403. **Outbound web identity federation enabled** on your AWS account, a one-time setup step (see [Enable outbound web identity federation](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#enable-outbound-web-identity-federation))1414. Your workspace ID (see [Obtain your workspace ID](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#obtain-your-workspace-id))1425. IAM permission to call the API: the `aws-external-anthropic:CreateInference` action on your workspace, plus `aws-external-anthropic:CallWithBearerToken` if you authenticate with an API key (see [IAM policies](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#iam-policies))143144### Enable outbound web identity federation145146The Claude Platform on AWS gateway calls `sts:GetWebIdentityToken` server-side to mint a JWT it forwards to Anthropic. This STS capability is **disabled by default** on every AWS account. Enable it once per account:147148```bash CLI149aws iam enable-outbound-web-identity-federation150```151152If the response is `[ERROR] (FeatureEnabled) ... already enabled`, the setting is already on for your account and you can move on. Verify and retrieve your account's issuer URL:153154```bash CLI155aws iam get-outbound-web-identity-federation-info156```157158<Warning>159  Without this step, every request returns `"Outbound web identity federation is disabled for your account"`. This is the most common setup error.160</Warning>161162### Obtain your workspace ID163164You create a workspace from the AWS Console after completing account setup (see [Set up your account](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#set-up-your-account)). Workspaces are bound to a single AWS region. You can find the workspace ID in the [Claude Console](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#using-the-claude-console) under **Workspaces** or in the **Workspaces** section of the AWS Console service page.165166Set the `ANTHROPIC_AWS_WORKSPACE_ID` and `AWS_REGION` environment variables so the SDK clients read them automatically:167168```bash CLI169export ANTHROPIC_AWS_WORKSPACE_ID='wrkspc_01AbCdEf23GhIj'170export AWS_REGION='us-west-2'  # Your workspace's AWS region171```172173The region is required. The SDK client raises an error if no region is set. Pass `aws_region`/`awsRegion` to the constructor, or set `AWS_REGION` (or `AWS_DEFAULT_REGION`). All AWS commercial regions are supported.174175## Authentication176177Claude Platform on AWS supports two authentication methods: AWS IAM with Signature Version 4 (SigV4) request signing (primary) and API key authentication. Both use the same base URL and request format.178179### SigV4 authentication180181SigV4 is the enterprise-native path and integrates with your existing AWS IAM policies, roles, and auditing. Configure AWS credentials using any method supported by the [AWS default credential provider chain](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html):182183* Environment variables (`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_SESSION_TOKEN`)184* Shared credentials file (`~/.aws/credentials`)185* Shared config file (`~/.aws/config`) including SSO and `credential_process`186* Web identity (`AWS_WEB_IDENTITY_TOKEN_FILE` and `AWS_ROLE_ARN`) for IRSA and GitHub Actions187* ECS container credentials188* EC2 instance metadata service (IMDS)189190Verify that your credentials are working:191192```bash CLI193aws sts get-caller-identity194```195196### API key authentication197198For simpler integration paths (local development and scripts), you can authenticate with an API key instead of SigV4. Set the `ANTHROPIC_AWS_API_KEY` environment variable or pass `apiKey` to the SDK constructor.199200Generate API keys in the **AWS Console** under **Claude Platform on AWS → API keys**. Choose **Generate a key**, then copy the key value. Grant the `aws-external-anthropic:CallWithBearerToken` IAM action to the principals that should be allowed to use API key authentication.201202<Note>203  API keys for Claude Platform on AWS are managed in the AWS Console, not the Claude Console. Keys created in the standard [Claude Console](https://platform.claude.com/) (for first-party API access) don't work with the Claude Platform on AWS endpoint.204</Note>205206#### Short-term API keys207208For workloads that need to hand a credential to a separate process (such as an LLM gateway, a serverless function, or a tool that supports bearer-token authentication but not SigV4), generate a short-term API key from your AWS credentials instead of provisioning a long-lived key in the AWS Console.209210AWS publishes token-generator libraries for [JavaScript](https://github.com/aws/token-generator-for-aws-external-anthropic-js), [Python](https://github.com/aws/token-generator-for-aws-external-anthropic-python), and [Java](https://github.com/aws/token-generator-for-aws-external-anthropic-java). Each library reads your AWS credentials through the standard provider chain and returns a time-limited token that works with the `x-api-key` header. Token lifetime defaults to 12 hours and is capped at the lesser of your requested duration, your AWS credentials' expiry, and 12 hours. See the linked repository READMEs for installation and full configuration options.211212Pass the generated token to the SDK the same way you'd pass an AWS Console-generated API key:213214<CodeGroup exclude="shell, csharp, go, php, ruby">215  ```python Python216  from token_generator_for_aws_external_anthropic import TokenGenerator217  from anthropic import AnthropicAWS218219  token = TokenGenerator(region="us-west-2").get_token()220221  client = AnthropicAWS(api_key=token, aws_region="us-west-2")222  ```223224  ```typescript TypeScript225  import { getTokenProvider } from "@aws/token-generator-for-aws-external-anthropic";226  import AnthropicAws from "@anthropic-ai/aws-sdk";227228  const tokenProvider = getTokenProvider({ region: "us-west-2" });229  const token = await tokenProvider();230231  const client = new AnthropicAws({ apiKey: token, awsRegion: "us-west-2" });232  ```233234  ```java Java235  import software.amazon.awsexternalanthropic.TokenGenerator;236  import software.amazon.awssdk.regions.Region;237  import com.anthropic.aws.backends.AwsBackend;238  import com.anthropic.client.AnthropicClient;239  import com.anthropic.client.okhttp.AnthropicOkHttpClient;240241  void main() {242      String token = TokenGenerator.builder().region(Region.US_WEST_2).build().getToken();243244      AnthropicClient client = AnthropicOkHttpClient.builder()245          .backend(AwsBackend.builder()246              .apiKey(token)247              .region(Region.US_WEST_2)248              .workspaceId(System.getenv("ANTHROPIC_AWS_WORKSPACE_ID"))249              .build())250          .build();251  }252  ```253</CodeGroup>254255If you can generate the token locally, your process already has SigV4 credentials, and SigV4 authentication is usually the simpler choice. Use short-term keys when the process making API calls is separate from the process that holds AWS credentials.256257The SDK does not refresh short-term keys automatically. When a token expires, generate a new one and construct a new client. The principal that uses the token still needs the `aws-external-anthropic:CallWithBearerToken` IAM action.258259### Credential precedence260261The platform-specific client resolves authentication in the following order. Argument names vary by language convention: TypeScript and PHP use camelCase as shown, Python and Ruby use snake\_case, Go uses PascalCase with capitalized acronyms, and C# and Java use the language's property or builder idioms.2622631. `apiKey` constructor argument → `x-api-key` header2642. `awsAccessKey` + `awsSecretAccessKey` constructor arguments → AWS SigV42653. `awsProfile` constructor argument → AWS SigV4 with named profile2664. `ANTHROPIC_AWS_API_KEY` environment variable → `x-api-key` header2675. Default AWS credential provider chain → AWS SigV4268269### Region resolution270271The client reads `AWS_REGION` from the environment if `aws_region`/`awsRegion` is not passed to the constructor, falling back to `AWS_DEFAULT_REGION` for compatibility with the standard AWS SDKs. Region is required and there is no default: the `AnthropicAWS`/`AnthropicAws` client raises an error if neither the constructor argument nor an environment variable is set.272273## Install an SDK274275Anthropic's [client SDKs](https://platform.claude.com/docs/en/cli-sdks-libraries/overview) support Claude Platform on AWS. Each SDK provides a platform-specific client class that handles SigV4 signing, region-based base URL construction, and the `anthropic-workspace-id` header.276277<Tabs>278  <Tab title="Python">279    ```bash280    pip install -U "anthropic[aws]"281    ```282283    <Tip>284      On macOS with Homebrew Python or other externally managed Python environments, `pip install` can fail with a PEP 668 `externally-managed-environment` error. Create and activate a virtual environment first: `python3 -m venv .venv && source .venv/bin/activate`.285    </Tip>286  </Tab>287288  <Tab title="TypeScript">289    ```bash290    npm install @anthropic-ai/aws-sdk291    ```292  </Tab>293294  <Tab title="C#">295    ```bash296    dotnet add package Anthropic.Aws297    ```298  </Tab>299300  <Tab title="Go">301    ```bash302    go get github.com/anthropics/anthropic-sdk-go303    ```304  </Tab>305306  <Tab title="Java">307    ```kotlin Gradle308    implementation("com.anthropic:anthropic-java:2.63.0")309    implementation("com.anthropic:anthropic-java-aws:2.63.0")310    ```311312    ```xml Maven313    <dependency>314      <groupId>com.anthropic</groupId>315      <artifactId>anthropic-java</artifactId>316      <version>2.63.0</version>317    </dependency>318    <dependency>319      <groupId>com.anthropic</groupId>320      <artifactId>anthropic-java-aws</artifactId>321      <version>2.63.0</version>322    </dependency>323    ```324  </Tab>325326  <Tab title="PHP">327    ```bash328    composer require anthropic-ai/sdk aws/aws-sdk-php329    ```330  </Tab>331332  <Tab title="Ruby">333    ```bash334    gem install anthropic aws-sdk-core335    ```336  </Tab>337</Tabs>338339<Note>340  SDK clients for Claude Platform on AWS are in beta.341</Note>342343## Available models344345The following models are available on Claude Platform on AWS:346347| Model             | Model ID            |348| :---------------- | :------------------ |349| Claude Fable 5.1  | `claude-fable-5-1`  |350| Claude Fable 5    | `claude-fable-5`    |351| Claude Opus 5     | `claude-opus-5`     |352| Claude Opus 4.8   | `claude-opus-4-8`   |353| Claude Opus 4.7   | `claude-opus-4-7`   |354| Claude Opus 4.6   | `claude-opus-4-6`   |355| Claude Opus 4.5   | `claude-opus-4-5`   |356| Claude Sonnet 5   | `claude-sonnet-5`   |357| Claude Sonnet 4.6 | `claude-sonnet-4-6` |358| Claude Sonnet 4.5 | `claude-sonnet-4-5` |359| Claude Haiku 4.5  | `claude-haiku-4-5`  |360361Model IDs are identical to the first-party Claude API. There are no Bedrock-style ARNs or `anthropic.` prefixes.362363New models typically launch on Claude Platform on AWS the same day as the first-party Claude API.364365<Tip>366  Upgrading to a newer Claude model? In Claude Code, run `/claude-api migrate` to apply model ID swaps and breaking parameter changes across your codebase. The skill detects which cloud platform your code targets and adjusts model ID formats and feature changes for that platform. See [Migrating to a newer Claude model](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/claude-api-skill#migrating-to-a-newer-claude-model).367</Tip>368369## Making requests370371Claude Platform on AWS uses the same API endpoints as the first-party Claude API. The differences are the base URL, the authentication method, and the `anthropic-workspace-id` header, which identifies the [workspace](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#workspaces) a request targets. The header is required on inference and resource requests, such as calls to the Messages API, Models API, Files API, and Claude Managed Agents endpoints. Requests to the [Admin API](https://platform.claude.com/docs/en/manage-claude/admin-api) workspace and external key endpoints don't require it.372373Before running these examples, complete the steps in [Before making API calls](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#before-making-api-calls).374375<CodeGroup>376  ```bash cURL377  # Replace us-west-2 with your AWS region in both the URL and --aws-sigv4378  # Omit the x-amz-security-token header if you use long-term IAM user credentials379  curl "https://aws-external-anthropic.us-west-2.api.aws/v1/messages" \380    --aws-sigv4 "aws:amz:us-west-2:aws-external-anthropic" \381    --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \382    -H "x-amz-security-token: $AWS_SESSION_TOKEN" \383    -H "content-type: application/json" \384    -H "anthropic-version: 2023-06-01" \385    -H "anthropic-workspace-id: $ANTHROPIC_AWS_WORKSPACE_ID" \386    -d '{387      "model": "claude-sonnet-5",388      "max_tokens": 1024,389      "messages": [390        {"role": "user", "content": "Hello!"}391      ]392    }'393  ```394395  ```bash CLI396  # Replace us-west-2 with your AWS region397  # ant reads ANTHROPIC_API_KEY and sends it as x-api-key. Generate a key in the398  # AWS Console (see API key authentication).399  export ANTHROPIC_API_KEY="YOUR_AWS_API_KEY"400401  ant messages create \402    --base-url https://aws-external-anthropic.us-west-2.api.aws \403    --workspace-id "$ANTHROPIC_AWS_WORKSPACE_ID" \404    --model claude-sonnet-5 \405    --max-tokens 1024 \406    --message '{role: user, content: "Hello!"}' \407    --transform content408  ```409410  ```python Python411  from anthropic import AnthropicAWS412413  client = AnthropicAWS()414415  message = client.messages.create(416      model="claude-sonnet-5",417      max_tokens=1024,418      messages=[{"role": "user", "content": "Hello!"}],419  )420  print(message)421  ```422423  ```typescript TypeScript424  import AnthropicAws from "@anthropic-ai/aws-sdk";425426  const client = new AnthropicAws();427428  const message = await client.messages.create({429    model: "claude-sonnet-5",430    max_tokens: 1024,431    messages: [{ role: "user", content: "Hello!" }]432  });433  console.log(message);434  ```435436  ```csharp C#437  using Anthropic;438  using Anthropic.Aws;439440  var client = new AnthropicAwsClient();441442  var message = await client.Messages.Create(new()443  {444      Model = Model.ClaudeSonnet5,445      MaxTokens = 1024,446      Messages = [new() { Role = Role.User, Content = "Hello!" }]447  });448449  Console.WriteLine(message);450  ```451452  ```go Go453  client, err := anthropicaws.NewClient(context.Background(), anthropicaws.ClientConfig{})454  if err != nil {455  	panic(err)456  }457458  message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{459  	Model:     anthropic.ModelClaudeSonnet5,460  	MaxTokens: 1024,461  	Messages: []anthropic.MessageParam{462  		anthropic.NewUserMessage(anthropic.NewTextBlock("Hello!")),463  	},464  })465  if err != nil {466  	panic(err)467  }468469  fmt.Println(message)470  ```471472  ```java Java473  import com.anthropic.aws.backends.AwsBackend;474  import com.anthropic.client.AnthropicClient;475  import com.anthropic.client.okhttp.AnthropicOkHttpClient;476  import com.anthropic.models.messages.Message;477  import com.anthropic.models.messages.MessageCreateParams;478  import com.anthropic.models.messages.Model;479480  void main() {481      AnthropicClient client = AnthropicOkHttpClient.builder()482          .backend(AwsBackend.fromEnv())483          .build();484485      Message message = client.messages().create(486          MessageCreateParams.builder()487              .model(Model.CLAUDE_SONNET_5)488              .maxTokens(1024)489              .addUserMessage("Hello!")490              .build()491      );492493      IO.println(message);494  }495  ```496497  ```php PHP498  use Anthropic\Aws\Client;499500  $client = new Client();501502  $message = $client->messages->create(503      model: 'claude-sonnet-5',504      maxTokens: 1024,505      messages: [['role' => 'user', 'content' => 'Hello!']],506  );507508  echo $message;509  ```510511  ```ruby Ruby512  require "anthropic"513514  client = Anthropic::AWSClient.new515516  message = client.messages.create(517    model: "claude-sonnet-5",518    max_tokens: 1024,519    messages: [{ role: "user", content: "Hello!" }]520  )521522  puts message523  ```524</CodeGroup>525526The client reads `AWS_REGION` (or `AWS_DEFAULT_REGION`) and `ANTHROPIC_AWS_WORKSPACE_ID` from the environment. You can override either by passing `aws_region` / `awsRegion` or `workspace_id` / `workspaceId` to the constructor. Both region and workspace ID are required. The constructor raises an error if either cannot be resolved.527528<Note>529  The `x-amz-security-token` header (cURL) is only required for temporary credentials such as IAM roles, SSO, or STS. Omit it when using long-term IAM user credentials. The SDK clients handle this automatically based on the credential source.530</Note>531532The `--aws-sigv4` value follows the format `aws:amz:<region>:<service>`. The SigV4 service name is `aws-external-anthropic`, and the region must match the region in your endpoint URL. A mismatch in either produces a generic signature-rejection error rather than a specific diagnostic.533534### Context window535536Context-window sizes on Claude Platform on AWS are identical to the first-party Claude API. See [Context windows](https://platform.claude.com/docs/en/build-with-claude/context-windows) for per-model limits.537538## Feature support539540Claude Platform on AWS uses Claude API endpoints directly, which means you get full feature parity with the first-party Claude API (except where noted in the [feature limitations](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#features-not-supported)):541542* **Feature access:** Because Anthropic operates both platforms, most new features and beta headers become available on Claude Platform on AWS without a separate integration step. See [feature limitations](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#features-not-supported) for exceptions.543* **Beta features:** Pass the standard `anthropic-beta` header to access beta features, just as you would with the Claude API.544* **Agent Skills:** Use pre-built and custom [Agent Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) with the same `container.skills` parameter as the Claude API. All pre-built Skills (PowerPoint, Excel, Word, PDF) work out of the box.545* **Code execution:** Run code in Anthropic's managed sandbox using the [code execution tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool).546* **Tool use:** Computer use and all other [tool use capabilities](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) are available.547* **Extended thinking:** Enable extended thinking with the same parameters as the Claude API.548* **Streaming:** Full SSE streaming support for real-time responses.549* **Batch processing:** Submit batch requests for high-throughput workloads.550* **Prompt caching:** Cache tools, system prompts, and message history to reduce latency and cost. All prompt caching capabilities (5-minute TTL, 1-hour TTL, and automatic caching) are available.551* **Files API:** Upload and reference files across requests.552* **Customer-managed encryption keys (CMEK):** [CMEK](https://platform.claude.com/docs/en/manage-claude/cmek) is available with [AWS KMS](https://platform.claude.com/docs/en/manage-claude/cmek-aws-kms) keys only. Google Cloud KMS and Azure Key Vault keys cannot be registered. The key must be a single-region KMS key in the same AWS account and region as the workspace it is attached to, and its key policy must grant access to the `aws-external-anthropic.amazonaws.com` service principal; see [Set up CMEK on Claude Platform on AWS](https://platform.claude.com/docs/en/manage-claude/cmek-aws-kms#claude-platform-on-aws). Register and attach keys in the [Claude Console](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#using-the-claude-console); the external key endpoints are also available, authorized through [IAM actions](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions#encryption-keys). There is no separate validation step: the key is implicitly validated when you attach it to a workspace (the attach call performs an encrypt/decrypt round), so a key policy problem surfaces at attach time rather than at registration.553* **Compliance API:** The [Compliance API](https://platform.claude.com/docs/en/manage-claude/compliance-api) is available. Access is authorized through the AWS IAM [`ListComplianceActivities` action](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions#compliance).554555See the [comparison table](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#claude-platform-on-aws-vs-amazon-bedrock) for feature-availability differences from Amazon Bedrock.556557### Claude Managed Agents558559[Claude Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) is available on Claude Platform on AWS, including [agents](https://platform.claude.com/docs/en/managed-agents/agent-setup), [environments](https://platform.claude.com/docs/en/managed-agents/environments), [sessions](https://platform.claude.com/docs/en/managed-agents/sessions), [credential vaults](https://platform.claude.com/docs/en/managed-agents/vaults), [memory stores](https://platform.claude.com/docs/en/managed-agents/memory), [webhooks](https://platform.claude.com/docs/en/managed-agents/webhooks), [multiagent orchestration](https://platform.claude.com/docs/en/managed-agents/multiagent-orchestration), and [self-hosted sandboxes](https://platform.claude.com/docs/en/managed-agents/self-hosted-sandboxes).560561Session behavior on Claude Platform on AWS differs from first-party Claude Managed Agents in two ways:562563* **Autonomous-session reauthentication:** A session can run autonomously, without any [user events](https://platform.claude.com/docs/en/managed-agents/reference#event-types), for up to 6 hours. After 6 hours, the session requires reauthentication before it continues. To reauthenticate, send any user-role event to the session (see [Events and streaming](https://platform.claude.com/docs/en/managed-agents/events-and-streaming)). First-party Claude Managed Agents has no autonomous-session runtime limit.564* **[Memory stores on self-hosted environments](https://platform.claude.com/docs/en/managed-agents/self-hosted-sandboxes#use-memory-stores):** A session that runs on a self-hosted environment cannot attach memory stores; a session that includes one is rejected at creation. Sessions on cloud environments attach memory stores as usual. On first-party Claude Managed Agents, sessions on both cloud and self-hosted environments can attach memory stores.565566### Features not supported567568The following capabilities are not currently available on Claude Platform on AWS:569570* **HIPAA readiness:** Anthropic's HIPAA-ready program is not available. See [API and data retention](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention).571* **Computer use and browser use toolsets:** `computer_toolset_20260801` and `browser_toolset_20260801` are not currently available on Claude Platform on AWS. The beta [computer use](https://platform.claude.com/docs/en/agents-and-tools/tool-use/computer-use-tool#earlier-tool-versions) tool versions remain available.572573- **Admin API:** Workspace endpoints (create, get, list, update, and archive on `/v1/organizations/workspaces`) and external key endpoints (register, get, list, update, and delete on `/v1/organizations/external_keys`, for [CMEK](https://platform.claude.com/docs/en/manage-claude/cmek); keys are validated when attached to a workspace rather than through a validate endpoint) are available. Other Admin API endpoints (organization members, workspace members, invites, API keys, usage reports, cost reports, and rate limit reports) are not currently available. View usage and cost data in the [Claude Console](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#using-the-claude-console) instead. AWS IAM manages organization membership.574- **Workspace member management:** Adding or removing users from individual workspaces is not available. AWS IAM policies on workspace ARNs control access.575- **Claude Code workspace and Analytics API:** The Claude Code workspace with automatic rate limits is not available. Claude Code usage appears in the general usage view rather than a dedicated screen.576- **OAuth authentication:** Not supported. Use SigV4 or API key authentication.577- **Fast mode:** Not available on Claude Platform on AWS.578- **OpenAI-compatible API endpoints:** Not available on Claude Platform on AWS.579- **MCP tunnels:** Only MCP servers exposed over the public internet are supported.580581## Data residency582583Claude Platform on AWS supports the following inference geographies:584585* **US:** Inference stays within US data centers. A 1.1x pricing multiplier applies.586* **Global:** Inference can route to any Anthropic-operated data center worldwide. Standard pricing applies.587588<Note>589  The AWS region your workspace is bound to controls which gateway endpoint you call and where AWS-side resources (IAM, CloudTrail, billing) are scoped. It does not pin where model inference runs. To pin inference to a specific geography, set `inference_geo` on each request or configure a workspace default.590</Note>591592Set the inference geography per request with the `inference_geo` parameter:593594<Note>595  The `inference_geo` parameter is supported on Claude 4.6 and later models. Requests with `inference_geo` on Claude Opus 4.5, Claude Sonnet 4.5, or Claude Haiku 4.5 return a 400 error. See [Data residency](https://platform.claude.com/docs/en/manage-claude/data-residency) for model availability details.596</Note>597598<CodeGroup>599  ```bash cURL600  # Replace us-west-2 with your AWS region in both the URL and --aws-sigv4601  # Omit the x-amz-security-token header if you use long-term IAM user credentials602  curl "https://aws-external-anthropic.us-west-2.api.aws/v1/messages" \603    --aws-sigv4 "aws:amz:us-west-2:aws-external-anthropic" \604    --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \605    -H "x-amz-security-token: $AWS_SESSION_TOKEN" \606    -H "content-type: application/json" \607    -H "anthropic-version: 2023-06-01" \608    -H "anthropic-workspace-id: $ANTHROPIC_AWS_WORKSPACE_ID" \609    -d '{610      "model": "claude-sonnet-5",611      "max_tokens": 1024,612      "inference_geo": "us",613      "messages": [614        {"role": "user", "content": "Hello!"}615      ]616    }'617  ```618619  ```bash CLI620  # Replace us-west-2 with your AWS region621  # ant reads ANTHROPIC_API_KEY and sends it as x-api-key. Generate a key in the622  # AWS Console (see API key authentication).623  export ANTHROPIC_API_KEY="YOUR_AWS_API_KEY"624625  ant messages create \626    --base-url https://aws-external-anthropic.us-west-2.api.aws \627    --workspace-id "$ANTHROPIC_AWS_WORKSPACE_ID" \628    --model claude-sonnet-5 \629    --max-tokens 1024 \630    --inference-geo us \631    --message '{role: user, content: "Hello!"}' \632    --transform content633  ```634635  ```python Python636  from anthropic import AnthropicAWS637638  client = AnthropicAWS()639  message = client.messages.create(640      model="claude-sonnet-5",641      max_tokens=1024,642      inference_geo="us",643      messages=[{"role": "user", "content": "Hello!"}],644  )645  print(message)646  ```647648  ```typescript TypeScript649  import AnthropicAws from "@anthropic-ai/aws-sdk";650  const client = new AnthropicAws();651  const message = await client.messages.create({652    model: "claude-sonnet-5",653    max_tokens: 1024,654    inference_geo: "us",655    messages: [{ role: "user", content: "Hello!" }]656  });657  console.log(message);658  ```659660  ```csharp C#661  using Anthropic;662  using Anthropic.Aws;663664  var client = new AnthropicAwsClient();665666  var message = await client.Messages.Create(new()667  {668      Model = Model.ClaudeSonnet5,669      MaxTokens = 1024,670      InferenceGeo = "us",671      Messages = [new() { Role = Role.User, Content = "Hello!" }]672  });673674  Console.WriteLine(message);675  ```676677  ```go Go678  client, err := anthropicaws.NewClient(context.Background(), anthropicaws.ClientConfig{})679  if err != nil {680  	panic(err)681  }682683  message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{684  	Model:        anthropic.ModelClaudeSonnet5,685  	MaxTokens:    1024,686  	InferenceGeo: anthropic.String("us"),687  	Messages: []anthropic.MessageParam{688  		anthropic.NewUserMessage(anthropic.NewTextBlock("Hello!")),689  	},690  })691  if err != nil {692  	panic(err)693  }694695  fmt.Println(message)696  ```697698  ```java Java699  import com.anthropic.aws.backends.AwsBackend;700  import com.anthropic.client.AnthropicClient;701  import com.anthropic.client.okhttp.AnthropicOkHttpClient;702  import com.anthropic.models.messages.Message;703  import com.anthropic.models.messages.MessageCreateParams;704  import com.anthropic.models.messages.Model;705706  void main() {707      AnthropicClient client = AnthropicOkHttpClient.builder()708          .backend(AwsBackend.fromEnv())709          .build();710711      Message message = client.messages().create(712          MessageCreateParams.builder()713              .model(Model.CLAUDE_SONNET_5)714              .maxTokens(1024)715              .inferenceGeo("us")716              .addUserMessage("Hello!")717              .build()718      );719720      IO.println(message);721  }722  ```723724  ```php PHP725  use Anthropic\Aws\Client;726727  $client = new Client();728729  $message = $client->messages->create(730      model: 'claude-sonnet-5',731      maxTokens: 1024,732      inferenceGeo: 'us',733      messages: [['role' => 'user', 'content' => 'Hello!']],734  );735736  echo $message;737  ```738739  ```ruby Ruby740  require "anthropic"741742  client = Anthropic::AWSClient.new743744  message = client.messages.create(745    model: "claude-sonnet-5",746    max_tokens: 1024,747    inference_geo: "us",748    messages: [{ role: "user", content: "Hello!" }]749  )750751  puts message752  ```753</CodeGroup>754755If you omit `inference_geo`, the request uses the workspace's `default_inference_geo` if one is configured, otherwise `global`.756757Workspace-level inference geography controls (`allowed_inference_geos` and `default_inference_geo`) are also available on Claude Platform on AWS. See [Workspace-level restrictions](https://platform.claude.com/docs/en/manage-claude/data-residency#workspace-level-restrictions).758759## Workspaces760761Inference and resource requests on Claude Platform on AWS target a workspace. You pass the workspace's ID in the `anthropic-workspace-id` header on these API calls. Workspace IDs use the tagged format `wrkspc_` followed by an alphanumeric identifier (for example, `wrkspc_01AbCdEf23GhIj`). See [Obtain your workspace ID](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#obtain-your-workspace-id) if you don't have it yet.762763### Workspace scoping764765Workspaces are bound to a single AWS region. A workspace created in `us-west-2` can only be accessed through the `us-west-2` endpoint. Usage, quotas, cost, files, batches, and Skills all roll up per workspace, giving you per-region breakdowns in the Claude Console.766767Workspaces also serve as the primary IAM resource for Claude Platform on AWS. You grant or deny access to specific workspaces through AWS IAM policies using the workspace ARN. The ARN's resource segment is the same `wrkspc_`-prefixed ID you pass in the `anthropic-workspace-id` header:768769```text wrap770arn:aws:aws-external-anthropic:{region}:{account-id}:workspace/{workspace-id}771```772773For example:774775```text wrap776arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj777```778779See [IAM policies](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#iam-policies) for policy examples.780781### Managing workspaces782783Create additional workspaces, rename a workspace, or archive a workspace from the AWS Console **Workspaces** page or with the [Admin API](https://platform.claude.com/docs/en/manage-claude/admin-api) workspace endpoints. These endpoints don't require the `anthropic-workspace-id` header. Create and list act on the organization; get, update, and archive take the workspace ID in the URL path. A new workspace is bound to the AWS region of the endpoint you call to create it (see [Workspace scoping](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#workspace-scoping)). With the Admin role, you can also create, rename, and archive workspaces from the Claude Console **Workspaces** page.784785## Using the Claude Console786787Claude Platform on AWS uses the standard Claude Console at [platform.claude.com](https://platform.claude.com). When you sign in from the AWS Console, an **Account managed by AWS** indicator appears in the bottom-left of the Claude Console sidebar and the Console scopes to your Claude Platform on AWS organization. It provides usage analytics, cost breakdowns, rate limit visibility, workspace management, and pages for managing files, Agent Skills, batch jobs, and Claude Managed Agents resources (agents, sessions, environments, credential vaults, memory stores, and webhooks).788789### Signing in790791Access to the Claude Console is federated through AWS IAM. See [Set up your account](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#set-up-your-account) for the full first-time sign-in flow. In short:7927931. Assume an IAM role with the `aws-external-anthropic:AssumeConsole` permission. See [IAM actions for Claude Platform on AWS](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions#console-access).7942. Navigate to the Claude Platform on AWS page in the [AWS Console](https://console.aws.amazon.com/).7953. Choose **Open Claude Console**. The AWS Console issues a JWT and redirects you to `platform.claude.com`.7964. On first sign-in, you're prompted for an email address. Enter your work email. The platform provisions your Claude Console user just-in-time.797798Two Claude Console roles are available: **Admin** and **Developer**. The Admin role grants access to all Claude Console pages and settings available for Claude Platform on AWS. The Developer role grants read access to usage, cost, rate limit, and workspace information. Contact your Anthropic account representative to assign the Admin or Developer role to a principal.799800### Available pages801802The **Through AWS gateway** column indicates whether the page reads and writes data through the AWS gateway (and is therefore governed by [IAM actions](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions)). Pages marked **No** read organization-level metadata directly from Anthropic and bypass IAM action checks.803804| Page                  | Available     | Through AWS gateway       | Notes                                                                                                                                                                                                                                                           |805| --------------------- | ------------- | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |806| **Usage**             | Yes           | No                        | View token usage by model, workspace, and dimension. Data can take a few minutes to appear after a request.                                                                                                                                                     |807| **Cost**              | Yes           | No                        | View cost breakdowns by model and workspace. AWS Cost Explorer shows the aggregated [Claude Consumption Unit (CCU)](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#billing) line item.                                            |808| **Rate limits**       | Yes           | No                        | View rate limits (read-only). Tier increases go through your Anthropic account representative; see [Rate limits and quotas](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#rate-limits-and-quotas).                               |809| **Workspaces**        | Yes           | Yes (except spend limits) | View per-region workspaces. With the Admin role, you can also create, rename, and archive workspaces, and set per-workspace [spend limits](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#spend-limits).                          |810| **Encryption keys**   | Yes           | Yes                       | Under **Settings → Encryption keys**, register AWS KMS keys for [CMEK](https://platform.claude.com/docs/en/manage-claude/cmek-aws-kms#claude-platform-on-aws) (Admin role). Attach a registered key to a workspace from that workspace's **Security** settings. |811| **Files**             | Yes           | Yes                       | View and manage uploaded files.                                                                                                                                                                                                                                 |812| **Skills**            | Yes           | Yes                       | View and manage Agent Skills.                                                                                                                                                                                                                                   |813| **Batches**           | Yes           | Yes                       | View and manage batch processing jobs.                                                                                                                                                                                                                          |814| **Agents**            | Yes           | Yes                       | View and manage agent definitions.                                                                                                                                                                                                                              |815| **Sessions**          | Yes           | Yes                       | View agent sessions and event history.                                                                                                                                                                                                                          |816| **Environments**      | Yes           | Yes                       | View and manage cloud sandbox configurations for sessions.                                                                                                                                                                                                      |817| **Credential vaults** | Yes           | Yes                       | View and manage credential vaults for session authentication.                                                                                                                                                                                                   |818| **Memory stores**     | Yes           | Yes                       | View and manage persistent agent memory.                                                                                                                                                                                                                        |819| **Webhooks**          | Yes           | Yes                       | View and manage webhook endpoints under **Settings → Webhooks**.                                                                                                                                                                                                |820| **API keys**          | No            | N/A                       | Manage API keys in the AWS Console (**Claude Platform on AWS → API keys**). See [API key authentication](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#api-key-authentication).                                                  |821| **Members**           | No            | N/A                       | Not applicable. AWS IAM manages access.                                                                                                                                                                                                                         |822| **Billing**           | Yes (limited) | No                        | Set an organization monthly spend limit; see [Spend limits](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#spend-limits). AWS Marketplace manages invoicing. View cost breakdowns on the Cost page.                               |823| **Claude Code**       | No            | N/A                       | View Claude Code usage on the Usage page.                                                                                                                                                                                                                       |824825### Switching organizations826827The Claude Console does not support organization switching for Claude Platform on AWS. To access a different organization, sign out and reauthenticate through the AWS Console using the IAM role for that organization's AWS account.828829## Rate limits and quotas830831Organizations on Claude Platform on AWS are placed on the Start tier. Anthropic manages rate limits directly, not through AWS quota systems.832833Organizations on Claude Platform on AWS can move to a higher usage tier automatically as they build a history of paid AWS Marketplace invoices. The self-service **Request rate limit increase** flow in the Claude Console is not available: the Rate limits page directs you to your Anthropic account representative instead.834835To request higher limits, contact your Anthropic account representative or [Anthropic support](https://support.claude.com). Include the following in your request:836837* The models you need raised838* Peak input tokens per minute and output tokens per minute for each model (not daily totals)839* The approximate share of your input that is cached or repeated context (cache reads don't count toward input-token limits for most models; see [cache-aware ITPM](https://platform.claude.com/docs/en/api/rate-limits#cache-aware-itpm))840841Usage tiers are fixed steps: each tier pairs rate limits with a [monthly spend cap](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#spend-limits), and moving to a higher tier raises both. For tier details and per-model limits, see [Rate limits](https://platform.claude.com/docs/en/api/rate-limits).842843## Billing844845Claude Platform on AWS bills through [AWS Marketplace](https://aws.amazon.com/marketplace). Usage is denominated in Claude Consumption Units (CCUs), metered hourly, and invoiced monthly in arrears on your AWS bill. CCUs are not prepaid credits. There is no CCU balance or commitment.846847For the CCU price, conversion mechanics, discount application, and per-model token rates, see [Claude Platform on AWS pricing](https://platform.claude.com/docs/en/about-claude/pricing#claude-platform-on-aws-pricing).848849### Spend limits850851The Start, Build, and Scale usage tiers each carry a monthly spend cap; see the [per-tier spend caps](https://platform.claude.com/docs/en/api/rate-limits#spend-limits) for current values. When your organization's usage for the calendar month reaches its tier's cap, API requests fail with the [spend-cap error](https://platform.claude.com/docs/en/api/rate-limits#reaching-your-spend-cap) until 00:00 UTC on the first day of the next month, and retrying sooner doesn't succeed. The spend cap and rate limits belong to the same tier. To raise the cap, or to restore access after reaching it, request a tier increase through your Anthropic account representative or [Anthropic support](https://support.claude.com) (see [Rate limits and quotas](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#rate-limits-and-quotas)).852853You can also set your own monthly spend limits below the cap, after adding at least one recipient under **Email recipients** on the Billing page:854855* **Organization spend limit:** Go to [Settings > Billing](https://platform.claude.com/settings/billing) in the [Claude Console](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#using-the-claude-console) to set a monthly spend limit.856* **Workspace spend limits:** Select a workspace under [Settings > Workspaces](https://platform.claude.com/settings/workspaces) and open its **Spend limits** page.857858When usage reaches a limit you set, requests fail with HTTP 400 (see the [spend limit error](https://platform.claude.com/docs/en/api/rate-limits#setting-your-own-spend-limit)) until 00:00 UTC on the first day of the next month, or until you raise or remove the limit.859860Spend is calculated at list prices and can take about 2 hours to reflect recent usage, so usage can exceed the cap or a limit before requests start failing. The overshoot is billed. When the tier cap or an organization spend limit stops your requests, an email notice goes to the recipients listed under **Email recipients** on the Billing page. Role-based recipients, such as all admins, aren't available on Claude Platform on AWS. The tier-cap notice also goes to the email address used at AWS Marketplace sign-up.861862## Monitoring and logging863864AWS CloudTrail can capture all requests to Claude Platform on AWS. Workspace, external key, compliance, vault, and webhook operations are logged as Management events by default. Inference, batch, file, skill, model, user profile, and Claude Managed Agents operations (other than vaults and webhooks) are classified as Data events and require explicit data event logging configuration, which incurs additional CloudTrail charges. See the [IAM actions reference](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions#route-to-action-mapping) for the full event type classification and the [AWS CloudTrail documentation](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/) for configuration details.865866### Request IDs867868Each response includes two request IDs in the response headers:869870* **AWS request ID (`x-amzn-requestid`):** The primary ID, indexed in CloudTrail. Use this when investigating requests through AWS tooling or when contacting AWS support.871* **Anthropic request ID (`request-id`):** The secondary ID. Use this when contacting Anthropic support.872873<CodeGroup>874  ```bash cURL875  # Replace us-west-2 with your AWS region in both the URL and --aws-sigv4876  # -i includes the response headers in the output877  # Omit the x-amz-security-token header if you use long-term IAM user credentials878  curl -i "https://aws-external-anthropic.us-west-2.api.aws/v1/messages" \879    --aws-sigv4 "aws:amz:us-west-2:aws-external-anthropic" \880    --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \881    -H "x-amz-security-token: $AWS_SESSION_TOKEN" \882    -H "content-type: application/json" \883    -H "anthropic-version: 2023-06-01" \884    -H "anthropic-workspace-id: $ANTHROPIC_AWS_WORKSPACE_ID" \885    -d '{886      "model": "claude-sonnet-5",887      "max_tokens": 1024,888      "messages": [889        {"role": "user", "content": "Hello!"}890      ]891    }'892  ```893894  ```bash CLI895  # The ant CLI's output formats print the response body, not response headers.896  # To read x-amzn-requestid, use the cURL example (-i) or an SDK example.897  ```898899  ```python Python900  from anthropic import AnthropicAWS901902  client = AnthropicAWS()903904  response = client.messages.with_raw_response.create(905      model="claude-sonnet-5",906      max_tokens=1024,907      messages=[{"role": "user", "content": "Hello!"}],908  )909910  print(response.headers.get("x-amzn-requestid"))  # AWS request ID911  print(response.headers.get("request-id"))  # Anthropic request ID912913  message = response.parse()914  print(message.content)915  ```916917  ```typescript TypeScript918  import AnthropicAws from "@anthropic-ai/aws-sdk";919920  const client = new AnthropicAws();921922  const { data: message, response } = await client.messages923    .create({924      model: "claude-sonnet-5",925      max_tokens: 1024,926      messages: [{ role: "user", content: "Hello!" }]927    })928    .withResponse();929930  console.log(response.headers.get("x-amzn-requestid")); // AWS request ID931  console.log(response.headers.get("request-id")); // Anthropic request ID932  console.log(message.content);933  ```934935  ```csharp C#936  using Anthropic;937  using Anthropic.Aws;938939  var client = new AnthropicAwsClient();940941  var response = await client.WithRawResponse.Messages.Create(new()942  {943      Model = Model.ClaudeSonnet5,944      MaxTokens = 1024,945      Messages = [new() { Role = Role.User, Content = "Hello!" }]946  });947948  Console.WriteLine(response.Headers.GetValues("x-amzn-requestid").First()); // AWS request ID949  Console.WriteLine(response.Headers.GetValues("request-id").First()); // Anthropic request ID950  Console.WriteLine(response.Value.Content);951  ```952953  ```go Go954  client, err := anthropicaws.NewClient(context.Background(), anthropicaws.ClientConfig{})955  if err != nil {956  	panic(err)957  }958959  var response *http.Response960  message, err := client.Messages.New(961  	context.Background(),962  	anthropic.MessageNewParams{963  		Model:     anthropic.ModelClaudeSonnet5,964  		MaxTokens: 1024,965  		Messages: []anthropic.MessageParam{966  			anthropic.NewUserMessage(anthropic.NewTextBlock("Hello!")),967  		},968  	},969  	option.WithResponseInto(&response),970  )971  if err != nil {972  	panic(err)973  }974975  fmt.Println(response.Header.Get("x-amzn-requestid")) // AWS request ID976  fmt.Println(response.Header.Get("request-id"))       // Anthropic request ID977  fmt.Println(message.Content)978  ```979980  ```java Java981  import com.anthropic.aws.backends.AwsBackend;982  import com.anthropic.client.AnthropicClient;983  import com.anthropic.client.okhttp.AnthropicOkHttpClient;984  import com.anthropic.core.http.HttpResponseFor;985  import com.anthropic.models.messages.Message;986  import com.anthropic.models.messages.MessageCreateParams;987  import com.anthropic.models.messages.Model;988989  void main() {990      AnthropicClient client = AnthropicOkHttpClient.builder()991          .backend(AwsBackend.fromEnv())992          .build();993994      HttpResponseFor<Message> response = client.messages().withRawResponse().create(995          MessageCreateParams.builder()996              .model(Model.CLAUDE_SONNET_5)997              .maxTokens(1024)998              .addUserMessage("Hello!")999              .build()1000      );10011002      IO.println(response.headers().values("x-amzn-requestid").get(0)); // AWS request ID1003      IO.println(response.requestId().orElse(null)); // Anthropic request ID1004      IO.println(response.parse().content());1005  }1006  ```10071008  ```php PHP1009  use Anthropic\Aws\Client;10101011  $client = new Client();10121013  $response = $client->messages->raw->create(1014      model: 'claude-sonnet-5',1015      maxTokens: 1024,1016      messages: [['role' => 'user', 'content' => 'Hello!']],1017  );10181019  echo $response->getHeaderLine('x-amzn-requestid') . "\n"; // AWS request ID1020  echo $response->getHeaderLine('request-id') . "\n"; // Anthropic request ID1021  echo $response->parse()->content;1022  ```10231024  ```ruby Ruby1025  # Accessing raw response headers is not currently supported in the Ruby SDK.1026  # To inspect the x-amzn-requestid header, use one of the other SDK examples.1027  ```1028</CodeGroup>10291030Anthropic recommends logging your activity on at least a 30-day rolling basis to understand usage patterns and investigate issues.10311032<Note>1033  AWS CloudTrail is configured within your AWS account. Enabling logging does not provide AWS or Anthropic access to your content beyond what is necessary for billing and service operation.1034</Note>10351036## Migrating from Amazon Bedrock10371038If you currently use Claude on Bedrock, migrating to Claude Platform on AWS requires changes throughout your integration. SigV4 signing remains supported, but the signing context, base URL, API format, model IDs, SDK client and package, streaming format, request headers, and region availability all change. Claude Platform on AWS also provisions a new Anthropic organization. The following table summarizes the differences.10391040### What changes10411042The migration delta depends on which Bedrock integration you're coming from. The following table shows both the [current Bedrock integration](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock) (Messages API at `bedrock-mantle.{region}.api.aws`) and the [legacy InvokeModel integration](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy).10431044| Aspect                     | From [Claude in Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock) | From [Amazon Bedrock (Opus 4.6 and earlier)](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy) | To Claude Platform on AWS                                                                                                                                                                                                                                          |1045| -------------------------- | --------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |1046| **Base URL**               | `bedrock-mantle.{region}.api.aws`                                                                               | `bedrock-runtime.{region}.amazonaws.com`                                                                                            | `aws-external-anthropic.{region}.api.aws`                                                                                                                                                                                                                          |1047| **API format**             | Messages API at `/anthropic/v1/messages`                                                                        | Bedrock Converse / InvokeModel                                                                                                      | Claude API (`/v1/{endpoint}`)                                                                                                                                                                                                                                      |1048| **Model IDs**              | anthropic.claude-haiku-4-5                                                                                      | anthropic.claude-haiku-4-5-20251001-v1:0(with a `us.` or `global.` inference profile prefix)                                        | claude-haiku-4-5                                                                                                                                                                                                                                                   |1049| **SDK client**             | `AnthropicBedrockMantle`                                                                                        | `AnthropicBedrock` / Bedrock SDK                                                                                                    | Platform-specific client (see [Install an SDK](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#install-an-sdk)), in beta                                                                                                              |1050| **SDK package**            | `anthropic[bedrock]`, `@anthropic-ai/bedrock-sdk`, and others                                                   | `anthropic[bedrock]`, `@anthropic-ai/bedrock-sdk`, or AWS SDK                                                                       | `anthropic[aws]`, `@anthropic-ai/aws-sdk`, and others (see [Install an SDK](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#install-an-sdk))                                                                                          |1051| **SigV4 service name**     | `bedrock-mantle`                                                                                                | `bedrock`                                                                                                                           | `aws-external-anthropic`                                                                                                                                                                                                                                           |1052| **Streaming format**       | SSE                                                                                                             | AWS EventStream                                                                                                                     | SSE (same as Claude API)                                                                                                                                                                                                                                           |1053| **Workspace header**       | Not applicable                                                                                                  | Not applicable                                                                                                                      | `anthropic-workspace-id`, required on inference and resource requests                                                                                                                                                                                              |1054| **Region availability**    | See [Amazon Bedrock regions](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-regions.html)         | See [Amazon Bedrock regions](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-regions.html)                             | All AWS commercial regions                                                                                                                                                                                                                                         |1055| **Anthropic organization** | None required                                                                                                   | None required                                                                                                                       | New organization created at sign-up. Existing organizations can't be converted (see [Moving from an existing Anthropic organization](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#moving-from-an-existing-anthropic-organization)) |10561057If you're on the current Bedrock integration, the request body format is already the Messages API. The changes are the base URL, SigV4 service name, model IDs, and adding the `anthropic-workspace-id` header. If you're on the legacy InvokeModel or Converse API, you'll also rewrite the request and response shapes to the Messages API format. See [Claude on Amazon Bedrock (Opus 4.6 and earlier)](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy) for the request-shape mapping.10581059### What you gain10601061* Typically same-day access to new models and features (see [feature limitations](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#features-not-supported))1062* Agent Skills for document generation (PowerPoint, Excel, Word, PDF)1063* Code execution in Anthropic's managed sandbox1064* Beta features through the `anthropic-beta` header (see [feature limitations](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#features-not-supported))1065* Claude Console for quota visibility and usage analytics1066* Direct Anthropic support1067* API key authentication as an alternative to SigV4 (see [API key authentication](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#api-key-authentication))10681069### What stays the same10701071* AWS IAM authentication (SigV4)1072* AWS as the invoicing party. The billing channel changes from native AWS service to AWS Marketplace (see [Commercial considerations](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#commercial-considerations)).1073* AWS commitment retirement10741075### Migration pitfalls10761077<Warning>1078  **Enable outbound web identity federation first.** If your AWS account has not previously used Claude Platform on AWS, you must [enable outbound web identity federation](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#enable-outbound-web-identity-federation) once per account before making requests. Without this step, all requests fail with a federation error (see [Enable outbound web identity federation](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#enable-outbound-web-identity-federation) for the exact error and remediation). This step is not required for Bedrock.1079</Warning>10801081<Warning>1082  **Zero Data Retention (ZDR) is opt-in on Claude Platform on AWS.** On Bedrock, AWS is the data processor and Anthropic does not retain inference inputs or outputs. Anthropic's ZDR program does not apply there. On Claude Platform on AWS, Anthropic processes inference data as an independent data processor, and ZDR follows the first-party Claude API model: it is available on request through your Anthropic account representative. Confirm ZDR enrollment before migrating production workloads that depend on data-retention guarantees.1083</Warning>10841085### Commercial considerations10861087* **Anthropic terms of service:** Using Claude Platform on AWS requires accepting Anthropic's Commercial Terms of Service and Usage Policy. If your organization hasn't already accepted these (for example, if you've only used Claude through Bedrock), you're prompted during account setup. See [Set up your account](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws#set-up-your-account).1088* **Discounts and private offers:** Negotiated discounts and AWS Marketplace private offers don't transfer automatically between Bedrock and Claude Platform on AWS. Work with your Anthropic account representative to set up commercial terms for Claude Platform on AWS.10891090## IAM policies10911092Claude Platform on AWS integrates with AWS IAM for access control. You grant or deny access to specific API actions on specific workspaces using standard IAM policy syntax.10931094The SigV4 service name and IAM action namespace is `aws-external-anthropic`. Actions follow the pattern `aws-external-anthropic:<Action>` (for example, `aws-external-anthropic:CreateInference`).10951096### Example: deny batch inference10971098The following policy allows real-time inference while blocking batch processing:10991100```json1101{1102  "Version": "2012-10-17",1103  "Statement": [1104    {1105      "Effect": "Allow",1106      "Action": [1107        "aws-external-anthropic:CreateInference",1108        "aws-external-anthropic:CountTokens",1109        "aws-external-anthropic:GetModel",1110        "aws-external-anthropic:ListModels",1111        "aws-external-anthropic:GetWorkspace"1112      ],1113      "Resource": "arn:aws:aws-external-anthropic:*:*:workspace/*"1114    },1115    {1116      "Effect": "Allow",1117      "Action": "aws-external-anthropic:ListWorkspaces",1118      "Resource": "*"1119    },1120    {1121      "Effect": "Deny",1122      "Action": [1123        "aws-external-anthropic:CreateBatchInference",1124        "aws-external-anthropic:GetBatchInference",1125        "aws-external-anthropic:ListBatchInferences"1126      ],1127      "Resource": "*"1128    }1129  ]1130}1131```11321133The `GetBatchInference` action authorizes both the batch metadata route and the batch results route. Denying it blocks both reads. For a Deny-only policy suitable for ZDR-sensitive workloads, see [Feature lockdown for a ZDR-sensitive workspace](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions#feature-lockdown-for-a-zdr-sensitive-workspace).11341135<Note>1136  `ListWorkspaces` is account-scoped, so it appears in a separate Allow statement with `"Resource": "*"`. Specifying a workspace ARN on an account-scoped action has no effect (see [Provisioning automation](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions#provisioning-automation)).11371138  This policy assumes AWS SigV4 authentication. If the principal authenticates with an API key, also add `aws-external-anthropic:CallWithBearerToken` to the `"Resource": "*"` Allow statement. `CallWithBearerToken` is a route-less authentication-layer action that does not bind to a workspace ARN. See [Per-customer workspace isolation](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions#per-customer-workspace-isolation) for the two-statement pattern.1139</Note>11401141### Managed policies11421143AWS provides five managed policies (`AnthropicFullAccess`, `AnthropicReadOnlyAccess`, `AnthropicInferenceAccess`, `AnthropicLimitedAccess`, and `AnthropicSelfHostedEnvironmentAccess`) for common access patterns. For the actions each policy grants, the complete list of IAM actions, the route-to-action mapping, and additional policy examples, see [IAM actions for Claude Platform on AWS](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions#managed-policies).11441145## Next steps11461147<CardGroup cols={2}>1148  <Card title="Features overview" icon="stack" href="https://platform.claude.com/docs/en/build-with-claude/overview">1149    Explore Claude's advanced features and capabilities.1150  </Card>11511152  <Card title="Pricing" icon="chart" href="https://platform.claude.com/docs/en/about-claude/pricing#claude-platform-on-aws-pricing">1153    Learn about Claude Platform on AWS pricing and Claude Consumption Unit rates.1154  </Card>11551156  <Card title="Model deprecations" icon="arrow-clockwise" href="https://platform.claude.com/docs/en/about-claude/model-deprecations">1157    As safer and more capable models launch, Anthropic regularly retires older ones. See all API deprecations, along with recommended replacements.1158  </Card>1159</CardGroup>11601161## Additional resources11621163<CardGroup cols={2}>1164  <Card title="Claude Console" icon="browser" href="https://platform.claude.com">1165    View usage, cost, and workspaces in the Claude Console. Sign in through the AWS Console.1166  </Card>11671168  <Card title="Claude in Amazon Bedrock" icon="cloud" href="https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock">1169    Use AWS-operated Claude if you need AWS as the sole data processor.1170  </Card>11711172  <Card title="AWS Marketplace" icon="coins" href="https://aws.amazon.com/marketplace">1173    Manage your AWS Marketplace subscription and billing.1174  </Card>1175</CardGroup>1176
Files main
Menu

Theme