Claude in Amazon Bedrock（Opus 4.7 及更新版本）

本指南將引導您設定並向 Claude in Amazon Bedrock 發出 API 呼叫。Claude in Amazon Bedrock 在 AWS 管理的基礎設施上執行，具有零操作員存取權限（Anthropic 人員無法存取推論基礎設施），讓您可以完全在 AWS 安全邊界內建構敏感應用程式，同時使用與 Anthropic 第一方 API 相同的 Messages API 格式。



存取

Claude Fable 5、Claude Opus 4.8、Claude Sonnet 5、Claude Opus 4.7 和 Claude Haiku 4.5 對所有 Amazon Bedrock 客戶開放。Claude Mythos Preview 需要邀請；請參閱 Project Glasswing。有關區域可用性，請參閱區域。



先決條件

開始之前，請確保您具備：

• 一個已為您打算使用的 Claude 模型啟用 Amazon Bedrock 模型存取的 AWS 帳戶。
• 已安裝並設定 AWS CLI（選用，用於憑證管理）。

Claude Mythos Preview 另外需要一個已由 Bedrock Marketplace 團隊列入允許清單的專用 AWS 帳戶。您的 Anthropic 客戶主管可以提交您的帳戶 ID 以列入允許清單（通常在 24 小時內處理完成），完成後 AWS 會發送歡迎電子郵件。



身份驗證

Claude in Amazon Bedrock 支援三種身份驗證路徑。請選擇最符合您安全需求的方式。



Bedrock 服務角色（建議）

使用具有 AWS 管理金鑰的 Bedrock 服務角色，以獲得最安全、長期的存取權限：



IAM 擔任角色

適用於具有 12 小時最長工作階段的身份聯合存取：



Bearer 權杖

適用於不使用 IAM 角色的短期存取（最長 12 小時，最不建議）：



安裝 SDK

Anthropic 的用戶端 SDK 透過 Bedrock 專用的套件或模組支援 Claude in Amazon Bedrock。

pip install -U "anthropic[bedrock]"



發出您的第一個請求

端點遵循 https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages 的模式。與基於 InvokeModel 的整合不同，此端點使用標準 SSE 串流（streaming），並使用與 Anthropic 第一方 API 相同的請求主體格式。

SDK 使用標準 AWS 優先順序解析憑證和區域：建構函式引數，然後是環境變數（AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_SESSION_TOKEN、AWS_REGION），然後是 AWS 設定檔和憑證鏈（SSO、擔任角色、ECS 任務角色、IMDS）。

curl https://bedrock-mantle.us-east-1.api.aws/anthropic/v1/messages \
  --aws-sigv4 "aws:amz:us-east-1:bedrock-mantle" \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  -H "x-amz-security-token: $AWS_SESSION_TOKEN" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "anthropic.claude-opus-4-8",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude"}
    ]
  }'



支援的模型

Claude in Amazon Bedrock 中的模型 ID 帶有 anthropic. 提供者前綴。模型功能和行為記錄在模型總覽頁面。



功能支援

有關 Amazon Bedrock 可用性的完整功能清單，請參閱功能總覽。



支援的功能重點

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



不支援的功能

• 輸入來源（圖片和文件的 URL 來源、Files API）
• 伺服器端工具（程式碼執行、網頁搜尋、網頁擷取、advisor）
• 代理基礎設施（Agent Skills、MCP 連接器、程式化工具呼叫）
• API 端點（Message Batches、Models、Admin、Compliance、Usage and Cost）
• Claude Managed Agents
• 伺服器端後備（fallbacks 參數；請改用用戶端後備模式）



區域

Claude in Amazon Bedrock 在以下 AWS 區域可用。Amazon Bedrock 提供兩種端點類型：

• 全球（Global）： 在所有可用區域之間進行動態路由，以獲得最大可用性。無額外定價費用。
• 區域（Regional）： 端點解析至您指定的單一 AWS 區域，以滿足資料駐留需求。區域端點比全球端點多收取 10% 的定價費用。若要在某個地理範圍內跨多個區域路由，請使用推論設定檔（US、EU、JP 或 AU）。表格中標記為僅限區域內的區域支援不使用推論設定檔的直接單一區域路由。

全球端點適用於 Claude Fable 5、Claude Opus 4.8、Claude Opus 4.7、Claude Sonnet 5 和 Claude Haiku 4.5。Claude Mythos Preview 僅限區域性，可在 us-east-1 使用。



配額

預設配額為每分鐘 200 萬個輸入 token（TPM）。您可以在無需額外 Anthropic 核准的情況下申請最多 400 萬個輸入 TPM。AWS 在 Bedrock 端強制執行每分鐘請求數（RPM）限制；如需調整 RPM，請聯絡 AWS 支援。



資料保留

此產品的資料處理由 Amazon Bedrock 管理。詳情請參閱 Amazon Bedrock 中的資料保護。



監控與日誌記錄

Claude in Amazon Bedrock 會將日誌發送到 CloudWatch 和 CloudTrail。Anthropic 建議至少以 30 天滾動方式保留活動日誌，以了解使用模式並調查潛在問題。



支援

如需支援，請聯絡 [email protected]。請附上您的 AWS 帳戶 ID 以及任何失敗 API 回應中的 request-id。