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는 모든 모델을 동일하게 취급하지 않습니다. 내장된 별칭은 특정 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가 더 나은 상한선입니다.
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을 더 이상 사용하지 않는 것으로 간주합니다.
FAQ
코딩에 가장 적합한 Claude Code 모델은 무엇인가요?
대부분의 코딩 워크로드에서는 Sonnet 5로 시작하십시오. 더 어려운 에이전트 작업의 경우 Opus 5로 이동하십시오.
Claude Code는 Claude 모델만 지원하나요?
기본적으로 Claude Code는 Claude 모델을 중심으로 구축되었습니다. 게이트웨이를 통해 모델 카탈로그는 연결하는 제공자에 따라 달라집니다.
Claude Code와 함께 Novita AI를 사용할 수 있나요?
네. Novita는 Claude Code가 Novita 호스팅 모델을 가리킬 수 있는 Anthropic 호환 경로를 문서화하고 있습니다.
실제 프로젝트에 Haiku 4.5를 사용해야 하나요?
네, 작업이 충분히 작을 때는 그렇습니다. 가장 빠른 옵션이지만 심층적인 다중 파일 추론에는 최선의 선택이 아닙니다.
추천 문서
- Claude Code vs Cursor: 2026년 어떤 AI 코딩 도구를 선택해야 할까?
- Windows, Mac, Linux에서 Claude Code로 Kimi-K2 사용하는 방법
- Claude 코딩 에이전트란 무엇인가? 루프 작동 방식
출처 확인일: 2026년 8월 17일 - Anthropic Claude 모델 개요, Claude Code 모델 구성, Novita AI Claude Code 가이드.
