​
사용 가능한 모델

Claude Code의 model 설정에서 다음 중 하나를 구성할 수 있습니다:

​
모델 별칭

모델 별칭은 정확한 버전 번호를 기억할 필요 없이 모델 설정을 선택하는 편리한 방법을 제공합니다:
모델 별칭동작
default계정 유형에 따른 권장 모델 설정
sonnet일상적인 코딩 작업을 위해 최신 Sonnet 모델(현재 Sonnet 4)을 사용
opus복잡한 추론을 위해 가장 강력한 Opus 모델(현재 Opus 4.1)을 사용
haiku간단한 작업을 위해 빠르고 효율적인 Haiku 모델을 사용
sonnet[1m]긴 세션을 위해 100만 토큰 컨텍스트 윈도우를 가진 Sonnet을 사용
opusplan계획 모드에서는 opus를 사용하고, 실행 시에는 sonnet으로 전환하는 특별 모드

​
모델 설정하기

여러 가지 방법으로 모델을 구성할 수 있으며, 우선순위 순서로 나열하면 다음과 같습니다:
  1. 세션 중 - /model <별칭|이름>을 사용하여 세션 중간에 모델 전환
  2. 시작 시 - claude --model <별칭|이름>으로 실행
  3. 환경 변수 - ANTHROPIC_MODEL=<별칭|이름> 설정
  4. 설정 - model 필드를 사용하여 설정 파일에서 영구적으로 구성
사용 예시: 
# Opus로 시작
claude --model opus

# 세션 중 Sonnet으로 전환
/model sonnet
설정 파일 예시: 
{
    "permissions": {
        ...
    },
    "model": "opus"
}

​
특별한 모델 동작

​
default 모델 설정

default의 동작은 계정 유형에 따라 달라집니다. 특정 Max 사용자의 경우, Opus 사용량 임계값에 도달하면 Claude Code가 자동으로 Sonnet으로 대체됩니다.

​
opusplan 모델 설정

opusplan 모델 별칭은 자동화된 하이브리드 접근 방식을 제공합니다:
  • 계획 모드에서 - 복잡한 추론과 아키텍처 결정을 위해 opus를 사용
  • 실행 모드에서 - 코드 생성과 구현을 위해 자동으로 sonnet으로 전환
이는 두 가지 장점을 모두 제공합니다: 계획을 위한 Opus의 뛰어난 추론 능력과 실행을 위한 Sonnet의 효율성.

​
[1m]을 통한 확장 컨텍스트

Console/API 사용자의 경우, 전체 모델 이름에 [1m] 접미사를 추가하여 100만 토큰 컨텍스트 윈도우를 활성화할 수 있습니다. 
# [1m] 접미사가 있는 전체 모델 이름 사용 예시
/model anthropic.claude-sonnet-4-20250514-v1:0[1m]
참고: 확장 컨텍스트 모델은 다른 가격 정책을 가집니다.

​
현재 모델 확인하기

현재 사용 중인 모델을 여러 가지 방법으로 확인할 수 있습니다:
  1. 상태 표시줄에서 (구성된 경우)
  2. 계정 정보도 표시하는 /status에서

​
환경 변수

다음 환경 변수를 사용할 수 있으며, 이는 별칭이 매핑되는 모델 이름을 제어하기 위해 전체 모델 이름이어야 합니다.
환경 변수설명
ANTHROPIC_DEFAULT_OPUS_MODELopus에 사용할 모델, 또는 계획 모드가 활성화된 경우 opusplan에 사용할 모델
ANTHROPIC_DEFAULT_SONNET_MODELsonnet에 사용할 모델, 또는 계획 모드가 활성화되지 않은 경우 opusplan에 사용할 모델
ANTHROPIC_DEFAULT_HAIKU_MODELhaiku에 사용할 모델, 또는 백그라운드 기능에 사용할 모델
CLAUDE_CODE_SUBAGENT_MODEL서브에이전트에 사용할 모델
참고: ANTHROPIC_SMALL_FAST_MODEL은 ANTHROPIC_DEFAULT_HAIKU_MODEL을 위해 더 이상 사용되지 않습니다.