先決條件

在使用 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

選項 D:Bedrock API 金鑰

export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

Bedrock API 金鑰提供更簡單的驗證方法,無需完整的 AWS 憑證。了解更多關於 Bedrock API 金鑰的資訊

3. 配置 Claude Code

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

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

# 可選:覆寫小型/快速模型(Haiku)的區域
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

AWS_REGION 是必需的環境變數。Claude Code 不會從 .aws 配置檔案讀取此設定。

使用 Bedrock 時,/login/logout 命令會被停用,因為驗證是透過 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'

# 可選:如需要可停用提示快取
export DISABLE_PROMPT_CACHING=1

提示快取可能不適用於所有區域

IAM 配置

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

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListInferenceProfiles"
      ],
      "Resource": [
        "arn:aws:bedrock:*:*:inference-profile/*",
        "arn:aws:bedrock:*:*:application-inference-profile/*"
      ]
    }
  ]
}

為了更嚴格的權限,您可以將資源限制為特定的推理設定檔 ARN。

詳細資訊請參閱 Bedrock IAM 文件

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

疑難排解

如果您遇到區域問題:

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

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

其他資源