Claude Code 시작하기
3. 모델 alias와 provider 해석5 / 9

alias는 이름이 아니라 움직이는 포인터

provider별 alias 해석, default의 의미, full model name pinning

개념 학습 45 XP 9분

/model sonnet은 어디서나 같은 모델을 뜻하지 않습니다. Anthropic API에서는 Sonnet 5, Claude Platform on AWS에서는 Sonnet 4.6, Bedrock·Vertex·Foundry에서는 Sonnet 4.5로 풀립니다. opus도 마찬가지로 Opus 4.8 / 4.7 / 4.6으로 갈립니다. 게다가 alias는 시간이 지나면 가리키는 버전이 바뀝니다. 그래서 로컬에서 잘 되던 프롬프트가 CI에서 다르게 동작하는 일이 생기고, 원인을 프롬프트에서 찾다가 시간을 씁니다.

환경`opus` alias`sonnet` alias
Anthropic APIOpus 4.8Sonnet 5
Claude Platform on AWSOpus 4.7Sonnet 4.6
Bedrock / Vertex / FoundryOpus 4.6Sonnet 4.5
재현이 필요한 CI·벤치마크full model name 고정full model name 고정
alias는 provider별 권장 버전을 따라가며 시간이 지나면 가리키는 모델이 바뀝니다.
  1. provider 확인/status로 버전·활성 모델·계정·연결 상태를 확인합니다.
  2. 기본값과 세션값 분리/model <name>은 기본값으로 저장되고, 현재 세션만 바꾸려면 picker에서 s를 씁니다.
  3. 재현 경로 고정CI·벤치마크 설정에 full model name을 직접 적어 둡니다.
  4. 실패 경로 지정fallbackModel 또는 --fallback-model opus,sonnet으로 대체 순서를 정합니다.
이전