모델 ID와 버전 관리
모델 ID와 버전 관리 (Model IDs and versioning)
클로드 모델 ID는 각각 고정된 모델 버전(snapshot)을 가리켜요. API 요청에서 어떤 모델 ID를 사용하면, 그 ID가 유지되는 동안 기반 모델은 일정하게 유지돼요. 특히 4.6 세대부터 도입된 날짜 없는(dateless) 형식이 안정성 측면에서 어떤 의미를 갖는지 이번 페이지에서 자세히 살펴볼게요.
출처: 문서
본문
각 클로드 모델 ID는 고정된(pinned) 버전의 모델을 식별해요. API 요청에서 모델 ID를 사용하면, 해당 ID가 존재하는 동안 기반 모델은 일정하게 유지돼요. 이 보장은 모델 ID에 적용되며, 클로드 API가 일부 이전 모델에 대해 허용하는 편의 별칭(convenience aliases)에는 적용되지 않아요.(4.6 세대 이전 참고)
모델 ID 형식 (Model ID format)
클로드 모델 ID는 버전이 있는 명명 규칙을 따라요.
4.6 세대 이상
Claude 4.6 세대부터 모델 ID는 날짜 없는 형식을 사용해요:
claude-{name}-{major}[-{minor}]
Claude Sonnet 5, Claude Opus 5 같은 메이저 버전 출시는 minor 세그먼트를 생략해요.
예를 들어: 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에서는 형식이 클로드 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
클로드 API에서는 이런 모델에 더 짧은 별칭(예: claude-sonnet-4-5)도 있어서, 해당 minor 버전의 가장 최근 날짜 스냅샷을 가리켜요.
날짜 없는 ID는 고정된 스냅샷 (Dateless IDs are pinned snapshots)
흔한 오해 중 하나는 claude-sonnet-4-6 같은 날짜 없는 모델 ID가 최신 또는 최고 성능 버전으로 라우팅되는 "evergreen" 포인터처럼 동작한다는 것이에요. 하지만 그렇지 않아요.
4.6 세대 이상에서 날짜 없는 ID는 해당 릴리스의 정식(canonical) 모델 ID예요. 이는 단일하고 고정된 모델 스냅샷을 가리켜요. Anthropic은 기존 모델 ID의 가중치나 구성을 업데이트하지 않아요. 업데이트된 버전이 나오면 새 모델 ID로 출시돼요.
이것은 이전 모델에 대해 클로드 API에 존재하는 날짜 없는 별칭과는 달라요. claude-sonnet-4-5 같은 별칭은 해당 minor 버전의 가장 최근 날짜 스냅샷을 가리키는 편의 포인터예요. 반면 claude-sonnet-4-6 같은 4.6 세대 ID는 별칭이 아니라 바로 그 스냅샷 자체예요.
모든 모델 ID는 날짜가 있든 없든 저마다 별도의 폐지 및 은퇴 일정을 가져요.
모델 가중치와 서빙 인프라 (Model weights versus serving infrastructure)
모델 가중치는 주어진 ID에 대해 고정되어 있지만, 모델 주변의 서빙 인프라는 시간이 지나면서 바뀔 수 있어요. 이 인프라에는 요청 라우터, 안전 분류기, 샘플링 로직 같은 구성 요소가 포함돼요.
때때로 인프라 업데이트는 모델 ID와 가중치가 바뀌지 않았더라도 관찰 가능한 동작에 미세한 차이를 만들어 내요. 이전에 안정적이던 모델 ID에서 예상치 못한 동작 차이를 발견했다면, 인프라 업데이트가 가장 유력한 원인일 가능성이 높아요.
현재 모델 ID (Current model IDs)
현재 모델 ID 전체 목록과 그 Amazon Bedrock, Google Cloud 상당 형식은 모델 개요를 참고하세요.