Amazon Bedrock의 Claude Haiku 5.5

Claude Haiku 5.5는 2026년 10월 7일 출시와 동시에 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와 추론 프로필

프로필 접두사는 AWS 발표에서, 가격은 OpenCode가 사용하는 models.dev (opens in a new tab) 카탈로그에서 가져왔습니다. 가격과 리전 목록은 AWS가 정하므로, 예산을 정하기 전에 Bedrock 가격 페이지 (opens in a new tab)에서 둘 다 확인하세요.

데이터 상주 요건이 없다면 global.을 선택하세요. Bedrock이 라우팅할 수 있는 용량이 가장 큽니다. 요청이 특정 관할권 안에 머물러야 한다면 지역 프로필을 선택하고 더 높은 가격을 감안하세요. AWS 발표에 따르면 AWS GovCloud (US)도 지원됩니다.

Bedrock 가격

global 프로필 기준이며 단위는 100만 토큰당 미국 달러입니다. us., eu., jp., au. 프로필은 1.1을 곱합니다.

Claude API와 마찬가지로 구간은 요청마다 캐시 읽기를 포함한 전체 프롬프트 길이로 정해집니다. jp. 프로필에서 입력 20K, 출력 2K 토큰인 요청은 $0.003이 아니라 약 $0.0033입니다. 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 제공업체는 AWS 자격 증명 체인을 사용합니다. opencode를 실행하는 환경에 자격 증명을 설정하세요. 예를 들어 이름 있는 프로필을 쓰면 다음과 같습니다.

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

AWS_BEARER_TOKEN_BEDROCK에 넣은 Bedrock API 키나 /connect로 저장한 키는 모든 프로필과 액세스 키보다 우선합니다. 호출이 다른 계정으로 간다면 먼저 남아 있는 bearer token이 없는지 확인하세요. 모든 인증 방법은 Amazon Bedrock 제공업체 가이드에 있습니다.

리전, 프로필, 모델을 프로젝트에 고정하려면 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를 small model로 쓰기

기본으로 더 큰 Bedrock 모델을 쓰는 세션에서 가벼운 작업을 Haiku 5.5에 맡길 수 있습니다.

{
  "$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"
}

두 모델 모두 계정에서 활성화되어 있어야 합니다. 계정마다 사용 가능 여부가 다르므로 Sonnet 5.5의 프로필 ID는 /models에서 확인하세요.

애플리케이션 추론 프로필

조직에서 애플리케이션 추론 프로필로 비용을 추적한다면, 읽기 쉬운 키를 쓰고 프로필 ARN을 id에 넣으세요. 그래야 프롬프트 캐싱이 제대로 동작합니다.

{
  "$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는 실제 값으로 바꾸세요.

문제 해결

일반적인 인증과 할당량 문제는 제공업체 설정과 문제 해결을 참고하세요.

Bedrock과 Claude API 중 무엇을 쓸까

조직이 이미 AWS로 과금, 감사, 접근 제어를 하고 있거나 IAM, VPC 엔드포인트, 리전 단위 데이터 통제가 필요하다면 Bedrock이 적합합니다. 개인 개발자에게는 Claude API가 더 간단합니다. API 키 하나로 같은 기본 가격을 쓰고 IAM이나 리전 설정이 필요 없습니다. OpenCode에서 둘 사이를 바꿀 때는 제공업체 접두사와 자격 증명만 바꾸면 됩니다. 두 ID 모두 Claude Haiku 5.5 가이드에 정리되어 있습니다.