모델 ID 및 버전 관리

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



모델 ID 형식

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



4.6 세대 이후

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

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

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

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

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

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

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

Google Cloud Vertex AI에서는 형식이 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 Vertex AI에서는 날짜가 @로 구분됩니다.

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

예: claude-haiku-4-5@20251001

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



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

흔한 오해 중 하나는 claude-sonnet-4-6과 같은 날짜 없는 모델 ID가 최신 버전이나 가장 성능이 좋은 버전으로 라우팅되는 상시 업데이트 포인터처럼 동작한다는 것입니다. 이는 사실이 아닙니다.

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

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

날짜가 있든 없든 모든 모델 ID는 각자 고유한 지원 중단 및 종료 일정을 가지고 있습니다.



모델 가중치와 서빙 인프라

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

경우에 따라 모델 ID와 가중치가 변경되지 않았더라도 인프라 업데이트로 인해 관찰 가능한 동작에 사소한 차이가 발생할 수 있습니다. 이전에 안정적이었던 모델 ID에서 예상치 못한 동작 차이를 발견한 경우, 인프라 업데이트가 가장 유력한 원인입니다.



현재 모델 ID

현재 모델 ID의 전체 목록과 해당 Amazon Bedrock 및 Google Cloud Vertex AI 대응 항목은 모델 개요를 참조하세요.