​
사용 가능한 모델

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

​
모델 별칭

모델 별칭은 정확한 버전 번호를 기억하지 않고도 모델 설정을 선택할 수 있는 편리한 방법을 제공합니다:
모델 별칭동작
default계정 유형에 따른 권장 모델 설정
sonnet일상적인 코딩 작업을 위해 최신 Sonnet 모델(현재 Sonnet 4.5)을 사용
opus전문적인 복잡한 추론 작업을 위해 Opus 모델(현재 Opus 4.1)을 사용
haiku간단한 작업을 위해 빠르고 효율적인 Haiku 모델을 사용
sonnet[1m]긴 세션을 위해 100만 토큰 컨텍스트 윈도우를 가진 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 사용자의 경우, Claude Code는 Opus 사용량 임계값에 도달하면 자동으로 Sonnet으로 대체됩니다.

​
opusplan 모델 설정

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

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

Console/API 사용자의 경우, [1m] 접미사를 전체 모델 이름에 추가하여 100만 토큰 컨텍스트 윈도우를 활성화할 수 있습니다. 
# [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 설정은 모델별 설정보다 우선하여, 필요할 때 모든 캐싱을 빠르게 비활성화할 수 있습니다. 모델별 설정은 특정 모델을 디버깅하거나 다른 캐싱 구현을 가질 수 있는 클라우드 제공업체와 작업할 때와 같은 선택적 제어에 유용합니다.