메인 콘텐츠로 건너뛰기

​
사용 가능한 모델

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

​
모델 별칭

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

​
모델 설정

우선순위 순서대로 여러 방법으로 모델을 구성할 수 있습니다:
  1. 세션 중 - /model <alias|name>을 사용하여 세션 중에 모델 전환
  2. 시작 시 - claude --model <alias|name>으로 실행
  3. 환경 변수 - ANTHROPIC_MODEL=<alias|name> 설정
  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] 접미사를 추가하여 1백만 토큰 컨텍스트 윈도우를 활성화할 수 있습니다. 
# [1m] 접미사를 사용한 전체 모델 이름 사용 예시
/model anthropic.claude-sonnet-4-5-20250929-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을 위해 더 이상 사용되지 않습니다.

​
프롬프트 캐싱 구성

Claude Code는 성능을 최적화하고 비용을 절감하기 위해 프롬프트 캐싱을 자동으로 사용합니다. 전역적으로 또는 특정 모델 계층에 대해 프롬프트 캐싱을 비활성화할 수 있습니다:
환경 변수설명
DISABLE_PROMPT_CACHING모든 모델에 대해 프롬프트 캐싱을 비활성화하려면 1로 설정 (모델별 설정보다 우선)
DISABLE_PROMPT_CACHING_HAIKUHaiku 모델에만 프롬프트 캐싱을 비활성화하려면 1로 설정
DISABLE_PROMPT_CACHING_SONNETSonnet 모델에만 프롬프트 캐싱을 비활성화하려면 1로 설정
DISABLE_PROMPT_CACHING_OPUSOpus 모델에만 프롬프트 캐싱을 비활성화하려면 1로 설정
이러한 환경 변수는 프롬프트 캐싱 동작에 대한 세밀한 제어를 제공합니다. 전역 DISABLE_PROMPT_CACHING 설정은 모델별 설정보다 우선하므로 필요할 때 모든 캐싱을 빠르게 비활성화할 수 있습니다. 모델별 설정은 특정 모델 디버깅 또는 다양한 캐싱 구현을 가질 수 있는 클라우드 제공자와 작업할 때와 같이 선택적 제어에 유용합니다.