​
先決條件

在使用 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 configure、aws 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
  • 考慮使用推理設定檔進行跨區域存取

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

​
其他資源