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 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 在從環境解析憑證時都會自動偵測此變數。

若要以程式化方式提供權杖：

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）
• 伺服器端工具（程式碼執行、網頁搜尋、網頁擷取、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 定價詳情： 雲端平台定價