--- title: Amazon Bedrock 中的 Claude（Opus 4.7 及更新版本） url: https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-amazon-bedrock description: 透過 Amazon Bedrock 存取 Claude 模型，使用 AWS 原生的身分驗證、計費與安全邊界。 --- 本指南將引導您完成設定並對 Amazon Bedrock 中的 Claude 發出 API 呼叫。Amazon Bedrock 中的 Claude 在 AWS 管理的基礎設施上執行，具備零操作人員存取權限（Anthropic 人員無法存取推論基礎設施），讓您能夠完全在 AWS 安全邊界內建構敏感應用程式，同時使用與 Anthropic 第一方 API 相同的 Messages API 格式。 本頁面涵蓋 Amazon Bedrock 中的 Claude，它在 AWS 管理的基礎設施上透過位於 `/anthropic/v1/messages` 的 Messages API 提供 Claude 服務。先前的 Amazon Bedrock 整合（使用 ARN 版本化模型識別碼的 `InvokeModel` 與 `Converse` API）仍然可用，相關文件請參閱 [Amazon Bedrock 上的 Claude（Opus 4.6 及更早版本）](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-on-amazon-bedrock-legacy)。若需要在 AWS 上由 Anthropic 營運、採用 AWS Marketplace 計費且通常可當日取得新功能的替代方案，請參閱 [Claude Platform on AWS](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws)。 ## 存取 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 模型存取](https://console.aws.amazon.com/bedrock/home#/modelaccess)。Claude Mythos Preview 需要透過 [Project Glasswing](https://anthropic.com/glasswing) 取得邀請。關於區域可用性，請參閱[區域](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-amazon-bedrock#regions)。 ## 先決條件 開始之前，請確認您具備： * 一個 AWS 帳戶，且已針對您打算使用的 Claude 模型啟用 [Amazon Bedrock 模型存取](https://console.aws.amazon.com/bedrock/home#/modelaccess)。 * 已安裝並設定 [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)（選用，用於憑證管理）。 Claude Mythos Preview 另外需要一個已由 Bedrock Marketplace 團隊加入允許清單的專用 AWS 帳戶。您的 Anthropic 客戶經理可以提交您的帳戶 ID 以加入允許清單（通常在 24 小時內處理完成），完成後 AWS 會寄送歡迎電子郵件。 ## 身分驗證 Amazon Bedrock 中的 Claude 支援三種身分驗證途徑。請選擇最符合您安全需求的方式。 ### Bedrock 服務角色（建議） 使用搭配 AWS 管理金鑰的 Bedrock 服務角色，以取得最安全、長期有效的存取： AWS 管理員佈建一個 Bedrock 服務角色，並授予開發人員對該服務角色 ARN 的 `iam:PassRole` 權限。 呼叫 API 時，Bedrock 會代表您擔任該服務角色。關於如何將角色與您的請求建立關聯，請參閱 [Amazon Bedrock 文件](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-mantle.html)。 ### IAM 擔任角色 適用於身分聯合存取，工作階段最長 12 小時： 建立一個範圍限定於您的 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 Anthropic 的[用戶端 SDK](https://platform.claude.com/docs/zh-TW/cli-sdks-libraries/overview) 透過 Bedrock 專用的套件或模組支援 Amazon Bedrock 中的 Claude。 ```bash pip install -U "anthropic[bedrock]" ``` ```bash npm install @anthropic-ai/bedrock-sdk ``` ```bash dotnet add package Anthropic.Bedrock ``` ```bash go get github.com/anthropics/anthropic-sdk-go/bedrock ``` ```kotlin implementation("com.anthropic:anthropic-java:2.73.0") implementation("com.anthropic:anthropic-java-bedrock:2.73.0") ``` ```xml com.anthropic anthropic-java 2.73.0 com.anthropic anthropic-java-bedrock 2.73.0 ``` ```bash composer require anthropic-ai/sdk aws/aws-sdk-php ``` ```bash # Gemfile gem "anthropic" gem "aws-sdk-core" ``` ## 發出您的第一個請求 端點遵循 `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）。 ```bash 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-5-5", "max_tokens": 1024, "messages": [ {"role": "user", "content": "Hello, Claude"} ] }' ``` `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); } ``` ```csharp 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() { Role = Role.User, 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 ``` 您也可以使用 `Anthropic` (go: `anthropic.NewClient()`; java: `AnthropicOkHttpClient.builder()`; csharp: `AnthropicClient`; php: `Anthropic\Client`; ruby: `Anthropic::Client`) 建立標準用戶端：將 `base_url` (typescript: `baseURL`; go: `option.WithBaseURL()`; java: `.baseUrl()`; csharp: `BaseUrl`; php: `baseUrl`) 設定為 `https://bedrock-mantle.{region}.api.aws/anthropic`，並將您的 bearer 權杖作為 `api_key` (typescript, php: `apiKey`; go: `option.WithAPIKey()`; java: `.apiKey()`; csharp: `ApiKey`) 傳遞。此途徑僅支援 bearer 權杖驗證。SigV4 簽署需要使用 `AnthropicBedrockMantle` (csharp: `AnthropicBedrockMantleClient`; go: `bedrock.NewMantleClient`; java: `BedrockMantleBackend`; php: `MantleClient`; ruby: `Anthropic::BedrockMantleClient`)。 ## 支援的模型 Amazon Bedrock 中的 Claude 模型 ID 帶有 `anthropic.` 提供者前綴。模型的功能與行為記載於[模型概覽](https://platform.claude.com/docs/zh-TW/models/overview)頁面。 | Model | Model ID | Access | | :------------------------------------------------------------------------------------------ | :-------------------------------- | :----------------------------------------------------------------------------------------------------- | | Claude Fable 5.1 | `anthropic.claude-fable-5-1` | Open | | Claude Mythos 5.1 ([limited availability](https://support.claude.com/en/articles/14604842)) | `anthropic.claude-mythos-5-1` | Active (verification required) | | Claude Fable 5 | `anthropic.claude-fable-5` | Open | | Claude Mythos 5 ([limited availability](https://support.claude.com/en/articles/14604842)) | `anthropic.claude-mythos-5` | Active (verification required) | | Claude Mythos Preview ([limited availability](https://anthropic.com/glasswing)) | `anthropic.claude-mythos-preview` | Invitation only | | Claude Opus 5.5 | `anthropic.claude-opus-5-5` | [See Access](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-amazon-bedrock#access) | | Claude Opus 5 | `anthropic.claude-opus-5` | [See Access](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-amazon-bedrock#access) | | Claude Opus 4.8 | `anthropic.claude-opus-4-8` | Open | | Claude Opus 4.7 | `anthropic.claude-opus-4-7` | Open | | Claude Sonnet 5.5 | `anthropic.claude-sonnet-5-5` | [See Access](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-amazon-bedrock#access) | | Claude Sonnet 5 | `anthropic.claude-sonnet-5` | Open | | Claude Haiku 5.5 | `anthropic.claude-haiku-5-5` | [See Access](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-amazon-bedrock#access) | | Claude Haiku 4.5 | `anthropic.claude-haiku-4-5` | Open | 請搭配 Amazon Bedrock 中的 Claude 使用最新版本的 Claude Code；執行 `claude update` 進行升級。 正在升級到較新的 Claude 模型嗎？在 Claude Code 中，執行 `/claude-api migrate` 即可在您的整個程式碼庫中套用模型 ID 替換與破壞性參數變更。此技能會偵測您的程式碼所針對的雲端平台，並針對該平台調整模型 ID 格式與功能變更。請參閱[遷移至較新的 Claude 模型](https://platform.claude.com/docs/zh-TW/agents-and-tools/agent-skills/claude-api-skill#migrating-to-a-newer-claude-model)。 ## 功能支援 關於包含 Amazon Bedrock 可用性的完整功能清單，請參閱[功能概覽](https://platform.claude.com/docs/zh-TW/build-with-claude/overview)。 ### 支援的功能重點 * [Messages API](https://platform.claude.com/docs/zh-TW/api/messages/create)（`/anthropic/v1/messages`） * [提示快取](https://platform.claude.com/docs/zh-TW/build-with-claude/prompt-caching)（prompt caching） * [思考](https://platform.claude.com/docs/zh-TW/build-with-claude/thinking) * [工具使用](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/overview)（tool use），包括 [Bash 工具](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/bash-tool)、[電腦使用工具](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/computer-use-tool)、[記憶工具](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/memory-tool)以及[文字編輯器工具](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/text-editor-tool) * [引用](https://platform.claude.com/docs/zh-TW/build-with-claude/citations) ### 不支援的功能 * [結構化輸出](https://platform.claude.com/docs/zh-TW/build-with-claude/structured-outputs) * 輸入來源（圖片與文件的 URL 來源、Files API） * 伺服器端工具（程式碼執行、網頁搜尋、網頁擷取、advisor） * 代理基礎設施（Agent Skills、MCP 連接器、程式化工具呼叫） * API 端點（Message Batches、Models、Admin、Compliance、Usage and Cost） * Claude Managed Agents * 伺服器端備援（[`fallbacks` 參數](https://platform.claude.com/docs/zh-TW/build-with-claude/refusals-and-fallback#server-side-fallback)；請改用[用戶端備援模式](https://platform.claude.com/docs/zh-TW/build-with-claude/refusals-and-fallback#client-side-fallback)） * [電腦使用](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/computer-use-tool)與[瀏覽器使用](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/browser-use-tool)工具集（`computer_toolset_20260801` 與 `browser_toolset_20260801` 目前在 Amazon Bedrock 上不可用；beta 版電腦使用工具版本仍然可用） ## 區域 Amazon Bedrock 中的 Claude 可在下列 AWS 區域使用。Amazon Bedrock 提供兩種端點類型： * **全球：** 在所有可用區域之間動態路由，以獲得最高可用性。無額外定價加成。 * **區域：** 端點會解析至您指定的單一 AWS 區域，以滿足資料落地需求。區域端點的定價比全球端點高出 10%。若要在某個地理區域內的多個區域之間路由，請使用[推論設定檔](https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html)（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。對於 Claude Fable 5.1，區域端點目前僅在 `us-east-1` 提供。Claude Mythos Preview 僅提供區域端點，且可在 `us-east-1` 使用。 | 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 萬個輸入 token（TPM）。您可以申請最高每分鐘 500 萬個輸入 TPM 與 50 萬個輸出 TPM，無需 Anthropic 額外核准。AWS 在 Bedrock 端執行每分鐘請求數（RPM）限制；如需調整 RPM，請聯絡 AWS 支援。 ## 資料保留 此服務的資料處理由 Amazon Bedrock 管轄。詳情請參閱 [Amazon Bedrock 中的資料保護](https://docs.aws.amazon.com/bedrock/latest/userguide/data-protection.html)。 ## 監控與記錄 Amazon Bedrock 中的 Claude 會將日誌輸出至 CloudWatch 與 CloudTrail。Anthropic 建議至少以 30 天滾動方式保留活動日誌，以了解使用模式並調查潛在問題。 ## 支援 如需支援，請聯絡 **[bedrock-ant-eap@amazon.com](mailto:bedrock-ant-eap@amazon.com)**。請附上您的 AWS 帳戶 ID 以及任何失敗 API 回應中的 `request-id`。 **Claude Mythos Preview** 是一個研究預覽模型，提供給 Amazon Bedrock 上受邀的客戶。如需更多資訊，請參閱 [Project Glasswing](https://anthropic.com/glasswing)。