Skip to main content

​
AWS Claude

Use Anthropic’s Claude models through AWS Bedrock — same powerful Claude capabilities (extended thinking, document analysis, tool calling) but authenticated with AWS credentials and billed through your AWS account.
awsClaude() uses the @anthropic-ai/bedrock-sdk package, which provides the same Anthropic Messages API routed through AWS Bedrock. All Claude features (thinking, multi-modal, tool calling) work identically to the direct anthropic() provider.

​
Setup

Install the Anthropic Bedrock SDK:
npm install @anthropic-ai/bedrock-sdk

​
Factory

import { awsClaude } from "@radaros/core";

const model = awsClaude("us.anthropic.claude-sonnet-4-20250514-v1:0");
​
modelId
string
required
The AWS Bedrock Claude model identifier. Use the us. or eu. prefix for cross-region inference.
​
config
AwsClaudeConfig
Optional configuration. See Config below.

​
Supported Models

Model IDDescription
us.anthropic.claude-sonnet-4-20250514-v1:0Claude Sonnet 4. Most capable.
anthropic.claude-sonnet-4-20250514-v1:0Claude Sonnet 4 (region-local).
us.anthropic.claude-3-5-sonnet-20241022-v2:0Claude 3.5 Sonnet. Strong all-around, vision support.
us.anthropic.claude-3-5-haiku-20241022-v2:0Claude 3.5 Haiku. Fastest Claude model.
anthropic.claude-3-haiku-20240307-v1:0Claude 3 Haiku. Cost-effective.
Prefix the model ID with us. or eu. to use cross-region inference profiles. This routes requests to the nearest available region for lower latency:
// Cross-region (recommended)
const model = awsClaude("us.anthropic.claude-sonnet-4-20250514-v1:0");

// Region-local
const model = awsClaude("anthropic.claude-sonnet-4-20250514-v1:0");

​
Config

​
awsAccessKey
string
AWS access key ID. Falls back to AWS_ACCESS_KEY_ID env var.
​
awsSecretKey
string
AWS secret access key. Falls back to AWS_SECRET_ACCESS_KEY env var.
​
awsRegion
string
default:"us-east-1"
AWS region. Falls back to AWS_REGION env var.
​
awsSessionToken
string
AWS session token for temporary credentials. Falls back to AWS_SESSION_TOKEN env var.

​
Authentication Methods

export AWS_ACCESS_KEY_ID="AKIA..."
export AWS_SECRET_ACCESS_KEY="..."
export AWS_REGION="us-east-1"

const model = awsClaude("us.anthropic.claude-sonnet-4-20250514-v1:0");
// Credentials picked up from env automatically

​
Method 2: Explicit Credentials

const model = awsClaude("us.anthropic.claude-sonnet-4-20250514-v1:0", {
  awsAccessKey: "AKIA...",
  awsSecretKey: "...",
  awsRegion: "us-east-1",
});

​
Method 3: Temporary Credentials (STS / SSO)

const model = awsClaude("us.anthropic.claude-sonnet-4-20250514-v1:0", {
  awsAccessKey: "ASIA...",
  awsSecretKey: "...",
  awsSessionToken: "FwoGZX...",
  awsRegion: "us-east-1",
});

​
Reasoning / Extended Thinking

Claude’s extended thinking works on Bedrock just like the direct API: 
import { Agent, awsClaude } from "@radaros/core";

const agent = new Agent({
  name: "deep-thinker",
  model: awsClaude("us.anthropic.claude-sonnet-4-20250514-v1:0"),
  instructions: "Think step by step before answering.",
  reasoning: {
    enabled: true,
    budgetTokens: 4000,
  },
});

const result = await agent.run(
  "A bat and a ball cost $1.10 in total. The bat costs $1 more than the ball. How much does the ball cost?"
);

console.log(result.thinking);
// "Let me set up equations... Let ball = x, bat = x + 1.00..."
console.log(result.text);
// "The ball costs $0.05."
When reasoning is enabled, maxTokens is automatically adjusted to accommodate both thinking and response tokens. See Reasoning for details.

​
Tool Calling

Tool calling works identically to the direct Anthropic provider: 
import { Agent, awsClaude, defineTool } from "@radaros/core";
import { z } from "zod";

const agent = new Agent({
  name: "aws-assistant",
  model: awsClaude("us.anthropic.claude-sonnet-4-20250514-v1:0"),
  instructions: "Help users with their orders.",
  tools: [
    defineTool({
      name: "getOrderStatus",
      description: "Get the status of an order by ID",
      parameters: z.object({
        orderId: z.string().describe("Order ID (e.g., ORD-12345)"),
      }),
      execute: async ({ orderId }) => {
        return JSON.stringify({
          id: orderId,
          status: "shipped",
          carrier: "FedEx",
          tracking: "7891234567",
          eta: "2026-03-01",
        });
      },
    }),
  ],
  maxToolRoundtrips: 3,
});

const result = await agent.run("Where is order ORD-12345?");
console.log(result.text);
// "Your order ORD-12345 has been shipped via FedEx (tracking: 7891234567).
//  Estimated delivery: March 1, 2026."

​
Multi-Modal Support

AWS Claude supports images and files/documents — same as the direct Anthropic provider.

​
Images

import { Agent, awsClaude, type ContentPart } from "@radaros/core";
import { readFileSync } from "node:fs";

const agent = new Agent({
  name: "vision-agent",
  model: awsClaude("us.anthropic.claude-sonnet-4-20250514-v1:0"),
  instructions: "Analyze images thoroughly.",
});

const imageData = readFileSync("dashboard.png").toString("base64");
const result = await agent.run([
  { type: "text", text: "What metrics are shown in this dashboard?" },
  { type: "image", data: imageData, mimeType: "image/png" },
] as ContentPart[]);

​
PDF Documents

const pdfData = readFileSync("contract.pdf").toString("base64");
const result = await agent.run([
  { type: "text", text: "What are the payment terms?" },
  { type: "file", data: pdfData, mimeType: "application/pdf", filename: "contract.pdf" },
] as ContentPart[]);

​
CSV Data

const csvData = readFileSync("sales.csv").toString("base64");
const result = await agent.run([
  { type: "text", text: "Analyze this sales data. What are the trends?" },
  { type: "file", data: csvData, mimeType: "text/csv", filename: "sales.csv" },
] as ContentPart[]);

​
Full Example

import { Agent, awsClaude, CostTracker, defineTool } from "@radaros/core";
import { z } from "zod";

const costTracker = new CostTracker({
  pricing: {
    "us.anthropic.claude-sonnet-4-20250514-v1:0": { promptPer1k: 0.003, completionPer1k: 0.015 },
    "us.anthropic.claude-3-5-haiku-20241022-v2:0": { promptPer1k: 0.0008, completionPer1k: 0.004 },
  },
});

const agent = new Agent({
  name: "enterprise-assistant",
  model: awsClaude("us.anthropic.claude-sonnet-4-20250514-v1:0", {
    awsRegion: "us-east-1",
  }),
  instructions: "You are an enterprise assistant. Be thorough and professional.",
  tools: [
    defineTool({
      name: "searchKnowledgeBase",
      description: "Search the company knowledge base",
      parameters: z.object({
        query: z.string().describe("Search query"),
      }),
      execute: async ({ query }) => {
        return JSON.stringify([
          { title: "PTO Policy", snippet: "Employees receive 20 days PTO annually..." },
          { title: "Remote Work", snippet: "Hybrid model: 3 days office, 2 days remote..." },
        ]);
      },
    }),
  ],
  reasoning: { enabled: true, budgetTokens: 2000 },
  toolRouter: {
    model: awsClaude("us.anthropic.claude-3-5-haiku-20241022-v2:0"),
    maxTools: 5,
  },
  costTracker,
  maxToolRoundtrips: 3,
});

const result = await agent.run("What is our PTO policy?");
console.log(result.text);
console.log(`Cost: $${costTracker.getSummary().totalCost.toFixed(4)}`);

​
AWS Claude vs Direct Anthropic

Featureanthropic() (Direct)awsClaude() (Bedrock)
AuthAnthropic API keyAWS IAM credentials
BillingAnthropic billingAWS billing (consolidated)
Extended ThinkingYesYes
Tool CallingYesYes
Multi-ModalYesYes
VPC / PrivateLinkNoYes
ComplianceSOC2SOC2, HIPAA, FedRAMP
Prompt CachingYes (automatic)Yes (via Bedrock)
Use awsClaude() when you need AWS billing, VPC isolation, or compliance certifications. Use anthropic() when you want the simplest setup with an API key.

​
Environment Variables

VariableDescription
AWS_ACCESS_KEY_IDAWS access key ID
AWS_SECRET_ACCESS_KEYAWS secret access key
AWS_REGIONAWS region (default: us-east-1)
AWS_SESSION_TOKENTemporary session token (STS/SSO)

​
Cross-References