메인 콘텐츠로 건너뛰기

Claude 코드 모델 구성

이번 주에 업데이트함

이 가이드는 Claude Code에서 사용하는 Claude 모델을 변경하는 세 가지 방법을 보여줍니다: 즉시 변경을 위한 간단한 /model 명령어, 일회성 세션 변경을 위한 --model 플래그, 그리고 선호하는 모델을 영구 기본값으로 설정하는 환경 변수입니다.

가장 쉬운 방법: /model 명령어 사용

모델을 변경하는 가장 간단한 방법은 Claude Code 내에서 직접 /model 명령어를 사용하는 것입니다. 이 방법은 터미널을 재시작하지 않고도 즉시 작동합니다.

  1. Claude Code 시작: claude.

  2. /model을 입력하고 대화형 메뉴에서 원하는 모델을 선택합니다.

  3. 모델 변경이 즉시 적용됩니다.

참고: 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 플래그를 사용합니다.

  1. 새로운 터미널 세션을 시작합니다.

  2. 다음 명령어를 입력합니다 (해당 세션에서 사용하고자 하는 모델에 따라):

    1. Opus 4.1의 경우: claude --model claude-opus-4-1-20250805

    2. Opus 4의 경우: claude --model claude-opus-4-20250514

    3. Sonnet 4의 경우: claude --model claude-sonnet-4-20250514

    4. 3.7 Sonnet의 경우: claude --model claude-3-7-sonnet-20250219

    5. 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 세션의 기본값이 됩니다.

답변이 도움되었나요?