Amazon Bedrock 上的 Claude（旧版）

通过 Bedrock 调用 Claude 与直接在 Claude API 上调用 Claude 的方式略有不同。本指南将引导您使用 Anthropic 的客户端 SDK 之一完成对 Bedrock 上 Claude 的 API 调用。

请注意，本指南假定您已注册 AWS 账户并配置了编程访问权限。

安装和配置 AWS CLI

1. 安装 AWS CLI，版本需为 2.13.23 或更高
2. 使用 AWS configure 命令配置您的 AWS 凭证（请参阅配置 AWS CLI），或者在 AWS 控制面板中导航至"Command line or programmatic access"（命令行或编程访问），然后按照弹出窗口中的说明查找您的凭证。
3. 验证您的凭证是否正常工作：

aws sts get-caller-identity

安装用于访问 Bedrock 的 SDK

Anthropic 的客户端 SDK 支持 Bedrock。您也可以直接使用 AWS SDK，例如 boto3。

访问 Bedrock

订阅 Anthropic 模型

前往 AWS 控制台 > Bedrock > 模型访问并申请访问 Anthropic 模型。请注意，Anthropic 模型的可用性因区域而异。有关最新信息，请参阅 AWS 文档。

API 模型 ID

生命周期术语（已弃用、已停用）的定义请参阅模型弃用。合作伙伴运营平台上的生命周期日期由合作伙伴设定，可能与 Claude API 的时间表不同。有关 Amazon Bedrock 上任何模型的当前停用日期，请参阅 Amazon Bedrock 的模型生命周期页面。

有关区域性与全球性模型 ID 的更多信息，请参阅全球端点与区域端点部分。

列出可用模型

以下示例展示了如何打印通过 Bedrock 可用的所有 Claude 模型列表：

import boto3

bedrock = boto3.client(service_name="bedrock")
response = bedrock.list_foundation_models(byProvider="anthropic")

for summary in response["modelSummaries"]:
    print(summary["modelId"])

发起请求

以下示例展示了如何在 Bedrock 上使用 Claude 生成文本：

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # 通过提供以下密钥进行身份验证，或使用默认的 AWS 凭证提供程序，例如
    # 使用 ~/.aws/credentials 或 "AWS_SECRET_ACCESS_KEY" 和 "AWS_ACCESS_KEY_ID" 环境变量。
    aws_access_key="<access key>",
    aws_secret_key="<secret key>",
    # 临时凭证可与 aws_session_token 一起使用。
    # 更多信息请参阅 https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html。
    aws_session_token="<session_token>",
    # aws_region 用于更改请求发送到的 AWS 区域。默认情况下，SDK 会读取 AWS_REGION，
    # 如果该变量不存在，则默认为 us-east-1。请注意，SDK 不会从 ~/.aws/config 读取区域配置。
    aws_region="us-west-2",
)

message = client.messages.create(
    model="global.anthropic.claude-opus-4-6-v1",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)
print(message.content)

有关更多详细信息，请参阅客户端 SDK 以及官方 Bedrock 文档。

Bearer 令牌身份验证

您可以使用 "bearer token"（持有者令牌）而非 AWS 凭证对 Bedrock 进行身份验证。这在企业环境中非常有用，团队无需管理 AWS 凭证、IAM 角色或账户级权限即可访问 Bedrock。

最简单的方法是设置 AWS_BEARER_TOKEN_BEDROCK 环境变量，每个 SDK 在从环境解析凭证时都会自动检测该变量。

以编程方式提供令牌：

using Anthropic.Bedrock;
using Anthropic.Models.Messages;

var client = new AnthropicBedrockClient(
    new AnthropicBedrockApiTokenCredentials
    {
        BearerToken = "your-bearer-token",
        Region = "us-west-2",
    }
);

var response = await client.Messages.Create(new MessageCreateParams
{
    Model = "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
    MaxTokens = 1024,
    Messages = [new() { Role = Role.User, Content = "Hello!" }],
});

活动日志记录

Bedrock 提供了一项调用日志记录服务，允许客户记录与其使用情况相关的提示和补全内容。

Anthropic 建议您至少以 30 天滚动周期记录您的活动，以便了解您的活动情况并调查任何潜在的滥用行为。

功能支持

有关 Amazon Bedrock 可用性的完整功能列表，请参阅功能概述。

支持的功能亮点

• Messages API
• 提示缓存
• 扩展思考
• 工具使用，包括 Bash 工具、计算机使用工具、内存工具和文本编辑器工具
• 引用
• 结构化输出

不支持的功能

• 输入源（图像和文档的 URL 源、Files API）
• 服务器端工具（代码执行、网络搜索、网络获取、顾问）
• 智能体基础设施（Agent Skills、MCP 连接器、编程式工具调用）
• API 端点（Message Batches、Models、Admin、Compliance、Usage and Cost）
• Claude 托管智能体
• 服务器端回退（fallbacks 参数；请改用客户端回退模式）

Bedrock 上的 PDF 支持

Bedrock 通过 Converse API 和 InvokeModel API 均提供 PDF 支持。有关 PDF 处理能力和限制的详细信息，请参阅 Amazon Bedrock PDF 支持。

Converse API 用户的重要注意事项：

• 可视化 PDF 分析（图表、图像、布局）需要启用引用功能
• 如果未启用引用，则仅提供基本文本提取
• 如需在不强制启用引用的情况下获得完全控制，请使用 InvokeModel API

上下文窗口

Claude Fable 5、Claude Opus 4.8、Claude Opus 4.7、Claude Opus 4.6 和 Claude Sonnet 4.6 在 Amazon Bedrock 上拥有 100 万令牌的上下文窗口。其他 Claude 模型，包括 Sonnet 4.5 和 Sonnet 4（已弃用），拥有 20 万令牌的上下文窗口。

Bedrock 将请求负载限制为 20 MB。当发送大型文档或大量图像时，您可能会在达到令牌限制之前先达到此限制。

全球端点与区域端点

从 Claude Sonnet 4.5 及所有后续模型开始，Bedrock 提供两种端点类型：

• 全球端点： 动态路由以实现最大可用性
• 区域端点： 保证数据通过特定地理区域路由

区域端点的定价比全球端点高 10%。

何时使用各选项

全球端点（推荐）：

• 提供最大的可用性和正常运行时间
• 动态将请求路由到具有可用容量的区域
• 无定价溢价
• 最适合数据驻留要求灵活的应用程序

区域端点（CRIS）：

• 通过特定地理区域路由流量
• 满足数据驻留和合规性要求时必需
• 适用于美国、欧盟、日本和亚太地区
• 10% 的定价溢价反映了专用区域容量的基础设施成本

实现方式

使用全球端点（Opus 4.6、Sonnet 4.6 和 Sonnet 4.5 的默认设置）：

Claude Opus 4.6、Sonnet 4.6 和 Sonnet 4.5 的模型 ID 已包含 global. 前缀：

from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-west-2")

message = client.messages.create(
    model="global.anthropic.claude-opus-4-6-v1",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)

使用区域端点（CRIS）：

要使用区域端点，请将 global. 前缀替换为区域前缀，例如 us.：

from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-west-2")

# 使用美国区域端点（CRIS）
message = client.messages.create(
    model="us.anthropic.claude-opus-4-6-v1",  # Regional prefix
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)

其他资源

• Bedrock 定价： aws.amazon.com/bedrock/pricing
• AWS 定价文档： Bedrock 定价指南
• AWS 博客文章： 在 Amazon Bedrock 中推出 Claude Sonnet 4.5
• Anthropic 定价详情： 云平台定价