Loading...
    • Developer Guide
    • API Reference
    • MCP
    • Resources
    • Release Notes
    Search...
    ⌘K
    First steps
    Intro to ClaudeQuickstart
    Models & pricing
    Models overviewChoosing a modelWhat's new in Claude 4.6Migration guideModel deprecationsPricing
    Build with Claude
    Features overviewUsing the Messages APIHandling stop reasonsPrompting best practices
    Model capabilities
    Extended thinkingAdaptive thinkingEffortFast mode (beta: research preview)Structured outputsCitationsStreaming MessagesBatch processingPDF supportSearch resultsMultilingual supportEmbeddingsVision
    Tools
    OverviewHow tool use worksTutorial: Build a tool-using agentDefine toolsHandle tool callsParallel tool useTool Runner (SDK)Strict tool useTool use with prompt cachingServer toolsTroubleshootingTool referenceWeb search toolWeb fetch toolCode execution toolMemory toolBash toolComputer use toolText editor tool
    Tool infrastructure
    Manage tool contextTool combinationsTool searchProgrammatic tool callingFine-grained tool streaming
    Context management
    Context windowsCompactionContext editingPrompt cachingToken counting
    Files & assets
    Files API
    Agent Skills
    OverviewQuickstartBest practicesSkills for enterpriseClaude API skillUsing Skills with the API
    Agent SDK
    OverviewQuickstartHow the agent loop works
    MCP in the API
    MCP connectorRemote MCP servers
    Claude on 3rd-party platforms
    Amazon BedrockAmazon Bedrock (legacy)Microsoft FoundryVertex AI
    Prompt engineering
    OverviewConsole prompting tools
    Test & evaluate
    Define success and build evaluationsUsing the Evaluation ToolReducing latency
    Strengthen guardrails
    Reduce hallucinationsIncrease output consistencyMitigate jailbreaksStreaming refusalsReduce prompt leak
    Administration and monitoring
    Admin API overviewData residencyWorkspacesUsage and Cost APIClaude Code Analytics APIAPI and data retention
    Console
    Log in
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy
    Claude on 3rd-party platforms

    Claude in Amazon Bedrock

    Access Claude models through Amazon Bedrock with AWS-native authentication, billing, and security boundaries.

    This guide walks you through setting up and making API calls to Claude in Amazon Bedrock. Claude in Amazon Bedrock runs on AWS-managed infrastructure with zero operator access (Anthropic personnel have no access to the inference infrastructure), letting you build sensitive applications entirely inside the AWS security boundary while using the same Messages API shape you use with Anthropic's first-party API.

    This page covers the new Claude in Amazon Bedrock offering, which exposes the Messages API at /anthropic/v1/messages. For the legacy Bedrock integration (the InvokeModel API with ARN-versioned model identifiers and AWS event-stream encoding), see Claude on Amazon Bedrock.

    Research preview

    Claude in Amazon Bedrock is in research preview, available in the US East (N. Virginia) us-east-1 region at launch. Contact your Anthropic account executive to request access.

    Prerequisites

    Before you begin, ensure you have:

    • A new AWS account in us-east-1. The research preview requires a dedicated account for isolation. Your Anthropic account executive will submit your account ID to the Bedrock Marketplace team for allowlisting (typically processed within 24 hours).
    • The AWS CLI installed and configured (optional, for credential management)
    • After allowlisting, AWS sends a welcome email with your model ID and additional setup details.

    Authentication

    Claude in Amazon Bedrock supports three authentication paths. Choose the one that best fits your security requirements.

    Bedrock service role (recommended)

    Use a Bedrock service role with AWS-managed keys for the most secure, long-lived access:

    1. 1

      Admin: provision the service role

      An AWS administrator provisions a Bedrock service role and grants developers iam:PassRole permission on the service role ARN.

    2. 2

      Developer: pass the role

      When calling the API, pass the service role ARN as a request parameter. Bedrock assumes the role on your behalf and signs requests with AWS-managed credentials. A code example showing where the ARN parameter goes will be added when the SDK packages publish.

    IAM assumed roles

    For identity-federated access with a 12-hour maximum session:

    1. 1

      Admin: configure the IAM role

      Create an IAM role scoped to your Claude models. The trust policy names your identity provider (SAML, OIDC, or AWS Identity Center). The permissions policy grants bedrock-mantle:CreateInference only on the allowed model ARNs.

    2. 2

      Developer: authenticate and assume

      Authenticate through your corporate identity provider, then assume the IAM role. AWS STS issues temporary credentials that the SDK or CLI uses to sign requests.

    Bearer tokens

    For short-term access without IAM roles (12-hour maximum, least preferred):

    1. 1

      Admin: restrict token types

      Block long-term keys by attaching a policy that denies bedrock:CallWithBearerToken unless the bedrock:BearerTokenType condition matches a short-term token.

    2. 2

      Developer: mint a token

      Use the aws-bedrock-token-generator CLI (link pending publication) to mint a bearer token. Pass it in the x-api-key header on each request.

    Install an SDK

    Anthropic's client SDKs support Claude in Amazon Bedrock through a Bedrock-specific package or module.

    Making your first request

    The endpoint follows the pattern https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages. Unlike the legacy Bedrock integration, this endpoint uses standard SSE streaming and the same request body shape as Anthropic's first-party API.

    The SDK resolves credentials and region using the standard AWS precedence: constructor arguments, then environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_REGION), then the AWS config file and credential chain (SSO, assumed roles, ECS task role, IMDS).

    curl https://bedrock-mantle.us-east-1.api.aws/anthropic/v1/messages \
      --aws-sigv4 "aws:amz:us-east-1:bedrock-mantle" \
      --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
      -H "x-amz-security-token: $AWS_SESSION_TOKEN" \
      -H "content-type: application/json" \
      -H "anthropic-version: 2023-06-01" \
      -d '{
        "model": "CLAUDE_MODEL_ID",
        "max_tokens": 1024,
        "messages": [
          {"role": "user", "content": "Hello, Claude"}
        ]
      }'

    If the dedicated AnthropicBedrockMantle client is not yet available in your language's SDK release, you can use the standard Anthropic client instead: set base_url to https://bedrock-mantle.{region}.api.aws/anthropic and pass your bearer token as api_key. This path supports bearer-token authentication only. SigV4 signing requires the dedicated client.

    Supported models

    Model IDs in Claude in Amazon Bedrock carry an anthropic. provider prefix. Model capabilities and behaviors are documented on the Models overview page. See your AWS welcome email for the exact model ID enabled for your account.

    Feature availability

    Claude in Amazon Bedrock supports features that run inside the model. Features that require Anthropic-operated infrastructure are not available.

    Supported:

    • Messages API (/v1/messages)
    • Prompt caching
    • Extended thinking
    • Tool use (client-defined tools)
    • Citations
    • Structured outputs
    • In-region inference (requests stay in a single AWS region)

    Not supported:

    • Anthropic-defined tools (Web Search, Web Fetch, Remote MCP, Memory, Files API, Computer Use, Skills, Code Execution)
    • Agent API
    • Message Batches API
    • /v1/users endpoint

    Regions

    The research preview is available in us-east-1 (IAD) only.

    Quotas

    Default quota is 2 million input tokens per minute (TPM). You can request up to 4 million input TPM without additional Anthropic approval. AWS enforces requests-per-minute (RPM) limits on the Bedrock side; contact AWS support for RPM adjustments.

    Data retention

    All inference data is retained for 30 days in your AWS storage. There is no zero-data-retention opt-out on this offering. For standard customers, Anthropic can inspect stored data for safety and abuse review. For Select-tier customers, only AWS can inspect data; Anthropic can run automated operations but not manual review. For details on Select-tier eligibility, contact your Anthropic account executive.

    If your application requires zero data retention (ZDR), consider Claude Platform on AWS, where ZDR is available by contacting sales.

    Observability

    Claude in Amazon Bedrock emits logs to both CloudWatch and CloudTrail. Anthropic recommends retaining activity logs on at least a 30-day rolling basis to understand usage patterns and investigate potential issues.

    Support

    For research preview support, contact [email protected]. Include your AWS account ID and the request-id from any failed API responses.

    Was this page helpful?

    • Research preview
    • Prerequisites
    • Authentication
    • Bedrock service role (recommended)
    • IAM assumed roles
    • Bearer tokens
    • Install an SDK
    • Making your first request
    • Supported models
    • Feature availability
    • Regions
    • Quotas
    • Data retention
    • Observability
    • Support