Amazon Bedrock 上的 Claude（舊版）

透過 Bedrock 呼叫 Claude 與直接在 Claude API 上呼叫 Claude 略有不同。本指南將引導您使用 Anthropic 的用戶端 SDK 之一，完成對 Bedrock 上 Claude 的 API 呼叫。

請注意，本指南假設您已經註冊了 AWS 帳戶並設定了程式化存取。



安裝並設定 AWS CLI

1. 安裝版本為 2.13.23 或更新的 AWS CLI
2. 使用 AWS configure 命令設定您的 AWS 憑證（請參閱設定 AWS CLI），或在 AWS 儀表板中導覽至「Command line or programmatic access」並依照彈出視窗中的指示找到您的憑證。
3. 驗證您的憑證是否正常運作：

aws sts get-caller-identity



安裝用於存取 Bedrock 的 SDK

Anthropic 的用戶端 SDK 支援 Bedrock。您也可以直接使用像 boto3 這樣的 AWS SDK。



存取 Bedrock



訂閱 Anthropic 模型

前往 AWS Console > Bedrock > Model Access 並申請存取 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 token 驗證

您可以使用 bearer token 而非 AWS 憑證來向 Bedrock 進行驗證。這在企業環境中非常有用，因為團隊需要存取 Bedrock，但不需要管理 AWS 憑證、IAM 角色或帳戶層級的權限。

最簡單的方法是設定 AWS_BEARER_TOKEN_BEDROCK 環境變數，每個 SDK 在從環境解析憑證時都會自動偵測該變數。

若要以程式化方式提供 token：

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    api_key="your-bearer-token",
    aws_region="us-west-2",
)

message = client.messages.create(
    model="us.anthropic.claude-sonnet-4-5-20250929-v1:0",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)



活動記錄

Bedrock 提供調用記錄服務，讓客戶可以記錄與您的使用相關的提示和完成內容。

Anthropic 建議您至少以 30 天的滾動週期記錄您的活動，以了解您的活動並調查任何潛在的濫用行為。



功能支援

如需包含 Amazon Bedrock 可用性的完整功能清單，請參閱功能概覽。



支援的功能重點

• Messages API
• 提示快取
• 擴展思考
• 工具使用，包括 Bash 工具、電腦使用工具、記憶工具和文字編輯器工具
• 引用
• 結構化輸出



不支援的功能

• 輸入來源（圖片和文件的 URL 來源、Files API）
• 伺服器端工具（程式碼執行、網頁搜尋、網頁擷取、advisor）
• 代理基礎設施（Agent Skills、MCP 連接器、程式化工具呼叫）
• API 端點（Message Batches、Models、Admin、Compliance、Usage and Cost）
• Claude Managed Agents
• 伺服器端備援（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 萬 token 的上下文視窗。其他 Claude 模型，包括 Sonnet 4.5 和 Sonnet 4（已棄用），具有 20 萬 token 的上下文視窗。

Bedrock 將請求酬載限制為 20 MB。傳送大型文件或大量圖片時，您可能會在達到 token 限制之前先達到此限制。



全域與區域端點

從 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 定價詳細資訊： 雲端平台定價