中文
实用指南
Haiku 5.5(Bedrock)

Amazon Bedrock 上的 Claude Haiku 5.5

Claude Haiku 5.5 在 2026-10-07 发布当天就上线了 Amazon Bedrock(AWS 公告 (opens in a new tab))。Bedrock 模型 ID 是 anthropic.claude-haiku-5-5,多数账户通过 global.anthropic.claude-haiku-5-5 这类跨区域推理配置文件调用。

本文说明该用哪个 ID、各自的价格、需要的 IAM 权限,以及如何接入 OpenCode。模型本身的跑分和 100K 价格分档见 Claude Haiku 5.5 指南。

Bedrock 模型 ID 与推理配置文件

ID路由范围标价(相对 Claude API)
global.anthropic.claude-haiku-5-5任意支持的商业区域相同
anthropic.claude-haiku-5-5你调用的区域相同
us.anthropic.claude-haiku-5-5仅美国区域1.1 倍
eu.anthropic.claude-haiku-5-5仅欧盟区域1.1 倍
jp.anthropic.claude-haiku-5-5仅日本区域1.1 倍
au.anthropic.claude-haiku-5-5仅澳大利亚区域1.1 倍

配置文件前缀来自 AWS 公告,价格来自 OpenCode 使用的 models.dev (opens in a new tab) 模型目录。价格和区域列表以 AWS 为准,做预算前请在 Bedrock 定价页 (opens in a new tab)确认。

没有数据驻留要求时选 global.,Bedrock 可路由的容量最大。请求必须留在某个司法辖区内时选地区配置文件,并把更高的价格算进去。按 AWS 公告,AWS GovCloud (US) 也支持该模型。

Bedrock 上的价格

global 配置文件的价格,单位是美元/百万 token。us.、eu.、jp.、au. 配置文件乘以 1.1。

Token 类型提示词 ≤ 100K token提示词 > 100K token
输入$0.10$0.50
输出$0.50$2.50
5 分钟缓存写入$0.125$0.625
缓存读取$0.01$0.05

和 Claude API 一样,分档按单次请求的提示词总长度判断,缓存读取也计入。用 us. 配置文件时,输入 20K、输出 2K 的请求约为 $0.0033,而不是 $0.003。用 AWS Cost Explorer 或 CloudWatch 把实际用量和这些数字对比。

配置 OpenCode 之前

  1. 启用模型。 打开 Bedrock 控制台的模型目录,确认你的账户在要调用的区域可以使用 Claude Haiku 5.5。
  2. 授予 IAM 权限。 OpenCode 使用的身份需要 bedrock:InvokeModel 和 bedrock:InvokeModelWithResponseStream。使用推理配置文件时,策略需要同时允许配置文件本身和它会路由到的各区域中的基础模型,见 AWS 跨区域推理 (opens in a new tab)。
  3. 先在 OpenCode 之外测试。 直接调用一次,可以把 AWS 权限问题和 OpenCode 配置问题分开:
aws bedrock-runtime converse \
  --region us-east-1 \
  --model-id global.anthropic.claude-haiku-5-5 \
  --messages '[{"role":"user","content":[{"text":"Reply with OK"}]}]'

如果这一步失败,先解决 AWS 侧的问题,重装 OpenCode 不会改变结果。

在 OpenCode 中配置 Amazon Bedrock

OpenCode 的 amazon-bedrock provider 使用 AWS 凭据链。在启动 opencode 的环境中设置凭据,例如命名 profile:

AWS_PROFILE=my-profile AWS_REGION=us-east-1 opencode

AWS_BEARER_TOKEN_BEDROCK 中的 Bedrock API Key,或通过 /connect 保存的 Key,优先级高于所有 profile 和访问密钥。如果调用落到了错误的账户,先检查是否残留了 bearer token。全部认证方式见 Amazon Bedrock Provider 文档。

要把区域、profile 和模型固定在项目里,写入 opencode.json:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "amazon-bedrock/global.anthropic.claude-haiku-5-5",
  "provider": {
    "amazon-bedrock": {
      "options": {
        "region": "us-east-1",
        "profile": "my-profile"
      }
    }
  }
}

配置文件中的选项优先于环境变量。使用 VPC 端点时,按 Bedrock 配置选项添加 endpoint。启动 OpenCode,运行 /models,确认 Amazon Bedrock 下有 Claude Haiku 5.5 后再发送提示词。

把 Haiku 5.5 设为小模型

默认使用更大的 Bedrock 模型时,可以把轻量工作交给 Haiku 5.5:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "amazon-bedrock/global.anthropic.claude-sonnet-5-5",
  "small_model": "amazon-bedrock/global.anthropic.claude-haiku-5-5"
}

两个模型都必须在你的账户中启用。各账户的可用情况不同,请在 /models 中核对 Sonnet 5.5 的配置文件 ID。

应用推理配置文件

如果组织用应用推理配置文件(application inference profile)统计成本,用一个易读的键名,把配置文件 ARN 写进 id,这样提示词缓存才能正常工作:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "amazon-bedrock": {
      "models": {
        "claude-haiku-5-5-team": {
          "id": "arn:aws:bedrock:us-east-1:111122223333:application-inference-profile/abc123"
        }
      }
    }
  }
}

把账号和配置文件 ID 换成你自己的值。

常见问题排查

现象检查项
AccessDeniedException配置文件和各路由区域中基础模型的 IAM 权限,以及模型是否已启用
提示按需吞吐量(on-demand throughput)的 ValidationException改用推理配置文件 ID(global. 或地区前缀),不要用基础 ID
/models 中没有该模型升级 OpenCode,再确认区域和账户有访问权限
请求落到意外的账户bearer token 会覆盖 profile;取消 AWS_BEARER_TOKEN_BEDROCK 或删除 /connect 保存的凭据
ThrottlingException检查该区域和配置文件的 Bedrock 配额;global. 配置文件可路由到更多区域

一般的认证和额度问题见模型连接排障。

用 Bedrock 还是 Claude API?

如果组织已经通过 AWS 统一计费、审计和管控访问,或者需要 IAM、VPC 端点和区域级数据控制,选 Bedrock。个人开发者用 Claude API 更简单:一个 API Key,基础价格相同,不需要配置 IAM 和区域。在 OpenCode 中两者之间切换,只需要改 provider 前缀和凭据。两种 ID 都列在 Claude Haiku 5.5 指南里。