Claude Code는 공식적으로 Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Haiku 4.5를 지원합니다. 복잡한 에이전트 기반 코딩에는 Opus 5가 가장 안전한 기본 선택입니다. 가장 어렵고 오래 실행되는 세션에는 Fable 5가 최상위 옵션입니다. 일상적인 작업에는 Sonnet 5가 균형 잡힌 선택입니다. 빠르고 저렴한 반복 작업에는 Haiku 4.5가 속도 측면에서 최적입니다.
Claude Code가 현재 지원하는 모델
Claude Code는 모든 모델을 동일하게 취급하지 않습니다. 내장된 별칭(alias)은 특정 Claude 제품군 멤버에 매핑되며, 이 별칭은 제공업체에 따라 다르게 해석될 수 있습니다.
| 모델 | 최적 사용 사례 | Claude Code에 적합한 이유 |
|---|---|---|
| Claude Fable 5 | 장기 실행 에이전트 작업 | 최고 성능, 1M 컨텍스트, 심층 조사에 가장 강력함 |
| Claude Opus 5 | 복잡한 코딩 및 엔터프라이즈 작업 | Anthropic이 진지한 에이전트 코딩에 권장하는 시작점 |
| Claude Sonnet 5 | 일상적인 코딩 작업 | 속도와 지능의 최상의 균형 |
| Claude Haiku 4.5 | 소규모 작업 및 빠른 반복 | 최첨단에 가까운 품질을 제공하는 가장 빠른 옵션 |
실용적인 결론은 간단합니다. 브랜드만 보고 선택하지 마세요. 작업 규모, 지연 시간 허용 범위, 세션에 필요한 자율성 수준에 따라 선택하세요.
Claude Code가 모델을 선택하는 방식
Claude Code는 별칭 또는 전체 모델 이름으로 모델을 설정할 수 있습니다. 세션 중에는 /model로 전환하고, claude --model <이름>으로 실행하거나, ANTHROPIC_MODEL을 설정할 수 있습니다.
claude --model sonnet
export ANTHROPIC_MODEL="claude-sonnet-5"
중요한 세부 사항은 ANTHROPIC_BASE_URL이 요청이 전송되는 위치를 변경할 뿐, 어떤 모델이 응답할지는 변경하지 않는다는 점입니다. Claude Code를 게이트웨이에 연결하면 해당 게이트웨이가 노출하는 모델 ID를 결정합니다.
Claude Code는 또한 제공업체별로 별칭을 해석합니다. Anthropic API에서는 opus가 Opus 5에 매핑되고 sonnet은 Sonnet 5에 매핑됩니다. 다른 제공업체에서는 동일한 별칭이 이전 버전이나 다른 모델 버전으로 해석될 수 있습니다. 재현 가능성이 필요하다면 전체 모델 이름을 고정하세요.
각 코딩 작업 부하에 가장 적합한 모델
실제 코딩 작업 부하를 위해 선택한다면 다음 기준을 사용하세요:
- Fable 5: 대규모 마이그레이션, 긴 디버깅 세션, 반복적인 자체 검증이 필요한 작업.
- Opus 5: 정확성이 속도보다 중요한 가장 어려운 에이전트 코딩 작업.
- Sonnet 5: 속도, 컨텍스트, 품질의 기본적인 일상 균형.
- Haiku 4.5: 빠른 수정, 짧은 도구 루프, 가벼운 자동화.
대부분의 팀에서 Sonnet 5가 가장 먼저 표준화할 모델입니다. 작업이 단순한 수정보다는 조사처럼 느껴지기 시작하면 Opus 5로 이동하세요. 세션이 장기전이 된다면 Fable 5가 더 나은 선택입니다. 또한 팀이 자동 모드 유지 규칙과 저렴한 작업을 다른 곳으로 라우팅하는 규칙이 필요하다면 비용에 민감한 팀을 위한 Claude Code 자동 모드 및 CLAUDE.md 설정을 참조하세요.
Novita AI가 적합한 경우
Claude Code 워크플로우를 원하지만 더 많은 백엔드 유연성이 필요하다면 Novita AI가 자연스러운 선택입니다. Novita는 Claude Code 스타일 통합을 위한 Anthropic 호환 엔드포인트를 문서화하고 있어, 동일한 터미널 워크플로우를 유지하면서 Novita의 카탈로그에 있는 모델로 라우팅할 수 있습니다.
이는 두 가지 경우에 중요합니다:
- 에이전트 루프를 다시 작성하지 않고 코딩 모델을 비교하려는 경우.
- Kimi K2와 같은 오픈 모델과 함께 Claude Code 호환 인터페이스를 사용하려는 경우.
예를 들어, Novita의 가이드는 Claude Code가 Novita 모델 ID와 함께 Anthropic 호환 기본 URL을 사용하는 방법을 보여줍니다:
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<Novita API Key>"
export ANTHROPIC_MODEL="moonshotai/kimi-k2-instruct"
이렇게 하면 모든 세션을 동일한 백엔드에 고정하지 않고도 Claude Code의 편의성을 얻을 수 있습니다.
실용적인 설정 패턴
다음 기준을 사용하세요:
| 목표 | 권장 설정 |
|---|---|
| 최대 코딩 품질 | claude --model fable |
| 팀을 위한 최적 기본값 | claude --model sonnet |
| 빠른 반복 | claude --model haiku |
| 게이트웨이 기반 실험 | ANTHROPIC_BASE_URL + 명시적 게이트웨이 모델 ID |
환경 간에 안정적인 동작이 중요하다면 별칭 대신 전체 모델 이름을 고정하세요. 비용과 백엔드 유연성이 중요하다면 프롬프트 워크플로우에 별칭을 유지하고 모델 선택은 환경 변수로 처리하세요.
서드파티 배포의 경우 현재 ANTHROPIC_DEFAULT_FABLE_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL 변수를 사용하세요. Anthropic은 이제 ANTHROPIC_SMALL_FAST_MODEL을 더 이상 사용하지 않음(deprecated)으로 처리합니다.
FAQ
코딩에 가장 적합한 Claude Code 모델은 무엇인가요?
대부분의 코딩 작업 부하에서는 Sonnet 5로 시작하세요. 더 어려운 에이전트 작업에는 Opus 5로 이동하세요.
Claude Code는 Claude 모델만 지원하나요?
기본적으로 Claude Code는 Claude 모델을 기반으로 구축되었습니다. 게이트웨이를 통해 모델 카탈로그는 연결된 제공업체에 따라 달라집니다.
Novita AI를 Claude Code와 함께 사용할 수 있나요?
네. Novita는 Claude Code가 Novita 호스팅 모델을 가리키게 하는 Anhropic 호환 경로를 문서화하고 있습니다.
실제 프로젝트에 Haiku 4.5를 사용해야 하나요?
네, 작업이 충분히 작을 때는 그렇습니다. 가장 빠른 옵션이지만, 여러 파일을 넘나드는 깊은 추론에는 가장 좋은 ì택이 아닙니다.
추천 Â티클
- Claude Code vs Cursor: 2026년 어느 AI 코딩 도구를 선택해야 할까?
- Windovs, Mac, Linux에서 Claude Code로 Kimi-K2 사용하는 방법
- Claude 코딩 에이전트란? 루프는 이렇게 작동합니다
출처: 2026년 8월 17일 확인: Anhropic Claude 모델 개요, Claude Code 모델 설정, Novita AI Claude Code 가이드.
