앞 편 요금제에서 모델마다 단가가 크게 다르다는 것을 봤습니다. 이번 편은 그 모델들을 고르는 법입니다. Claude Code에서 쓸 수 있는 모델 네 계열의 성격과 요금, 플랜별 기본 모델, /model로 세션 중에 바꾸는 법, 설정이 여러 곳에 있을 때의 우선순위, 지금 어떤 모델인지 확인하는 법, 그리고 작업 종류별 선택 원칙을 다룹니다. 우리 6주차 "MCP와 모델 전략"의 문서판입니다. 다음 편은 Claude Code on the Web입니다.
핵심 요약
- 모델은 Opus(복잡한 추론), Sonnet(가성비), Haiku(고속 저비용), Fable(최상위) 네 계열이며 별칭
opus,sonnet,haiku,fable로 고릅니다. - 공식 문서 기준 Pro의 기본은 Sonnet 5, Max와 API는 Opus 5이고, Fable은 어떤 플랜에서도 기본이 아닙니다.
- 세션 중
/model sonnet처럼 바꾸면 즉시 적용되고 대화는 유지됩니다. - 우선순위는
/model>--model플래그 >ANTHROPIC_MODEL환경 변수 > 설정 파일의model입니다. - 원칙은 "모델 종속 금지, 원리 중심"입니다. 작업에 맞춰 바꾸되 지침 파일과 검증 게이트는 모델과 무관하게 유지합니다.
Claude Code에서 쓸 수 있는 모델은 무엇인가
/model을 입력하면 선택 화면이 열리고 계정에서 쓸 수 있는 모델이 나열됩니다. 별칭은 "그 계열의 현재 권장 버전"을 가리키며 시간이 지나면 새 버전으로 옮겨 갑니다. 특정 버전에 고정하려면 claude-sonnet-5처럼 전체 이름을 씁니다.
Opus: 복잡한 추론용
설계 결정, 다단계 디버깅, 큰 리팩토링처럼 깊은 추론이 필요한 작업용입니다. opus 별칭은 최신 Opus인 Opus 5로 해석됩니다(구버전 클라이언트에서는 Opus 4.8로 해석될 수 있습니다). 특정 버전에 고정하려면 전체 이름 claude-opus-5처럼 지정합니다. Opus를 plan 모드에서만 쓰고 실행은 Sonnet으로 자동 전환하는 opusplan 별칭도 있습니다.
Sonnet: 가성비 중시
대부분의 코딩 작업을 잘 처리하면서 Opus의 40% 단가입니다. sonnet 별칭은 Sonnet 5로 해석되며 Sonnet 5는 기본 100만 토큰 컨텍스트를 씁니다. Sonnet 5를 쓰려면 Claude Code v2.1.197 이상이 필요하므로 오래된 설치라면 claude update부터 합니다. 우리 과정의 기본 작업 모델입니다.
Haiku 4.5: 고속 저비용
빠르고 싸서 파일 검색, 요약, 단순 변환처럼 판단이 크게 필요 없는 작업에 맞습니다. 서브에이전트 설정에서 model: haiku로 지정해 두면 병렬 작업 비용이 크게 줄어듭니다. Enterprise 조직이 모델을 제한해도 Haiku는 항상 남겨 두도록 돼 있어 최소 하나의 모델은 늘 보장됩니다.
Fable 5: 최상위 모델
Claude 5 세대의 최상위 모델입니다. 공식 문서는 "한 번의 세션보다 큰 작업"에 적합하다고 설명합니다. 긴 자율 세션을 유지하고, 행동하기 전에 조사하며, 작은 모델보다 자주 스스로 검증합니다. 사고를 끌 수는 없고, 사고량은 모델이 단계마다 스스로 조절합니다. 어떤 플랜에서도 기본값이 아니라 /model fable로 직접 골라야 하고, v2.1.170 이상이 필요합니다. 안전 분류기가 표시하는 요청(주로 보안, 생물학 영역)은 자동으로 다른 모델로 폴백됩니다.
모델별 요금은 얼마나 차이 나나
2026년 8월 공식 API 요금표(100만 토큰당)입니다. 구독자는 이 단가로 청구되지 않지만, 한도를 소모하는 속도는 대체로 이 비율을 따릅니다.
| 모델 | 입력 | 출력 | Sonnet 5 대비 |
|---|---|---|---|
| Fable 5 | $10 | $50 | 5배 |
| Opus 5 / Opus 4.8 | $5 | $25 | 2.5배 |
| Sonnet 5 | $2 | $10 | 기준 |
| Haiku 4.5 | $1 | $5 | 0.5배 |
같은 작업을 Fable로 돌리면 Sonnet의 다섯 배, Haiku로 돌리면 절반입니다. 그래서 "무조건 좋은 모델"이 아니라 "작업에 맞는 모델"이 원칙이 됩니다.
플랜에 따라 기본 모델은 무엇인가
default는 모델 재정의를 제거하고 계정 유형별 권장 모델로 돌아가는 특수 값입니다. 공식 문서 기준 계정별 default는 다음과 같습니다.
| 계정 유형 | 기본 모델 |
|---|---|
| Pro, Team Standard | Sonnet 5 |
| Max, Team Premium, Enterprise, Anthropic API(Console) | Opus 5 |
Fable 5는 어느 계정에서도 기본이 아닙니다. best 별칭은 조직에서 Fable을 쓸 수 있으면 사용 가능한 최신 Fable, 아니면 최신 Opus를 고릅니다. Enterprise 관리자는 조직 기본 모델을 따로 지정할 수 있습니다.
/model 커맨드로 어떻게 전환하나
선택 화면에서 고르기
세션 안에서 /model만 입력하면 선택 화면이 열립니다. Enter는 모델을 바꾸고 새 세션의 기본값으로 저장하며, s는 이 세션에서만 바꿉니다. 이미 대화가 진행된 상태에서는 확인을 한 번 묻는데, 다음 응답이 캐시 없이 전체 기록을 다시 읽기 때문입니다. Option+P(Mac) 또는 Alt+P(Windows)로 입력 중인 프롬프트를 지우지 않고 바꿀 수도 있습니다.
이름을 직접 지정하기
/model sonnet
/model opus
/model fable
/model claude-sonnet-5
시작할 때 정하려면 플래그를 씁니다.
claude --model opus
/model <이름>을 직접 입력하면 Enter와 같이 기본값으로 저장됩니다. --model 플래그와 ANTHROPIC_MODEL 환경 변수는 그 세션에만 적용되므로, 터미널 두 개에서 다른 모델을 동시에 돌리고 싶으면 각각 플래그로 띄웁니다.
작업 단계에 따라 바꾸는 예
우리 6주차에서 실습하는 흐름입니다. 회의록 변환기를 손보는 하루를 예로 들면 이렇습니다.
- 아침에
claude --model sonnet으로 켜서 어제 결과물을 점검합니다. - 구조를 바꿔야 한다는 판단이 서면
Shift+Tab으로 plan 모드에 들어가고/model opus로 계획을 받습니다. - 계획을 승인하면
/model sonnet으로 돌아와 실행합니다.opusplan별칭을 쓰면 2와 3이 자동입니다. - 반복적인 파일 정리는 서브에이전트에
model: haiku로 맡깁니다. - 원인을 모르는 장애가 하루 종일 안 잡히면 그때
/model fable로 올려 "결과만 설명하고 경로는 맡기는" 지시를 줍니다.
기본 모델은 어디서 설정하나
영구 설정은 설정 파일의 model 필드입니다. 사용자 전체는 ~/.claude/settings.json, 프로젝트별은 .claude/settings.json입니다.
{
"model": "sonnet"
}
우선순위는 세션 중 /model, 시작 시 --model, 환경 변수 ANTHROPIC_MODEL, 설정 파일 model 순입니다. 프로젝트나 관리 설정이 모델을 정한 경우 시작 화면에 어느 파일이 설정했는지 표시되고, /model로 이번 세션만 바꿀 수 있으며 다음 실행 때 다시 적용됩니다. claude -c나 --resume으로 재개한 세션은 현재 설정과 무관하게 그 대화가 저장될 때 쓰던 모델을 유지합니다. 다른 터미널의 /model 선택이 재개 세션을 바꾸지 못하게 하려는 설계입니다.
노력 수준도 함께 봐 둡니다. /effort(또는 --effort)로 low, medium, high, xhigh, max 중 고르며, 사고 토큰이 출력으로 과금되므로 단순 작업은 낮추는 것이 비용에 직접 영향을 줍니다.
지금 어떤 모델을 쓰고 있는지 확인하는 법
세 군데에서 볼 수 있습니다. 세션을 시작할 때 화면 위에 버전, 현재 모델, 작업 디렉터리가 표시됩니다. 세션 중에는 /status가 버전, 모델, 계정, 연결 상태를 한 화면에 보여 줍니다. /model을 열면 현재 선택된 행이 표시되고, Anthropic API 직결 환경에서는 각 행에 가격도 함께 나옵니다. 우리 정지 규칙대로, "Sonnet으로 했을 것"이라고 추측하지 말고 /status 화면을 증거로 남깁니다.
태스크별로 어떤 모델을 골라야 하나
| 작업 | 권장 | 이유 |
|---|---|---|
| 폴더 정리, 파일 이름 바꾸기, 표 변환 | Haiku 또는 Sonnet | 판단보다 처리량 |
| 회의록 변환기, 보고서 생성기 같은 일상 개발 | Sonnet | 대부분의 코딩을 충분히 처리 |
| 프로젝트 구조 설계, 여러 파일에 걸친 리팩토링 계획 | Opus (plan 모드) | 다단계 추론 |
| 원인 불명 장애, 하루 넘게 걸리는 자율 작업 | Fable | 조사와 자체 검증이 강함 |
| 서브에이전트의 검색, 요약 | Haiku | 병렬 비용 절감 |
공식 문서의 요약도 같습니다. Sonnet이 대부분의 코딩을 잘 처리하고, Opus는 복잡한 아키텍처 결정이나 다단계 추론에 아껴 쓰라는 것입니다.
비용을 생각한 모델 운용 원칙
- 기본은 Sonnet에 두고, 올릴 이유가 생겼을 때만 올립니다. Max 계정은
default가 Opus이므로 설정 파일에"model": "sonnet"을 적어 두는 것이 우리 권장입니다. - 계획은 Opus, 실행은 Sonnet으로 나눕니다.
opusplan이 이 원칙의 자동화 버전입니다. - 서브에이전트는 Haiku를 기본으로 잡습니다.
- 모델을 바꿔도 CLAUDE.md와 검증 게이트는 그대로 둡니다. 모델이 바뀔 때마다 결과가 흔들린다면 지침이 부족한 것이지 모델 탓이 아닙니다. 이것이 "모델 종속 금지, 원리 중심"의 뜻입니다.
- 구독 한도는 모델 간에 공유되므로 한도에 닿았을 때
/model로 바꿔도 풀리지 않습니다. 이때는 재설정을 기다리거나 사용량 크레딧을 씁니다.
정리
- 네 계열은 Opus(추론), Sonnet(가성비), Haiku(속도), Fable(최상위)이며 별칭으로 고릅니다.
- Pro 기본은 Sonnet 5, Max와 API 기본은 Opus 5, Fable은 항상 직접 선택입니다.
/model은 즉시 전환하고 대화를 유지하며Enter는 저장,s는 세션 한정입니다.- 우선순위는
/model,--model,ANTHROPIC_MODEL, 설정 파일 순이고 재개 세션은 저장된 모델을 따릅니다. - 계획은 Opus, 실행은 Sonnet, 병렬은 Haiku, 막힌 문제는 Fable이 우리 운용 원칙입니다.
자주 묻는 질문
Claude Code의 기본 모델은 무엇인가요?
계정 유형에 따라 다릅니다. 공식 문서 기준 Pro와 Team Standard는 Sonnet 5, Max와 Team Premium과 Console API는 Opus 5입니다. Fable 5는 어떤 계정에서도 기본이 아니며 /model fable로 직접 골라야 합니다.
세션 도중에 모델을 바꾸면 대화 내용이 사라지나요?
아닙니다. 대화는 그대로 유지되고 다음 응답부터 새 모델이 답합니다. 다만 캐시된 컨텍스트 없이 전체 기록을 다시 읽으므로 그 한 번의 응답은 토큰을 더 씁니다. 선택 화면이 확인을 묻는 이유가 이것입니다.
모델 설정이 여러 곳에 있으면 어느 것이 우선되나요?
세션 중 /model이 가장 우선이고, 다음이 시작 시 --model 플래그, 그다음 ANTHROPIC_MODEL 환경 변수, 마지막이 설정 파일의 model입니다. 재개한 세션은 예외적으로 저장 당시의 모델을 먼저 유지합니다.
Opus와 Sonnet 중 무엇으로 시작해야 하나요?
Sonnet으로 시작합니다. 대부분의 코딩 작업을 충분히 처리하고 단가가 Opus의 40%입니다. 설계 결정이나 다단계 추론이 필요할 때 plan 모드에서만 Opus로 올리는 것이 우리 권장입니다.
Fable은 언제 쓰나요?
하루 넘게 걸리는 자율 작업, 원인을 모르는 장애의 근본 원인 조사, 아키텍처 결정처럼 조사와 자체 검증이 중요한 문제에 씁니다. 단계를 지시하기보다 원하는 결과를 설명하는 방식이 맞고, 단가는 Sonnet의 5배이므로 일상 작업에는 쓰지 않습니다.