모델 ID 및 버전 관리

각 Claude 모델 ID는 모델의 고정된(pinned) 버전을 식별합니다. API 요청에서 모델 ID를 사용하면, 해당 ID가 유지되는 동안 기반 모델은 변하지 않습니다. 이 보장은 모델 ID에 적용되며, Claude API가 일부 이전 모델에 대해 허용하는 편의용 별칭(alias)에는 적용되지 않습니다(4.6 세대 이전 참조).



모델 ID 형식

Claude 모델 ID는 버전이 지정된 명명 체계를 따릅니다.



4.6 세대 및 이후

Claude 4.6 세대부터 모델 ID는 날짜가 없는 형식을 사용합니다:

claude-{name}-{major}[-{minor}]

Claude Sonnet 5 및 Claude Opus 5와 같은 메이저 버전 릴리스는 마이너 세그먼트를 생략합니다.

예: claude-sonnet-4-6, claude-sonnet-5, claude-opus-4-6, claude-opus-4-7, claude-opus-4-8, claude-opus-5

Amazon Bedrock에서 해당 형식은 다음과 같습니다:

anthropic.claude-{name}-{major}[-{minor}]

예: anthropic.claude-sonnet-4-6, anthropic.claude-sonnet-5, anthropic.claude-opus-4-7, anthropic.claude-opus-4-8, anthropic.claude-opus-5

Claude Opus 4.6은 -v1 접미사를 포함하는 마지막 Bedrock 모델 ID입니다(anthropic.claude-opus-4-6-v1). Anthropic은 Claude Sonnet 4.6부터 이 접미사를 제거했습니다.

Google Cloud에서는 형식이 Claude API와 동일합니다.



4.6 세대 이전

4.6 세대 이전의 모델은 ID에 스냅샷 날짜를 포함합니다:

claude-{name}-{major}-{minor}-{YYYYMMDD}

예: claude-sonnet-4-5-20250929, claude-haiku-4-5-20251001

Amazon Bedrock에서는 다음 형식을 사용합니다:

anthropic.claude-{name}-{major}-{minor}-{YYYYMMDD}-v1:0

예: anthropic.claude-sonnet-4-5-20250929-v1:0

Google Cloud에서는 날짜가 @로 구분됩니다:

claude-{name}-{major}-{minor}@{YYYYMMDD}

예: claude-haiku-4-5@20251001

Claude API에서 이러한 모델에는 해당 마이너 버전의 가장 최근 날짜가 지정된 스냅샷을 가리키는 더 짧은 별칭(예: claude-sonnet-4-5)도 있습니다.



날짜 없는 ID는 고정된 스냅샷입니다

claude-sonnet-4-6과 같은 날짜 없는 모델 ID가 최신 또는 최고 성능 버전으로 라우팅되는 상시 갱신(evergreen) 포인터처럼 동작한다는 것은 흔한 오해입니다. 그렇지 않습니다.

4.6 세대 및 이후의 경우, 날짜 없는 ID가 해당 릴리스의 정식(canonical) 모델 ID입니다. 이는 하나의 고정된 모델 스냅샷에 매핑됩니다. Anthropic은 기존 모델 ID의 가중치나 구성을 업데이트하지 않습니다. 업데이트된 버전이 제공될 때는 새로운 모델 ID로 출시됩니다.

이는 이전 모델을 위해 Claude API에 존재하는 날짜 없는 별칭과는 다릅니다. claude-sonnet-4-5와 같은 별칭은 해당 마이너 버전의 가장 최근 날짜가 지정된 스냅샷으로 해석되는 편의용 포인터입니다. claude-sonnet-4-6과 같은 4.6 세대 ID는 별칭이 아닙니다. 그것이 곧 스냅샷입니다.

날짜가 있든 없든 모든 모델 ID는 각각 고유한 지원 중단(deprecation) 및 서비스 종료(retirement) 일정을 가집니다.



모델 가중치와 서빙 인프라의 차이

모델 가중치는 주어진 ID에 대해 고정되어 있지만, 모델을 둘러싼 서빙 인프라는 시간이 지남에 따라 변경될 수 있습니다. 이 인프라에는 요청 라우터, 안전 분류기, 샘플링 로직과 같은 구성 요소가 포함됩니다.

때때로 인프라 업데이트는 모델 ID와 가중치가 변경되지 않았더라도 관찰 가능한 동작에 사소한 차이를 만들어낼 수 있습니다. 이전에 안정적이었던 모델 ID에서 예상치 못한 동작 차이를 발견했다면, 인프라 업데이트가 가장 가능성 높은 원인입니다.



현재 모델 ID

현재 모델 ID의 전체 목록과 Amazon Bedrock 및 Google Cloud에서의 대응 ID는 모델 개요를 참조하세요.