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
Environment

Install the Anthropic Bedrock SDK:

npm install @anthropic-ai/bedrock-sdk

Set your AWS credentials via environment variables:

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

Factory

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

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

string

required

The AWS Bedrock Claude model identifier. Use the us. or eu. prefix for cross-region inference.

AwsClaudeConfig

Optional configuration. See Config below.

Supported Models

Model ID	Description
`us.anthropic.claude-sonnet-4-20250514-v1:0`	Claude Sonnet 4. Most capable.
`anthropic.claude-sonnet-4-20250514-v1:0`	Claude Sonnet 4 (region-local).
`us.anthropic.claude-3-5-sonnet-20241022-v2:0`	Claude 3.5 Sonnet. Strong all-around, vision support.
`us.anthropic.claude-3-5-haiku-20241022-v2:0`	Claude 3.5 Haiku. Fastest Claude model.
`anthropic.claude-3-haiku-20240307-v1:0`	Claude 3 Haiku. Cost-effective.

Cross-region inference

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

string

AWS access key ID. Falls back to AWS_ACCESS_KEY_ID env var.

string

AWS secret access key. Falls back to AWS_SECRET_ACCESS_KEY env var.

string

default:"us-east-1"

AWS region. Falls back to AWS_REGION env var.

string

AWS session token for temporary credentials. Falls back to AWS_SESSION_TOKEN env var.

Authentication Methods

Method 1: Environment Variables (Recommended)

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 "@agentium/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 "@agentium/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."

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

Images

import { Agent, awsClaude, type ContentPart } from "@agentium/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 "@agentium/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

Feature	`anthropic()` (Direct)	`awsClaude()` (Bedrock)
Auth	Anthropic API key	AWS IAM credentials
Billing	Anthropic billing	AWS billing (consolidated)
Extended Thinking	Yes	Yes
Tool Calling	Yes	Yes
Multi-Modal	Yes	Yes
VPC / PrivateLink	No	Yes
Compliance	SOC2	SOC2, HIPAA, FedRAMP
Prompt Caching	Yes (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

Variable	Description
`AWS_ACCESS_KEY_ID`	AWS access key ID
`AWS_SECRET_ACCESS_KEY`	AWS secret access key
`AWS_REGION`	AWS region (default: `us-east-1`)
`AWS_SESSION_TOKEN`	Temporary session token (STS/SSO)

Cross-References

Anthropic (Direct) — Direct Anthropic API with API key auth
AWS Bedrock — Generic Bedrock provider for non-Claude models
Reasoning — Extended thinking configuration
Multi-Modal — Provider support matrix

​AWS Claude

​Setup

​Factory

​Supported Models

​Config

​Authentication Methods

​Method 1: Environment Variables (Recommended)

​Method 2: Explicit Credentials

​Method 3: Temporary Credentials (STS / SSO)

​Reasoning / Extended Thinking

​Tool Calling

​Multi-Modal Support

​Images

​PDF Documents

​CSV Data

​Full Example

​AWS Claude vs Direct Anthropic

​Environment Variables

​Cross-References

AWS Claude

Setup

Factory

Supported Models

Config

Authentication Methods

Method 1: Environment Variables (Recommended)

Method 2: Explicit Credentials

Method 3: Temporary Credentials (STS / SSO)

Reasoning / Extended Thinking

Tool Calling

Multi-Modal Support

Images

PDF Documents

CSV Data

Full Example

AWS Claude vs Direct Anthropic

Environment Variables

Cross-References