Amazon Bedrock 中的 Claude(bedrock-mantle)

通过 Amazon Bedrock 的 bedrock-mantle 端点上的 Messages API 调用 Claude,使用 AWS 原生的身份验证、计费和安全边界。

本指南将引导您完成在 Amazon Bedrock 中设置 Claude 并进行 API 调用的过程。Amazon Bedrock 中的 Claude 运行在 AWS 托管的基础设施上,具有零运营人员访问权限:Anthropic 人员无法访问推理基础设施。您可以完全在 AWS 安全边界内构建敏感应用程序,同时使用与 Claude API 相同的 Messages API 形式。

访问权限

Amazon Bedrock 为每个 Claude 模型单独设置访问条件。Claude Fable 5.1、Claude Fable 5、Claude Opus 4.8、Claude Sonnet 5、Claude Opus 4.7 和 Claude Haiku 4.5 向所有 Amazon Bedrock 客户开放。如需了解任何其他模型的访问条件,请在 AWS 控制台中查看 Amazon Bedrock 模型访问。有关区域可用性,请参阅区域。

前提条件

开始之前,请确保您具备:

身份验证

Amazon Bedrock 中的 Claude 支持三种身份验证路径。请选择最符合您安全要求的一种。

Bedrock 服务角色(推荐)

使用带有 AWS 托管密钥的 Bedrock 服务角色,以获得最安全、长期有效的访问:

管理员:配置服务角色

AWS 管理员配置一个 Bedrock 服务角色,并授予开发人员对该服务角色 ARN 的 iam:PassRole 权限。

开发人员:传递角色

当您调用 API 时,Bedrock 会代表您承担该服务角色。有关如何将角色与请求关联,请参阅 Amazon Bedrock 文档。

IAM 代入角色

用于身份联合访问,会话最长 12 小时:

管理员:配置 IAM 角色

创建一个作用范围限定于您的 Claude 模型的 IAM 角色。信任策略指定您的身份提供商(SAML、OIDC 或 AWS Identity Center)。权限策略仅对允许的模型 ARN 授予 bedrock-mantle:CreateInference。

开发人员:进行身份验证并代入角色

通过您的企业身份提供商进行身份验证,然后代入该 IAM 角色。AWS STS 会颁发临时凭证,SDK 或 CLI 使用这些凭证对请求进行签名。

Bearer 令牌

用于无需 IAM 角色的短期访问(最长 12 小时,最不推荐):

管理员:限制令牌类型

通过附加一个策略来阻止长期密钥:除非 bedrock:BearerTokenType 条件匹配短期令牌,否则拒绝 bedrock:CallWithBearerToken。

开发人员:生成令牌

使用 aws-bedrock-token-generator CLI 生成一个 bearer 令牌。在每个请求的 x-api-key 标头中传递该令牌。

安装 SDK

客户端 SDK 通过 Bedrock 专用的包或模块支持 Amazon Bedrock 中的 Claude。

Python

示例代码
pip install -U "anthropic[bedrock]"

TypeScript

示例代码
npm install @anthropic-ai/bedrock-sdk

C#

示例代码
dotnet add package Anthropic.Bedrock

Go

示例代码
go get github.com/anthropics/anthropic-sdk-go/v2/bedrock

Java

Gradle

示例代码
implementation("com.anthropic:anthropic-java:3.8.0")
implementation("com.anthropic:anthropic-java-bedrock:3.8.0")

Maven

示例代码
<dependency>
    <groupId>com.anthropic</groupId>
    <artifactId>anthropic-java</artifactId>
    <version>3.8.0</version>
</dependency>
<dependency>
    <groupId>com.anthropic</groupId>
    <artifactId>anthropic-java-bedrock</artifactId>
    <version>3.8.0</version>
</dependency>

PHP

示例代码
composer require anthropic-ai/sdk aws/aws-sdk-php

Ruby

示例代码
# Gemfile
gem "anthropic"
gem "aws-sdk-core"

发出您的第一个请求

端点遵循 https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages 模式。此端点使用标准 SSE “streaming”(流式传输),以及与 Claude API 相同的请求体结构。

请在创建客户端时传递区域,或设置 AWS_REGION 环境变量。如果两者都未设置,Python、TypeScript、C#、Go、PHP 和 Ruby SDK 会尝试使用 AWS_DEFAULT_REGION。Java SDK 仅在您调用 BedrockMantleBackend.fromEnv() 时才读取环境,该方法使用默认 AWS 区域提供程序链。该链还会检查您的 AWS 配置文件和 EC2 实例元数据。

对于凭证,客户端使用您在创建时传递的凭证。否则,AWS_BEARER_TOKEN_BEDROCK 环境变量优先于客户端的 AWS 凭证链,该凭证链包括 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY 和 AWS_SESSION_TOKEN 环境变量。

cURL

示例代码
curl https://bedrock-mantle.us-east-1.api.aws/anthropic/v1/messages \
  --aws-sigv4 "aws:amz:us-east-1:bedrock-mantle" \
  -u "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  -H "x-amz-security-token: $AWS_SESSION_TOKEN" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2026-10-21" \
  -d '{
    "model": "anthropic.claude-opus-5-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude"}
    ]
  }'

CLI

ant CLI 不支持 Amazon Bedrock。请使用 cURL 或 SDK。

Python

示例代码
from anthropic import AnthropicBedrockMantle

client = AnthropicBedrockMantle(aws_region="us-east-1")

message = client.messages.create(
    model="anthropic.claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

print(next(block.text for block in message.content if block.type == "text"))

TypeScript

示例代码
import { AnthropicBedrockMantle } from "@anthropic-ai/bedrock-sdk";

const client = new AnthropicBedrockMantle({
  awsRegion: "us-east-1"
});

const message = await client.messages.create({
  model: "anthropic.claude-opus-5-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello, Claude" }]
});

const textBlock = message.content.find((block) => block.type === "text");
if (textBlock) {
  console.log(textBlock.text);
}

C#

示例代码
using Anthropic.Bedrock;
using Anthropic.Models.Messages;

var client = new AnthropicBedrockMantleClient(new() { AwsRegion = "us-east-1" });

var message = await client.Messages.Create(new()
{
    Model = "anthropic.claude-opus-5-5",
    MaxTokens = 1024,
    Messages = [new UserMessageParam { Content = "Hello, Claude" }],
});

foreach (var item in message.Content)
{
    if (item.Value is TextBlock block)
    {
        Console.WriteLine(block.Text);
        break;
    }
}

Go

示例代码
client, err := bedrock.NewMantleClient(context.Background(), bedrock.MantleClientConfig{
	AWSRegion: "us-east-1",
})
if err != nil {
	panic(err)
}

message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{
	Model:     "anthropic.claude-opus-5-5",
	MaxTokens: 1024,
	Messages: []anthropic.MessageParam{
		anthropic.NewUserMessage(anthropic.NewTextBlock("Hello, Claude")),
	},
})
if err != nil {
	panic(err)
}

for _, block := range message.Content {
	if textBlock, ok := block.AsAny().(anthropic.TextBlock); ok {
		fmt.Println(textBlock.Text)
		break
	}
}

Java

示例代码
import com.anthropic.bedrock.backends.BedrockMantleBackend;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.messages.ContentBlock;
import com.anthropic.models.messages.Message;
import com.anthropic.models.messages.MessageCreateParams;

void main() {
    AnthropicClient client = AnthropicOkHttpClient.builder()
        .backend(BedrockMantleBackend.fromEnv())
        .build();

    Message message = client.messages().create(
        MessageCreateParams.builder()
            .model("anthropic.claude-opus-5-5")
            .maxTokens(1024)
            .addUserMessage("Hello, Claude")
            .build()
    );

    message.content().stream()
        .filter(ContentBlock::isText)
        .findFirst()
        .ifPresent(block -> IO.println(block.asText().text()));
}

PHP

示例代码
use Anthropic\Bedrock\MantleClient;

$client = new MantleClient(awsRegion: 'us-east-1');

$message = $client->messages->create(
    model: 'anthropic.claude-opus-5-5',
    maxTokens: 1024,
    messages: [
        ['role' => 'user', 'content' => 'Hello, Claude'],
    ],
);

echo array_find($message->content, fn ($block) => $block->type === 'text')->text;

Ruby

示例代码
require "anthropic"

client = Anthropic::BedrockMantleClient.new(aws_region: "us-east-1")

message = client.messages.create(
  model: "anthropic.claude-opus-5-5",
  max_tokens: 1024,
  messages: [{role: "user", content: "Hello, Claude"}]
)

puts message.content.find { it.type == :text }.text

支持的模型

Amazon Bedrock 中的 Claude 的模型 ID 带有 anthropic. 提供商前缀。有关模型的功能和行为,请参阅模型概览。Claude Fable 5.2 和 Claude Mythos 5.2 在 Amazon Bedrock 中的 Claude 中不可用。Amazon Bedrock 仅在 bedrock-runtime 端点上提供这两个模型。有关它们的模型 ID,请参阅 API 模型 ID。如需了解每个模型由哪个端点提供,请参阅 AWS 文档中的按模型划分的端点可用性。

ModelModel IDAccess
Claude Fable 5.1anthropic.claude-fable-5-1Open
Claude Mythos 5.1 (limited availability)anthropic.claude-mythos-5-1Active (verification required)
Claude Fable 5anthropic.claude-fable-5Open
Claude Mythos 5 (limited availability)anthropic.claude-mythos-5Active (verification required)
Claude Opus 5.5anthropic.claude-opus-5-5See Access
Claude Opus 5anthropic.claude-opus-5See Access
Claude Opus 4.8anthropic.claude-opus-4-8Open
Claude Opus 4.7anthropic.claude-opus-4-7Open
Claude Sonnet 5.5anthropic.claude-sonnet-5-5See Access
Claude Sonnet 5anthropic.claude-sonnet-5Open
Claude Haiku 5.5anthropic.claude-haiku-5-5See Access
Claude Haiku 4.5anthropic.claude-haiku-4-5Open

与 Amazon Bedrock 中的 Claude 配合使用时,请使用最新版本的 Claude Code;运行 claude update 进行升级。

让 Claude Code 将您的代码迁移到更新的模型

示例代码
/claude-api migrate 将此项目迁移到最新的 Claude Opus 模型

功能支持

有关包含 Amazon Bedrock 可用性的完整功能列表,请参阅功能概览。

支持的功能亮点

不支持的功能

  • 输入源(图像和文档的 URL 源、Files API)
  • 服务器端工具(代码执行、网络搜索、网页获取、advisor)
  • 智能体基础设施(Agent Skills、MCP 连接器、程序化工具调用)
  • API 端点(Message Batches、Models、Admin、Compliance、用量和成本)
  • Claude Managed Agents
  • 服务器端回退(fallbacks 参数;请改用客户端回退模式)

区域

Amazon Bedrock 中的 Claude 在以下 AWS 区域可用。Amazon Bedrock 提供两种端点类型:

  • 全球: 在所有可用区域之间动态路由,以实现最高可用性。无价格溢价。
  • 区域: 端点解析到您指定的单个 AWS 区域,以满足数据驻留要求。区域端点的价格比全球端点高 10%。如需在某一地理范围内的多个区域之间路由,请使用 “inference profile”(推理配置文件)(US、EU、JP 或 AU)。表中标记为仅区域内的区域支持无需推理配置文件的直接单区域路由。

全球端点适用于 Claude Fable 5.1、Claude Fable 5、Claude Opus 5.5、Claude Opus 5、Claude Opus 4.8、Claude Opus 4.7、Claude Sonnet 5.5、Claude Sonnet 5、Claude Haiku 5.5 和 Claude Haiku 4.5。

AWS 区域位置端点类型
af-south-1非洲(开普敦)全球
ap-northeast-1亚太地区(东京)全球、JP、仅区域内
ap-northeast-2亚太地区(首尔)全球
ap-northeast-3亚太地区(大阪)全球、JP
ap-south-1亚太地区(孟买)全球
ap-south-2亚太地区(海得拉巴)全球
ap-southeast-1亚太地区(新加坡)全球
ap-southeast-2亚太地区(悉尼)全球、AU
ap-southeast-3亚太地区(雅加达)全球
ap-southeast-4亚太地区(墨尔本)全球、AU、仅区域内
ca-central-1加拿大(中部)全球、US
ca-west-1加拿大西部(卡尔加里)全球
eu-central-1欧洲(法兰克福)全球、EU
eu-central-2欧洲(苏黎世)全球、EU
eu-north-1欧洲(斯德哥尔摩)全球、EU、仅区域内
eu-south-1欧洲(米兰)全球、EU
eu-south-2欧洲(西班牙)全球、EU
eu-west-1欧洲(爱尔兰)全球、EU、仅区域内
eu-west-2欧洲(伦敦)全球、EU
eu-west-3欧洲(巴黎)全球、EU
il-central-1以色列(特拉维夫)全球
me-central-1中东(阿联酋)全球
sa-east-1南美洲(圣保罗)全球
us-east-1美国东部(弗吉尼亚州北部)全球、US、仅区域内
us-east-2美国东部(俄亥俄州)全球、US、仅区域内
us-west-1美国西部(加利福尼亚州北部)全球、US
us-west-2美国西部(俄勒冈州)全球、US、仅区域内

配额

默认配额为每分钟 200 万输入令牌(TPM)。您可以申请最高 500 万输入 TPM 和 50 万输出 TPM,无需 Anthropic 额外批准。AWS 在 Bedrock 端强制执行每分钟请求数(RPM)限制;如需调整 RPM,请联系 AWS 支持。

数据保留

此产品的数据处理由 Amazon Bedrock 管理。有关详细信息,请参阅 Amazon Bedrock 中的数据保护。

监控和日志记录

Amazon Bedrock 中的 Claude 会向 CloudWatch 和 CloudTrail 发送日志。Anthropic 建议至少以 30 天滚动方式保留活动日志,以便了解使用模式并调查潜在问题。

支持

如需支持,请联系 AWS 支持或您的 AWS 客户团队。请附上您的 AWS 账户 ID 以及任何失败的 API 响应中的 request-id。

文档内容持续同步更新