기준일: 2026-07-26 읽는 시간: 10분 | 난이도: 중급자 공식 기준: Model configuration

Claude Code의 모델 별칭과 기본값은 계정 유형, provider, 조직 정책, Claude Code 버전에 따라 달라집니다. 고정된 모델표를 외우기보다 /model과 공식 문서를 최종 기준으로 사용하세요.

2026-07-24 (v2.1.219): Anthropic API에서 기본 Opus가 Claude Opus 5로 갱신되었습니다. 이전 문서의 Opus 4.8 기본값 표기는 구버전입니다.

핵심 개념

모델 별칭

별칭	현재 공식 동작
default	사용자 계정 또는 조직 기본값으로 복귀
best	권한이 있으면 Fable 5, 아니면 최신 Opus
fable	긴 자율 작업과 고난도 문제용 Fable 5
sonnet	일상 코딩용 최신 Sonnet
opus	복잡한 추론용 최신 Opus
haiku	단순 작업용 빠른 모델
sonnet[1m], opus[1m]	해당 계열의 100만 토큰 컨텍스트
opusplan	Plan Mode는 Opus, 실행은 Sonnet

Anthropic API 기준(v2.1.219+): opus → Opus 5, sonnet → Sonnet 5. provider별 별칭 해석은 다를 수 있습니다.

provider	opus	sonnet
Anthropic API	Opus 5	Sonnet 5
Claude Platform on AWS	Opus 5	Sonnet 4.6
Amazon Bedrock, Google Cloud Agent Platform	Opus 5	Sonnet 4.5
Microsoft Foundry	Opus 4.6	Sonnet 4.5

최소 버전(공식): Opus 5 v2.1.219+, Sonnet 5 v2.1.197+, Opus 4.8 v2.1.154+, Fable 5 v2.1.170+. 구버전에서는 opus가 Opus 4.8 등으로 해석됩니다.

선택 기준

• 기본 권장 모델을 따르려면 default를 사용합니다.
• 일상 코딩과 비용 균형은 sonnet, 복잡한 설계와 추론은 opus를 선택합니다.
• 한 번의 세션보다 큰 장기 과제에는 권한과 정책을 확인한 뒤 fable을 검토합니다.
• 계획과 구현 모델을 자동 분리하려면 opusplan을 사용합니다.
• 운영 환경에서 재현성이 필요하면 별칭이 아니라 provider의 전체 모델 ID를 고정합니다.

default는 현재 계정 유형에 따라 다음처럼 해석됩니다. 조직 관리자가 별도 기본 모델을 설정했다면 조직 값이 먼저 적용될 수 있습니다.

계정/provider	default
Max, Team Premium, Enterprise pay-as-you-go, Anthropic API	Opus 5
Pro, Team Standard, Enterprise subscription seat	Sonnet 5
Claude Platform on AWS, Amazon Bedrock, Google Cloud Agent Platform	Opus 5
Microsoft Foundry	Sonnet 4.5

Fable 5는 어느 계정 유형에서도 기본값이 아니며 명시적으로 선택해야 합니다.

실습

현재 버전을 확인하고 업데이트합니다.

claude --version
claude update

대화형 모델 피커를 열거나 세션에서 바로 전환합니다.

/model
/model sonnet
/model opus

Claude Code v2.1.153 이상에서 대화형 /model 선택은 사용자 설정의 새 세션 기본값으로 저장됩니다. 피커에서 s를 누르면 현재 세션에만 적용됩니다. 비대화형 -p의 /model 변경은 저장되지 않습니다.

실행 시점에만 모델을 지정할 수도 있습니다.

claude --model opus
ANTHROPIC_MODEL=sonnet claude

가용성 오류에 대비한 fallback chain은 최대 세 모델까지 지정합니다. 인증, 결제, rate limit, request size, 전송 오류는 fallback을 유발하지 않습니다.

claude --fallback-model sonnet,haiku

{
  "model": "opusplan",
  "fallbackModel": ["sonnet", "haiku"]
}

Effort Level

/effort 또는 --effort로 적응형 추론 수준을 조정합니다.

모델	지원 수준
Fable 5, Opus 5, Sonnet 5, Opus 4.8, Opus 4.7	low, medium, high, xhigh, max
Opus 4.6, Sonnet 4.6	low, medium, high, max

/effort
/effort high
/effort auto

claude --effort xhigh

max는 세션 전용입니다. ultracode는 substantive task마다 동적 workflow를 계획하는 세션 전용 설정이며 Claude Code v2.1.203 이상이 필요합니다. 일반 작업에는 모델 기본 effort를 우선하고, 높은 단계는 실제 품질 향상을 측정한 뒤 사용하세요.

100만 토큰 컨텍스트

Fable 5, Opus 5, Sonnet 5, Opus 4.6 이상, Sonnet 4.6은 100만 토큰 컨텍스트를 지원합니다. Anthropic API에서 Fable 5, Opus 5, Sonnet 5, Opus 4.8, Opus 4.7은 항상 1M 컨텍스트를 사용하는 경우가 많습니다. 구독 티어의 Opus 1M 자동 업그레이드는 플랜·버전에 따라 다르므로 공식 문서와 /model 표시를 확인하세요.

/model opus[1m]
/model sonnet[1m]

현재 공식 문서 기준으로 1M 컨텍스트는 200K 초과 토큰에 별도 프리미엄을 붙이지 않습니다. 플랜에 포함되는지 usage credits가 필요한지는 모델과 구독 플랜에 따라 다릅니다. 완전히 비활성화하려면 CLAUDE_CODE_DISABLE_1M_CONTEXT=1을 설정합니다.

Sonnet 5는 Anthropic API에서 항상 1M 컨텍스트이며 별도의 [1m] 변형이 없습니다.

조직 정책과 provider 고정

availableModels는 사용자가 지정할 수 있는 모델을 제한하지만, 그 자체만으로는 모델 피커의 Default를 제한하지 않습니다. Default까지 강제하려면 공식 문서의 enforceAvailableModels 동작을 함께 검토하세요.

{
  "model": "sonnet",
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

서드파티 provider에서는 배포 전에 모델 ID를 고정합니다.

환경 변수	역할
ANTHROPIC_DEFAULT_FABLE_MODEL	fable과 자동 fallback 식별
ANTHROPIC_DEFAULT_OPUS_MODEL	opus, Plan Mode의 opusplan
ANTHROPIC_DEFAULT_SONNET_MODEL	sonnet, 실행 모드의 opusplan
ANTHROPIC_DEFAULT_HAIKU_MODEL	haiku와 background 기능
CLAUDE_CODE_SUBAGENT_MODEL	subagent와 Agent Team 모델

export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'

Amazon Bedrock, Google Cloud Agent Platform, Microsoft Foundry는 provider별 ID가 다릅니다. 공식 모델 목록과 실제 provider console에서 활성화된 ID를 확인하고 배포하세요.

도구에 입력할 프롬프트

현재 Claude Code 모델 구성을 읽기 전용으로 점검해줘.
claude --version, /model에 표시되는 별칭, 계정/provider,
availableModels와 enforceAvailableModels, fallbackModel,
ANTHROPIC_DEFAULT_* 환경 변수의 충돌 가능성을 분리해줘.
모델 ID와 기본값은 공식 Model configuration 문서를 기준으로 표시해줘.

체크리스트

• Claude Code 버전이 선택할 모델의 최소 버전을 충족한다.
• 별칭과 provider별 실제 모델 해석을 구분했다.
• /model 선택이 새 세션 기본값으로 저장되는지 확인했다.
• 1M 컨텍스트의 플랜별 가용성과 usage credits를 확인했다.
• 조직은 availableModels와 Default 강제 정책을 함께 검토했다.
• 서드파티 provider는 실제 배포 모델 ID를 고정했다.
• fallback chain이 인증·결제·rate limit 문제를 해결하지 않는다는 점을 이해했다.

다음 단계

• 빠른 모드에서 Opus 5·Opus 4.8 Fast Mode의 비용과 지원 범위를 확인합니다.
• 상태 표시줄 설정에서 현재 모델을 표시합니다.
• 비용 관리에서 토큰 사용량을 점검합니다.
• 서브에이전트 가이드에서 하위 에이전트 모델 상속을 설정합니다.