通俗版 Claude Code 文档

结构照原 docs，内容改成真能照着做的人话版。
查看原始文档 目录顺序与官方保持一致

部署

Amazon Bedrock

Amazon Bedrock 这一页讲的，就是 Amazon Bedrock 这件事在 Claude Code 里到底怎么用。

页面信息

对应原页

Amazon Bedrock

页面性质

第三方中文解释页

使用建议

先看人话解释，再对照原页命令和代码

这页不是官方原文，而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留，解释部分则尽量讲成人能照着做的话。

如果你碰到特别敏感的配置、权限或企业环境差异，最好顺手点上面的“查看原始文档”再核一遍。

这一页先讲明白

这页讲如何通过 AWS Bedrock 使用 Claude Code。

适合本来就扎在 AWS 体系里的团队。

如果你们账号、权限、网络、审计都已经建在 AWS 上，走 Bedrock 通常更顺。

这样运维和合规都更容易接进现有体系。

先把 AWS 账号、区域、权限角色这些基础打通，再看 Claude Code 这层。

企业环境里，云平台接入通常不难，难的是权限边界要事先讲清。

预留广告位

正文中段响应式广告 等你后面真接 AdSense，这里再放正式广告。

Documentation Index

这里不是让你背"Documentation Index"这个词，而是让你看它真干活时怎么使。

Prerequisites

这一块主要是在说"Prerequisites"真到手上该怎么用，哪里最容易踩坑。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

Sign in with Bedrock

这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Set up manually

这段就是开工前的准备清单，先把地基打好。

如果你看到环境变量或 settings.json，意思通常都是：这不是会话里临时喊一声就行，而是要把开关真正写进环境或配置。

1. Submit use case details

这里不是让你背"1. Submit use case details"这个词，而是让你看它真干活时怎么使。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

2. Configure AWS credentials

看到这里，就把"2. Configure AWS credentials"当成一件真要上手的活来看。

如果你看到环境变量或 settings.json，意思通常都是：这不是会话里临时喊一声就行，而是要把开关真正写进环境或配置。

关键片段

2. Configure AWS credentials 1

先看下面这块原始片段，等会儿再回头看解释会顺得多。

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
关键片段

2. Configure AWS credentials 2

先看下面这块原始片段，等会儿再回头看解释会顺得多。

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

export AWS_PROFILE=your-profile-name
关键片段

2. Configure AWS credentials 3

先看下面这块原始片段，等会儿再回头看解释会顺得多。

export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key
改配置

2. Configure AWS credentials 4

这一段说完，最后还得写到配置里才算真的生效。

{
  "awsAuthRefresh": "aws sso login --profile myprofile",
  "env": {
    "AWS_PROFILE": "myprofile"
  }
}

3. Configure Claude Code

这一段主要是在把"3. Configure Claude Code"讲实，不是只摆个标题给你看。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

关键片段

3. Configure Claude Code

这一段要真抓重点，通常就抓下面这块原文。

# Enable Bedrock integration
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # or your preferred region

# Optional: Override the region for the small/fast model (Haiku).
# Also applies to Bedrock Mantle.
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

# Optional: Override the Bedrock endpoint URL for custom endpoints or gateways
# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com

4. Pin model versions

看到这里，就把"4. Pin model versions"当成一件真要上手的活来看。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

终端里敲

4. Pin model versions 1

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-7'
export ANTHROPIC_DEFAULT_SONNET_MODEL='us.anthropic.claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'
终端里敲

4. Pin model versions 2

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

# Using inference profile ID
export ANTHROPIC_MODEL='us.anthropic.claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

# Using application inference profile ARN
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'

# Optional: Disable prompt caching if needed
export DISABLE_PROMPT_CACHING=1

# Optional: Request 1-hour prompt cache TTL instead of the 5-minute default
export ENABLE_PROMPT_CACHING_1H=1
改配置

4. Pin model versions 3

这一段说完，最后还得写到配置里才算真的生效。

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-47-prod",
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod",
    "claude-opus-4-5-20251101": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-45-prod",
    "claude-opus-4-1-20250805": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-41-prod"
  }
}

Startup model checks

这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

IAM configuration

这一段是在教你把 an IAM policy with the required permissions for Claude Code: 真正建出来。文件放哪儿、字段怎么写、建完怎么验，都得跟着看。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

改配置

IAM configuration

这一段说完，最后还得写到配置里才算真的生效。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowModelAndInferenceProfileAccess",
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListInferenceProfiles",
        "bedrock:GetInferenceProfile"
      ],
      "Resource": [
        "arn:aws:bedrock:*:*:inference-profile/*",
        "arn:aws:bedrock:*:*:application-inference-profile/*",
        "arn:aws:bedrock:*:*:foundation-model/*"
      ]
    },
    {
      "Sid": "AllowMarketplaceSubscription",
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ViewSubscriptions",
        "aws-marketplace:Subscribe"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:CalledViaLast": "bedrock.amazonaws.com"
        }
      }
    }
  ]
}

1M token context window

这一段主要是在把"1M token context window"讲实，不是只摆个标题给你看。

Service tiers

这一段主要是在把"Service tiers"讲实，不是只摆个标题给你看。

关键片段

Service tiers

这一段要真抓重点，通常就抓下面这块原文。

export ANTHROPIC_BEDROCK_SERVICE_TIER=priority

AWS Guardrails

这一块主要是在说"AWS Guardrails"真到手上该怎么用，哪里最容易踩坑。

改配置

AWS Guardrails

想把这条规矩固定住，就把下面这块老老实实写进去。

{
  "env": {
    "ANTHROPIC_CUSTOM_HEADERS": "X-Amzn-Bedrock-GuardrailIdentifier: your-guardrail-id\nX-Amzn-Bedrock-GuardrailVersion: 1"
  }
}

Use the Mantle endpoint

这一段主要是在把"Use the Mantle endpoint"讲实，不是只摆个标题给你看。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

Enable Mantle

看到这类标题，就当是在调一个具体开关。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

关键片段

Enable Mantle

这一段要真抓重点，通常就抓下面这块原文。

export CLAUDE_CODE_USE_MANTLE=1
export AWS_REGION=us-east-1

Select a Mantle model

看到这里，就把"Select a Mantle model"当成一件真要上手的活来看。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

终端里敲

Select a Mantle model

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

claude --model anthropic.claude-haiku-4-5

Run Mantle alongside the Invoke API

别把这段只当成标题看，它其实是在给"Run Mantle alongside the Invoke API"划边界。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

关键片段

Run Mantle alongside the Invoke API 1

先看下面这块原始片段，等会儿再回头看解释会顺得多。

export CLAUDE_CODE_USE_BEDROCK=1
export CLAUDE_CODE_USE_MANTLE=1
改配置

Run Mantle alongside the Invoke API 2

这一段说完，最后还得写到配置里才算真的生效。

{
  "availableModels": ["opus", "sonnet", "haiku", "anthropic.claude-haiku-4-5"]
}

Route Mantle through a gateway

这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。

关键片段

Route Mantle through a gateway

这一段要真抓重点，通常就抓下面这块原文。

export CLAUDE_CODE_USE_MANTLE=1
export CLAUDE_CODE_SKIP_MANTLE_AUTH=1
export ANTHROPIC_BEDROCK_MANTLE_BASE_URL=https://your-gateway.example.com

Mantle environment variables

看到这里，就把"Mantle environment variables"当成一件真要上手的活来看。

如果你看到环境变量或 settings.json，意思通常都是：这不是会话里临时喊一声就行，而是要把开关真正写进环境或配置。

Troubleshooting

这里讲的是怎么找毛病，先查明白哪一步出错，再决定怎么修。

Authentication loop with SSO and corporate proxies

这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。

Region issues

这段就是排错时拿来照着查的，先一项项看清楚，再动手改。

Mantle endpoint errors

这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。

如果你看到环境变量或 settings.json，意思通常都是：这不是会话里临时喊一声就行，而是要把开关真正写进环境或配置。

Additional resources

这一段主要是在把"Additional resources"讲实，不是只摆个标题给你看。

照着做一遍

这页属于“Amazon Bedrock”这类活，最稳的办法还是一小步一小步来。

下面这三步不一定华丽，但通常最不容易绕晕。

第 1 步：先起步

先把 AWS 账号、区域、权限角色这些基础打通，再看 Claude Code 这层。

第 2 步：边做边看

企业环境里，云平台接入通常不难，难的是权限边界要事先讲清。

一眼看懂这一页

这页的作用，就是把原本偏专业的话题，拆成能直接照着走的明白话。

Amazon Bedrock
   |
   v
Amazon Bedrock 这一页讲的，就是 Amazon Bedrock 这件事在 Claude Code 里到底怎么用。
   |
   v
照着步骤去做

文末提醒

这站会按官方 docs 的导航和内容变化继续重生成，原站加页、删页、改页时，这里会跟着更新。

人话解释会尽量顺着原页往下讲，但命令、参数名、配置名这些硬东西还是保留原样，免得你抄过去跑不起来。

预留广告位

文末横幅广告 适合放在文章读完以后，不抢首屏注意力。