이 가이드는 Claude Code에서 사용하는 Claude 모델을 변경하는 세 가지 방법을 보여줍니다: 즉시 변경을 위한 간단한 /model
명령어, 일회성 세션 변경을 위한 --model
플래그, 그리고 선호하는 모델을 영구 기본값으로 설정하는 환경 변수입니다.
가장 쉬운 방법: /model 명령어 사용
모델을 변경하는 가장 간단한 방법은 Claude Code 내에서 직접 /model 명령어를 사용하는 것입니다. 이 방법은 터미널을 재시작하지 않고도 즉시 작동합니다.
Claude Code 시작:
claude
./model
을 입력하고 대화형 메뉴에서 원하는 모델을 선택합니다.모델 변경이 즉시 적용됩니다.
참고: Claude Code에서 /status
를 실행하여 언제든지 현재 모델을 확인할 수 있습니다.
지원되는 모델
Opus 4.1,
claude-opus-4-1-20250805
Opus 4,
claude-opus-4-20250514
Sonnet 4,
claude-sonnet-4-20250514
Sonnet 3.7,
claude-3-7-sonnet-20250219
Haiku 3.5,
claude-3-5-haiku-20241022
⚠️ 모델 접근: Claude Code에서 Pro 플랜을 사용할 때는 Opus 모델을 사용할 수 없습니다.
현재 세션에서만 모델 변경
Claude Code를 시작할 때 --model
플래그를 사용합니다.
새로운 터미널 세션을 시작합니다.
다음 명령어를 입력합니다 (해당 세션에서 사용하고자 하는 모델에 따라):
Opus 4.1의 경우:
claude --model claude-opus-4-1-20250805
Opus 4의 경우:
claude --model claude-opus-4-20250514
Sonnet 4의 경우:
claude --model claude-sonnet-4-20250514
3.7 Sonnet의 경우:
claude --model claude-3-7-sonnet-20250219
3.5 Haiku의 경우:
claude --model claude-3-5-haiku-20241022
참고: Claude Code에 로그인한 Pro 플랜 사용자는 Opus 모델을 사용할 수 없습니다.
향후 모든 세션의 기본 모델 변경
1단계) 다음을 실행하여 셸 유형을 확인합니다: echo $SHELL
/bin/zsh
→ zsh를 사용 중입니다 (macOS 기본값)/bin/bash
→ bash를 사용 중입니다 (Linux 기본값)
2단계) 셸 설정에 모델 설정을 추가합니다:
ZSH 사용자의 경우 (macOS):
Opus 4.1:
echo 'export ANTHROPIC_MODEL="claude-opus-4-1-20250805"' >> ~/.zshrc
Opus 4:
echo 'export ANTHROPIC_MODEL="claude-opus-4-20250514"' >> ~/.zshrc
Sonnet 4:
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-20250514"' >> ~/.zshrc
3.7 Sonnet:
echo 'export ANTHROPIC_MODEL="claude-3-7-sonnet-20250219"' >> ~/.zshrc
3.5 Haiku:
echo 'export ANTHROPIC_MODEL="claude-3-5-haiku-20241022"' >> ~/.zshrc
BASH 사용자의 경우 (Linux):
Opus 4.1:
echo 'export ANTHROPIC_MODEL="claude-opus-4-1-20250805"' >> ~/.bashrc
Opus 4:
echo 'export ANTHROPIC_MODEL="claude-opus-4-20250514"' >> ~/.bashrc
Sonnet 4:
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-20250514"' >> ~/.bashrc
3.7 Sonnet:
echo 'export ANTHROPIC_MODEL="claude-3-7-sonnet-20250219"' >> ~/.bashrc
3.5 Haiku:
echo 'export ANTHROPIC_MODEL="claude-3-5-haiku-20241022"' >> ~/.bashrc
3단계) 변경사항을 적용합니다:
ZSH의 경우:
source ~/.zshrc
BASH의 경우:
source ~/.bashrc
4단계) 터미널을 완전히 닫은 다음 다시 엽니다.
5단계) 새로운 터미널 세션에서 Claude Code를 시작합니다: claude
.
이제 선택한 모델이 향후 모든 Claude Code 세션의 기본값이 됩니다.