클로드 코드 모델 설정하는 방법 (구버전 모델 선택, 모델 기본값 변경)

클로드 코드 모델 설정은 목적에 따라 방법이 다릅니다. /model 명령어로 즉시 변경하는 방법, 설정 파일로 영구 고정하는 방법, 작업별 클로드 코드 모델 추천 기준, 피커에 없는 구버전 모델 선택 방법을 정리합니다.

클로드 코드 모델 설정은 /model 명령어로 대화 도중 즉시 바꾸거나, 설정 파일에 기록해 이후 실행되는 세션까지 모델을 고정할 수 있습니다. 그리고 같은 명령어라도 피커에서 Enter를 누르는지 s를 누르는지에 따라 모델 적용 범위가 달라지며, 전자는 기본값으로 저장되고 후자는 현재 세션에서만 유지됩니다.

클로드 앱이나 웹에서 고를 수 있는 Opus 4.8 같은 구버전 모델은 /model 피커 목록에 나타나지 않습니다. 피커가 별칭과 추천 항목만 표시하기 때문이며, 클로드 코드에서 구버전 모델을 사용하려면 전체 모델 ID를 직접 입력해 선택할 수 있습니다.

목적별 방법과 적용 범위는 아래 표와 같습니다.

목적	방법	적용 범위
지금 대화에서만 모델 바꾸기	/model 실행 후 피커에서 s 키	현재 세션
선택한 모델을 기본값으로 설정	/model 실행 후 피커에서 Enter	이후 시작하는 새 세션
프로젝트 전체에 고정	설정 파일의 model 필드	해당 프로젝트
터미널마다 다른 모델 사용	claude --model 명령어 또는 ANTHROPIC_MODEL	실행한 세션
모델 선택 피커에 없는 구버전 사용	전체 모델 ID 직접 입력	입력한 방식에 따름
별칭 자체를 구버전에 고정	ANTHROPIC_DEFAULT_OPUS_MODEL	환경 변수를 적용한 셸

1. /model 명령어로 클로드 코드 모델 선택

지금 사용 중인 모델을 확인하고 대화 도중 바꾸는 가장 빠른 경로입니다. 터미널을 다시 시작하지 않고 즉시 적용됩니다.

현재 적용된 모델을 확인하려면, 클로드 코드 세션에서 /status를 입력합니다. 시작 화면 상단에도 표시되며, 프로젝트 설정이나 관리 설정이 모델을 지정한 경우 어느 설정 파일이 지정했는지 함께 나타납니다.

모델을 바꾸려면 /model을 입력합니다. 인자 없이 실행하면 선택 목록이 열리고, 목록에서 두 키의 동작이 다릅니다.

Enter : 모델을 바꾸고 사용자 설정에 기본값으로 저장
s     : 현재 세션에서만 모델을 바꿈

Enter로 저장한 값은 사용자 설정 파일의 model 필드에 기록되어 이후 새로 시작하는 세션에 그대로 적용됩니다. 대화가 이미 진행된 상태에서 모델을 바꾸면 확인 메시지가 나타납니다.

프롬프트 캐시는 모델별로 분리되어 있어 다른 모델로 넘어가는 순간 이전까지 저장돼 있던 캐시를 사용할 수 없고, 전체 대화 내용을 다시 처리하며 입력 토큰을 다시 소모합니다. 긴 대화 도중이라면 모델을 바꿀지 결정하기 전에 진행 지점과 처리 상황부터 확인합니다.

별칭을 알고 있다면 모델 목록에서 선택하지 않고 바로 입력합니다.

/model sonnet

이렇게 인자를 붙여 입력하면 Enter를 누른 것과 동일하게 기본값까지 저장됩니다. 선택할 수 있는 별칭은 아래와 같습니다.

별칭	선택되는 모델
default	모델 지정을 해제하고 계정 권장 모델로 되돌림
best	Fable 5를 사용할 수 있으면 Fable 5, 아니면 최신 Opus
fable	Claude Fable 5
opus	최신 Opus (Anthropic API 기준 Opus 5)
sonnet	최신 Sonnet (Anthropic API 기준 Sonnet 5)
haiku	Haiku
opusplan	플랜 모드에서는 opus, 실행 단계에서는 sonnet
opus[1m], sonnet[1m]	100만 토큰 컨텍스트 적용

별칭은 업데이트 이후 더 최신 모델을 가리키도록 바뀝니다. 특정 버전에 머물러야 한다면 별칭 대신 전체 모델 ID를 사용합니다.

2. 설정 파일과 환경 변수로 모델 영구 고정

세션을 새로 열 때마다 같은 모델로 시작하려면 설정에 기록합니다. 지정하는 위치가 여러 곳이라 서로 충돌할 수 있으며, 클로드 코드는 아래 순서로 우선순위를 적용합니다.

1. 세션 중 /model
2. 실행 시 claude --model 별칭
3. 환경 변수 ANTHROPIC_MODEL
4. 설정 파일의 model 필드

목록 위쪽에 있는 방법일수록 우선순위가 높으며, 상위 지정이 있으면 하위 값은 적용되지 않습니다. 다만 --model 플래그와 ANTHROPIC_MODEL 환경 변수는 그 명령으로 실행한 세션에만 적용되므로, 터미널 창마다 다른 모델을 동시에 돌리려면 각 창에서 claude --model 별칭 방식으로 실행합니다.

프로젝트 전체에 고정하려면 설정 파일에 model 필드를 수정합니다.

설정 파일은 사용자 계정 폴더 하위의 .claude/settings.json 파일입니다.

{
    "model": "opus"
}

시작할 때 한 번만 지정하려면 실행 명령에 플래그를 붙입니다.

claude --model opus

우선순위가 높은 설정이 항상 앞서 적용되기 때문에, /model로 값을 저장했는데도 재시작 후 다른 모델로 시작하는 상황이 발생할 수 있습니다.

/model 명령은 사용자 설정 파일에 값을 기록해 모델이 고정됩니다. 하지만 같은 프로젝트에 배치된 프로젝트 설정 파일이나 관리 설정 파일 같은 환경 변수가 이 model 필드를 지정하고 있으면 재시작 시 우선 순위를 가집니다. (설정 파일의 model 필드는 가장 후순위)

이 경우 /model 실행 직후 .claude/settings.json pins Opus 5 — that applies on restart 형식으로 어느 파일이 어떤 모델을 지정하고 있는지 함께 표시됩니다. 세션을 시작할 때도 상단 헤더에 설정 파일 이름이 나타나므로, 예상과 다른 모델로 시작했다면 그 안내부터 확인합니다.

회사 계정에서 특정 모델 선택 자체가 거부된다면 관리자가 availableModels 항목으로 사용 가능한 모델을 제한한 상태입니다.

3. model 목록에 없는 claude 구버전 모델 선택 및 고정

클로드 앱이나 웹에서 고를 수 있는 Opus 4.8 같은 구버전이 /model 목록에 보이지 않는 경우가 있습니다.

목록은 별칭과 현재 추천되는 항목만 표시하도록 구성되어 있어 최신 버전으로 업데이트 된 후에는 지난 버전이 모델 목록에서 빠집니다. 다만 클로드 코드는 claude-로 시작하는 이름을 모두 유효한 모델로 인식하므로, 목록에 없어도 전체 ID를 직접 입력하면 선택됩니다.

구버전 모델을 선택하려면 /model 뒤에 전체 모델 ID를 붙여 입력합니다.

/model claude-opus-4-8

이때 버전 구분자를 점으로 입력하면 실패합니다. claude-opus-4.8처럼 입력하면 “Model “claude-opus-4.8” is not a recognized model id.” 메시지가 표시되고 모델이 바뀌지 않습니다. 모델 ID는 4.8이 아니라 4-8처럼 하이픈으로 표기합니다.

/model 뒤에 붙여 직접 선택할 수 있는 주요 모델 ID는 아래와 같습니다.

계열	버전	전체 모델 ID
Fable	5	claude-fable-5
Opus	5	claude-opus-5
Opus	4.8	claude-opus-4-8
Opus	4.7	claude-opus-4-7
Opus	4.6	claude-opus-4-6
Opus	4.5	claude-opus-4-5
Sonnet	5	claude-sonnet-5
Sonnet	4.6	claude-sonnet-4-6
Sonnet	4.5	claude-sonnet-4-5
Haiku	4.5	claude-haiku-4-5

Sonnet 3.7, Sonnet 3.5, Opus 3, Haiku 3.5 등 이전 세대 모델은 이미 지원이 종료되어 입력해도 요청이 거부됩니다.

Amazon Bedrock이나 Microsoft Foundry 같은 외부 제공자를 통해 사용하는 경우에는 위 목록 대신 각 제공자의 배포 이름을 사용하며, ID 형식이 다릅니다.

매번 입력하지 않고 별칭 자체를 구버전에 묶어 두려면 시스템 환경 변수를 사용합니다.

환경 변수는 bash(~/.bashrc 또는 ~/.bash_profile), zsh(~/.zshrc 또는 ~/.zprofile)를 말하며 수정 후 source 명령어로 적용합니다.

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'

이 값을 지정하면 opus 별칭과 플랜 모드의 opusplan이 최신 Opus 대신 지정한 버전으로 연결됩니다.

Sonnet과 Haiku, Fable에는 각각 ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_FABLE_MODEL을 같은 방식으로 사용합니다. 고정한 모델에 100만 토큰 컨텍스트를 적용하려면 ID 뒤에 [1m]을 붙입니다.

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8[1m]'

환경 변수는 클로드 코드가 시작할 때 읽으므로, 실행 중인 세션에는 적용되지 않고 다시 실행해야 반영됩니다.

별칭을 구버전에 고정하면 /model opus 같은 명령이 셸마다 다른 모델을 가리킬 수 있습니다.

opus 별칭 자체는 최신 Opus를 뜻하지만, 환경 변수를 지정한 셸에서는 그 값이 우선하기 때문입니다. 팀 저장소에서는 별칭을 그대로 저장하지 말고 프로젝트 설정 파일의 model 필드에 전체 ID를 지정해, 팀 전체가 같은 버전에서 작업하도록 맞춥니다.

전체 ID를 정확히 입력했는데도 모델이 선택되지 않는다면 클로드 코드 버전을 확인합니다. 모델마다 요구 버전이 정해져 있어 그보다 낮은 버전에서는 목록에 나타나지도, 선택되지도 않습니다.

Opus 5는 v2.1.219 이상, Sonnet 5는 v2.1.197 이상, Fable 5는 v2.1.170 이상, Opus 4.8은 v2.1.154 이상을 요구합니다. 아래 명령으로 최신 버전을 설치합니다.

claude update

4. 작업 유형별 클로드 코드 모델 추천 기준

모델마다 강점이 달라 작업 성격에 맞춰 고르면 응답 속도와 사용량을 함께 관리할 수 있습니다. 작업별 클로드 코드 모델 추천은 아래와 같습니다.

작업 유형	추천 모델	선택 이유
기능 추가, 코드 리팩터링, 테스트 작성	Sonnet 5	속도와 성능의 균형이 좋아 반복 실행에 부담이 적음
여러 파일에 걸친 수정, 아키텍처 결정	Opus 5	복잡한 추론과 낯선 저장소 파악에 강함
한 번에 끝나지 않는 장기 작업, 원인 불명 장애	Fable 5	긴 자율 세션을 유지하고 스스로 검증함
단순 반복 작업, 서브에이전트 위임	Haiku	빠르고 사용량 부담이 작음
계획은 신중하게, 실행은 빠르게	opusplan	플랜 모드만 Opus로 처리하고 실행은 Sonnet

Sonnet으로 시작해 해결되지 않을 때 Opus로 올리는 순서가 사용량 측면에서 유리합니다. 작업 내용이 모호하거나 결과 검증이 어렵거나 다시 작업하는 비용이 큰 경우에만 처음부터 상위 모델을 선택합니다.

Fable 5는 기본 모델이 아니며 /model fable로 직접 선택합니다. 단계를 나열하기보다 원하는 결과를 알려주고 경로 설계를 맡기는 방식이 잘 맞으며, 스스로 검증하므로 테스트하라는 지시를 반복할 필요가 없습니다. 요금제 등급에 따라 사용 크레딧이 소모될 수 있고, 이 경우 /model 목록의 Fable 5 항목에 크레딧 필요 표시가 나타납니다.

opusplan은 별칭 하나로 두 모델을 오가도록 만들어져 있어, 플랜 모드에서는 ANTHROPIC_DEFAULT_OPUS_MODEL이 지정한 모델을, 실행 단계에서는 ANTHROPIC_DEFAULT_SONNET_MODEL이 지정한 모델을 사용합니다.

계획은 상위 모델로 세우고 실행은 빠른 모델로 넘기는 방식을 별도 명령 없이 자동화하려면 두 환경 변수를 함께 지정합니다.

서브에이전트가 여럿 실행되는 워크플로에서는 상위 세션과 서브에이전트가 각기 다른 모델로 나뉘어 사용량 예측이 어려워질 수 있습니다.

서브에이전트 정의 파일마다 model 필드가 있고 지정하지 않으면 일반 규칙을 따르지만, 전부 하나로 묶으려면 CLAUDE_CODE_SUBAGENT_MODEL 환경 변수에 별칭이나 전체 ID를 지정합니다. 이 값이 개별 지정보다 우선 적용되므로, 통제된 환경에서는 예측 가능성이 높아집니다.

마치며

클로드 코드는 모델을 지정하는 위치를 여러 곳에 두고 우선순위로 정리하기 때문에, 원하는 대로 모델이 적용되지 않을 때는 어느 계층에서 값이 덮어써졌는지부터 확인합니다.

세션을 재개하는 경우에도 현재 설정보다 저장 시점의 모델이 우선하므로, 예상과 다른 모델로 시작했다면 재개된 세션인지 새 세션인지 구분합니다.

팀 단위로 모델을 통일해야 한다면 각자 /model로 선택하는 대신 프로젝트 설정 파일에 model 필드를 기록해 공유하는 방식이 실수를 줄일 수 있습니다.

FAQ