모델 구성

​

사용 가능한 모델

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

• 모델 별칭
• 전체 모델 이름
• Bedrock의 경우, ARN

​

모델 별칭

모델 별칭은 정확한 버전 번호를 기억하지 않고도 모델 설정을 선택할 수 있는 편리한 방법을 제공합니다:

​

모델 설정하기

우선순위 순서대로 나열된 여러 방법으로 모델을 구성할 수 있습니다:

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_SMALL_FAST_MODEL은 ANTHROPIC_DEFAULT_HAIKU_MODEL을 위해 더 이상 사용되지 않습니다.