Claude Code 모델 고르기 — Opus·Sonnet·Haiku·Fable과 /model 전환

Claude Code에서 쓸 수 있는 모델은 Opus 5·Sonnet 5·Haiku 4.5·Fable 5 네 종류이며, 세션 중 /model 커맨드로 언제든 바꿀 수 있습니다. 모델마다 성능과 요금이 다르기 때문에 "무엇을 시키느냐"에 맞춰 가려 쓰면 결과 품질과 비용을 함께 잡을 수 있습니다.

핵심 요약

• Opus 5 — 고성능. 설계·대규모 리팩터링처럼 깊게 생각해야 하는 작업용
• Sonnet 5 — 속도와 품질의 균형. 일상적인 구현·버그 수정의 기본 선택
• Haiku 4.5 — 가장 빠르고 저렴. 파일 검색·간단한 확인 작업용
• Fable 5 — 최상위. 한 번에 끝나지 않는 크고 모호한 작업을 통째로 맡길 때
• /model로 세션 중 전환, settings.json·--model로 기본값 지정, /status로 현재 모델 확인

Claude Code에서 쓸 수 있는 모델은 무엇인가

Anthropic이 제공하는 네 가지 Claude 모델을 쓸 수 있습니다. 기본 원칙은 "기본 모델로 시작하고, 깊게 생각하게 하고 싶을 땐 Opus, 조사는 Haiku"입니다.

모델명과 버전은 수시로 갱신됩니다. 아래 내용은 2026년 8월 기준이며, 최신 정보는 Anthropic 공식 문서에서 확인하세요.

Opus 5 — 복잡한 추론용

Opus는 복잡한 추론과 논리적 사고에 강한 고성능 모델입니다. 아키텍처 설계나 대규모 리팩터링처럼 "깊게 생각해야" 하는 작업에서 진가를 발휘합니다.

다만 토큰 소비가 비교적 커서 구독으로 쓸 때는 한도에 빨리 닿을 수 있습니다. Max 20x라면 늘 Opus여도 무리가 없지만, Max 5x라면 일상 작업은 Sonnet으로 돌리는 쪽을 검토하는 편이 좋습니다. 토큰 소비를 줄이는 또 하나의 축은 컨텍스트 관리입니다.

Sonnet 5 — 가성비 중시

Sonnet은 속도와 품질의 균형이 좋은 모델입니다. 일상적인 코딩, 버그 수정, 기능 추가에 가장 알맞고, 상시 사용에도 부담이 적습니다. "Opus까지는 필요 없지만 Haiku로는 부족하다"는 자리에 들어가는 모델입니다.

Haiku 4.5 — 고속·저비용

Haiku는 응답이 매우 빠르고 요금이 가장 낮은 모델입니다. 파일 검색이나 간단한 확인처럼 고도의 추론이 필요 없는 작업에 알맞습니다. 서브 에이전트의 모델로 지정하면 전체 비용을 줄이는 효과도 있습니다.

Fable 5 — 최상위 모델

Fable은 Claude Code에서 쓸 수 있는 모델 중 가장 능력이 높습니다. 장시간 자율 작업을 이어가고, 착수 전에 조사부터 하며, 자기 작업을 검증하는 빈도가 높다는 특징이 있습니다. 원인 불명의 장애 조사나 아키텍처 의사결정처럼 절차를 지시하기 어려운 문제를 통째로 맡기는 장면에 맞습니다.

Fable은 어느 플랜에서도 기본으로 선택되지 않으므로 /model fable로 명시적으로 전환해야 합니다. 플랜이나 시트 종류에 따라서는 Fable 사용량이 플랜 포함 사용량이 아니라 사용 크레딧에서 차감되며, 그 경우 /model 목록의 Fable 행에 "Requires usage credits"라고 표시됩니다.

모델별 요금은 얼마나 차이 나나

API 종량제 기준 100만 토큰당 단가입니다. 구독제(Pro·Max)는 정액이지만, 모델이 비쌀수록 한도가 빨리 소진된다는 점은 같습니다.

Opus와 Sonnet의 단가 차이는 2.5배, Fable과 Sonnet은 5배입니다. 같은 작업을 시켜도 모델 선택만으로 비용이 몇 배씩 달라지므로, 비용을 줄이고 싶다면 먼저 Sonnet 전환을 검토하세요.

요금은 변경될 수 있습니다. 최신 요금은 Anthropic 공식 요금 페이지에서 확인하세요. 구독과 API 과금의 차이는 요금제 비교에서 다룹니다.

플랜에 따라 기본 모델은 무엇인가

/model 목록 맨 위의 "Default"가 가리키는 모델은 구독 플랜에 따라 다릅니다.

Fable은 어느 플랜에서도 기본이 아닙니다.

/model 커맨드로 어떻게 전환하나

선택 화면에서 고르기

인수 없이 /model을 입력하면 이용 가능한 모델 목록이 뜹니다. 화살표 키로 고르고 Enter를 누르면 그 자리에서 전환되며, 대화 맥락은 그대로 이어집니다.

> /model
────────────────────────────────────────────────────────────────────────────────
  Select model
  Switch between Claude models. Your pick becomes the default for new sessions.
  For other/previous model names, specify with --model.
  ❯ 1. Default (recommended) ✔  Opus 5 with 1M context · Best for everyday, complex tasks
    2. Opus (1M context)        Opus 5 with 1M context · Best for everyday, complex tasks
    3. Fable                    Fable 5 · Most capable for your hardest and longest-running tasks
    4. Sonnet                   Sonnet 5 · Efficient for routine tasks
    5. Haiku                    Haiku 4.5 · Fastest for quick answers

체크마크(✔)가 붙은 항목이 현재 모델입니다. 위 화면은 Max 플랜이라 Default가 Opus 5이고, Pro 플랜이라면 Sonnet 5로 표시됩니다.

이름을 직접 지정하기

목록을 거치지 않고 모델명을 바로 지정할 수도 있습니다.

/model opus
/model sonnet
/model haiku
/model fable

작업 단계에 따라 바꾸는 예

세션 도중에도 바꿀 수 있으므로, 개발 단계마다 다른 모델을 쓰는 운용이 가능합니다.

# 조사 단계: Haiku로 빠르게 코드베이스 확인
/model haiku
"이 프로젝트의 디렉터리 구성을 알려줘"

# 설계 단계: Opus로 복잡한 설계 검토
/model opus
"인증 기능의 구조를 설계해줘"

# 구현·테스트 단계: Sonnet으로 효율적으로 코드 생성
/model sonnet
"설계대로 구현하고 테스트 코드를 생성해줘"

기본 모델은 어디서 설정하나

매번 /model로 바꾸는 것이 번거롭다면 세 가지 방법으로 기본값을 정할 수 있습니다.

1. settings.json — 프로젝트의 .claude/settings.json에 적으면 그 프로젝트에만, ~/.claude/settings.json에 적으면 사용자 전체에 적용됩니다. 프로젝트 설정이 사용자 설정보다 우선합니다.
2. **--model 옵션** — 실행할 때 한 번만 지정합니다.
3. **환경 변수 ANTHROPIC_MODEL** — 셸 환경 단위로 지정합니다.

{
  "model": "sonnet"
}

# 실행 시 옵션
claude --model opus

# 환경 변수
export ANTHROPIC_MODEL=opus
claude

여러 곳에 설정이 있으면 아래 순서로 우선됩니다. 위에 있을수록 우선입니다.

1. 세션 중의 /model 커맨드
2. 실행 시의 --model 옵션
3. 환경 변수 ANTHROPIC_MODEL
4. settings.json의 model 항목

settings.json의 다른 항목은 settings.json 설정에서 다룹니다.

지금 어떤 모델을 쓰고 있는지 확인하는 법

가장 단순한 방법은 인수 없이 /model을 실행해 체크마크가 붙은 항목을 보는 것입니다. 모델 외에 버전·계정·MCP 접속 상태까지 한눈에 보고 싶다면 /status를 씁니다.

> /status
  Settings  Status   Config   Usage   Stats
  Version:          2.1.228
  Session kind:     interactive
  cwd:              /Users/you/workspace/my-app
  Login method:     Claude Max account
  Model:            Default (Opus 5 with 1M context · Best for everyday, complex tasks)
  MCP servers:      6 connected, 1 disabled · /mcp
  Setting sources:  User settings

Model: 줄에 현재 모델이 표시됩니다. 그 밖의 일상 커맨드는 기본 조작과 명령어를 참고하세요.

태스크별로 어떤 모델을 골라야 하나

어떤 모델을 써야 할지 망설여질 때의 기준입니다.

비용을 생각한 모델 운용 원칙

1. 먼저 Sonnet으로 시험합니다. 많은 작업은 Sonnet으로 충분합니다. 품질에 만족하지 못할 때만 Opus로 올리는 편이 효율적입니다.
2. Opus는 중요한 설계 판단과 리뷰에만 씁니다. 일상 구현까지 Opus로 돌리면 API 요금도, 구독 한도 소진 속도도 함께 올라갑니다.
3. 조사·검색은 Haiku에 맡깁니다. 서브 에이전트의 모델로 Haiku를 지정해 두면 본 세션의 토큰을 아낄 수 있습니다.
4. Fable은 "통째로 맡길 만한 문제"에만 씁니다. 단가가 가장 높고 크레딧 차감 대상일 수 있습니다.
5. 모델과 함께 컨텍스트도 관리합니다. /clear·/compact 사용법은 컨텍스트 윈도우 관리를 참고하세요.

정리

• Claude Code의 모델은 Opus 5(고성능)·Sonnet 5(균형)·Haiku 4.5(고속·저비용)·Fable 5(최상위) 네 종류입니다.
• /model로 세션 중 언제든 바꿀 수 있고, 대화 맥락은 유지됩니다.
• 기본 모델은 settings.json·--model·ANTHROPIC_MODEL로 정하며, /model이 가장 우선합니다.
• 기본 모델은 플랜에 따라 Opus(Max 계열) 또는 Sonnet(Pro 계열)이고, Fable은 항상 수동 전환입니다.
• Sonnet을 기본으로 두고, 설계·난이도 높은 조사는 Opus, 검색·확인은 Haiku, 통째로 맡길 큰 문제는 Fable로 가려 쓰면 품질과 비용을 함께 잡을 수 있습니다.