部署
Amazon Bedrock 上的 Claude Code
了解如何透過 Amazon Bedrock 配置 Claude Code,包括設定、IAM 配置和疑難排解。
先決條件
在使用 Bedrock 配置 Claude Code 之前,請確保您具備:
- 已啟用 Bedrock 存取權限的 AWS 帳戶
- 在 Bedrock 中存取所需的 Claude 模型(例如 Claude Sonnet 4)
- 已安裝並配置的 AWS CLI(可選 - 僅在您沒有其他取得憑證機制時需要)
- 適當的 IAM 權限
設定
1. 啟用模型存取權限
首先,確保您在 AWS 帳戶中具有所需 Claude 模型的存取權限:
- 導航至 Amazon Bedrock 控制台
- 在左側導航中前往模型存取權限
- 請求存取所需的 Claude 模型(例如 Claude Sonnet 4)
- 等待核准(大多數地區通常是即時的)
2. 配置 AWS 憑證
Claude Code 使用預設的 AWS SDK 憑證鏈。使用以下其中一種方法設定您的憑證:
Claude Code 目前不支援動態憑證管理(例如自動呼叫 aws sts assume-role
)。您需要自行執行 aws configure
、aws sso login
或設定 AWS_
環境變數。
選項 A:AWS CLI 配置
選項 B:環境變數(存取金鑰)
選項 C:環境變數(SSO 設定檔)
3. 配置 Claude Code
設定以下環境變數以啟用 Bedrock:
AWS_REGION
是必需的環境變數。Claude Code 不會從 .aws
配置檔案讀取此設定。
4. 模型配置
Claude Code 為 Bedrock 使用這些預設模型:
模型類型 | 預設值 |
---|---|
主要模型 | us.anthropic.claude-3-7-sonnet-20250219-v1:0 |
小型/快速模型 | us.anthropic.claude-3-5-haiku-20241022-v1:0 |
要自訂模型,請使用以下其中一種方法:
IAM 配置
為 Claude Code 建立具有所需權限的 IAM 政策。
詳細資訊請參閱 Bedrock IAM 文件。
我們建議為 Claude Code 建立專用的 AWS 帳戶,以簡化成本追蹤和存取控制。
疑難排解
如果您遇到地區問題:
- 檢查模型可用性:
aws bedrock list-inference-profiles --region your-region
- 切換到支援的地區:
export AWS_REGION=us-east-1
- 考慮使用推論設定檔進行跨地區存取
如果您收到「不支援隨需輸送量」錯誤:
- 將模型指定為推論設定檔 ID