# alias는 이름이 아니라 움직이는 포인터 > provider별 alias 해석, default의 의미, full model name pinning - Canonical: https://learning.reopt.ai/courses/claude-code-getting-started/lessons/ccgs-m3-concept - Language: ko-KR - HTML: https://learning.reopt.ai/courses/claude-code-getting-started/lessons/ccgs-m3-concept --- [Claude Code 시작하기](/courses/claude-code-getting-started) 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에서 다르게 동작하는 일이 생기고, 원인을 프롬프트에서 찾다가 시간을 씁니다. 재현이 필요하면 alias를 쓰지 않는다 CI, 벤치마크, 고객 재현 세션처럼 결과가 같아야 하는 경로는 alias 대신 full model name(예: claude-fable-5 , claude-opus-4-8 )이나 ANTHROPIC_DEFAULT_*_MODEL 로 고정합니다. 탐색적인 대화 세션에만 alias를 씁니다. | 환경 | `opus` alias | `sonnet` alias | | Anthropic API | Opus 4.8 | Sonnet 5 | | Claude Platform on AWS | Opus 4.7 | Sonnet 4.6 | | Bedrock / Vertex / Foundry | Opus 4.6 | Sonnet 4.5 | | 재현이 필요한 CI·벤치마크 | full model name 고정 | full model name 고정 | alias는 provider별 권장 버전을 따라가며 시간이 지나면 가리키는 모델이 바뀝니다. - 1 provider 확인 /status 로 버전·활성 모델·계정·연결 상태를 확인합니다. - 2 기본값과 세션값 분리 /model 은 기본값으로 저장되고, 현재 세션만 바꾸려면 picker에서 s 를 씁니다. - 3 재현 경로 고정 CI·벤치마크 설정에 full model name을 직접 적어 둡니다. - 4 실패 경로 지정 fallbackModel 또는 --fallback-model opus,sonnet 으로 대체 순서를 정합니다. 실무에 남길 기준 - default 는 가장 좋은 모델이 아니라 오버라이드를 지우고 계정 유형별 권장 모델로 되돌리는 값이다 - Haiku는 메인 대화 모델로 쓸 수 없고 서브에이전트 모델로만 배정한다 - 대화가 쌓인 뒤 모델을 바꾸면 캐시 없이 전체 히스토리를 다시 읽어 토큰·지연 비용이 늘어난다 [이전](/courses/claude-code-getting-started/lessons/ccgs-m2-scenario) 이해했어요 · 계속 --- 에이전트용 사이트 안내: https://learning.reopt.ai/llms.txt · 사이트맵: https://learning.reopt.ai/sitemap.xml · 문의: https://learning.reopt.ai/contact