先決條件

在使用 Bedrock 配置 Claude Code 之前,請確保您具備:

  • 已啟用 Bedrock 存取權限的 AWS 帳戶
  • 在 Bedrock 中存取所需的 Claude 模型(例如 Claude Sonnet 4)
  • 已安裝並配置的 AWS CLI(可選 - 僅在您沒有其他取得憑證機制時需要)
  • 適當的 IAM 權限

設定

1. 啟用模型存取權限

首先,確保您在 AWS 帳戶中具有所需 Claude 模型的存取權限:

  1. 導航至 Amazon Bedrock 控制台
  2. 在左側導航中前往模型存取權限
  3. 請求存取所需的 Claude 模型(例如 Claude Sonnet 4)
  4. 等待核准(大多數地區通常是即時的)

2. 配置 AWS 憑證

Claude Code 使用預設的 AWS SDK 憑證鏈。使用以下其中一種方法設定您的憑證:

Claude Code 目前不支援動態憑證管理(例如自動呼叫 aws sts assume-role)。您需要自行執行 aws configureaws sso login 或設定 AWS_ 環境變數。

選項 A:AWS CLI 配置

aws configure

選項 B:環境變數(存取金鑰)

export AWS_ACCESS_KEY_ID=your-access-key-id
export AWS_SECRET_ACCESS_KEY=your-secret-access-key
export AWS_SESSION_TOKEN=your-session-token

選項 C:環境變數(SSO 設定檔)

aws sso login --profile=<your-profile-name>

export AWS_PROFILE=your-profile-name

3. 配置 Claude Code

設定以下環境變數以啟用 Bedrock:

# 啟用 Bedrock 整合
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # 或您偏好的地區

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

要自訂模型,請使用以下其中一種方法:

# 使用推論設定檔 ID
export ANTHROPIC_MODEL='us.anthropic.claude-opus-4-20250514-v1:0'
export ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-v1:0'

# 使用應用程式推論設定檔 ARN
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'

IAM 配置

為 Claude Code 建立具有所需權限的 IAM 政策。

詳細資訊請參閱 Bedrock IAM 文件

我們建議為 Claude Code 建立專用的 AWS 帳戶,以簡化成本追蹤和存取控制。

疑難排解

如果您遇到地區問題:

  • 檢查模型可用性:aws bedrock list-inference-profiles --region your-region
  • 切換到支援的地區:export AWS_REGION=us-east-1
  • 考慮使用推論設定檔進行跨地區存取

如果您收到「不支援隨需輸送量」錯誤:

其他資源