메인 콘텐츠로 건너뛰기

Claude Code Model Configuration

오늘 업데이트함

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

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

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

  1. Claude Code 시작: claude

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

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

참고: Claude Code에서 /status를 실행하여 언제든지 현재 모델을 확인할 수 있습니다.

지원되는 모델

  • Opus 4.5, claude-opus-4-5-20251101

  • Haiku 4.5, claude-haiku-4-5-20251001

  • Sonnet 4.5, claude-sonnet-4-5-20250929 (기본값)

  • Opus 4.1, claude-opus-4-1-20250805

  • Opus 4, claude-opus-4-20250514

  • Sonnet 4, claude-sonnet-4-20250514

  • Haiku 3.5, claude-3-5-haiku-20241022

⚠️ 모델 접근: Claude Code에서 Pro 플랜을 사용할 때, 추가 사용을 활성화하고 구매한 후에만 Opus 모델을 사용할 수 있습니다.

현재 세션에만 모델 변경

Claude Code를 시작할 때 --model 플래그를 사용합니다.

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

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

    • Opus 4.5의 경우: claude --model claude-opus-4-5-20251101

    • Haiku 4.5의 경우: claude --model claude-haiku-4-5-20251001

    • Sonnet 4.5의 경우: claude --model claude-sonnet-4-5-20250929

    • 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.5 Haiku의 경우: claude --model claude-3-5-haiku-20241022

모든 향후 세션의 기본 모델 변경

단계 1) 다음을 실행하여 셸 유형을 확인합니다: echo $SHELL

  • /bin/zsh → zsh를 사용 중입니다 (macOS 기본값)

  • /bin/bash → bash를 사용 중입니다 (Linux 기본값)

단계 2) 셸 구성에 모델 설정을 추가합니다:

ZSH 사용자용 (macOS)

  • Opus 4.5: echo 'export ANTHROPIC_MODEL="claude-opus-4-5-20251101"' >> ~/.zshrc

  • Haiku 4.5: echo 'export ANTHROPIC_MODEL="claude-haiku-4-5-20251001"' >> ~/.zshrc

  • Sonnet 4.5: echo 'export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"' >> ~/.zshrc

  • 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.5 Haiku: echo 'export ANTHROPIC_MODEL="claude-3-5-haiku-20241022"' >> ~/.zshrc

BASH 사용자용 (Linux)

  • Opus 4.5: echo 'export ANTHROPIC_MODEL="claude-opus-4-5-20251101"' >> ~/.bashrc

  • Haiku 4.5: echo 'export ANTHROPIC_MODEL="claude-haiku-4-5-20251001"' >> ~/.bashrc

  • Sonnet 4.5: echo 'export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"' >> ~/.bashrc

  • 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.5 Haiku:

답변이 도움되었나요?