모델
verified · type: entity · verified: 2026-07 · review: 30d · updated: 2026-08-01 · [model]

Claude 패밀리 — 모델별 선택과 API 함정

Claude 안에서 어떤 모델을 고르고, thinking·effort·캐시 노브를 어떻게 맞출지 판단할 때 연다. 지형도 전체 비교는 models-overview, 여기선 Claude 내부만 깊게 판다.

현행 라인업 (verified 2026-07)

모델 ID 컨텍스트 최대출력 $in/$out per 1M 포지션
Claude Fable 5 claude-fable-5 1M 128K $10 / $50 최상위 능력. 장기 에이전트, thinking 항상 ON
Claude Mythos 5 claude-mythos-5 1M 128K $10 / $50 Fable 5 동급. Project Glasswing 초대 전용, self-serve 없음
Claude Opus 5 claude-opus-5 1M 128K $5 / $25 기본값. 에이전트 코딩·엔터프라이즈. 지식컷 May 2026(최신)
Claude Opus 4.8 claude-opus-4-8 1M 128K $5 / $25 이전 세대 플래그십
Claude Opus 4.7 claude-opus-4-7 1M 128K $5 / $25 여기부터 새 tokenizer (아래 함정)
Claude Opus 4.6 claude-opus-4-6 1M 128K $5 / $25 구세대, 활성
Claude Sonnet 5 claude-sonnet-5 1M 128K $3 / $15 (인트로 $2/$10, 2026-08-31 만료) 속도·지능 균형
Claude Sonnet 4.6 claude-sonnet-4-6 1M 128K $3 / $15 이전 세대 Sonnet
Claude Haiku 4.5 claude-haiku-4-5 200K 64K $1 / $5 최속·저가. 컨텍스트·출력만 작다

명시 안 하면 claude-opus-5 를 쓴다. 다운그레이드 금지. ID 에 날짜 접미사를 붙이지 마라 — 유일한 예외가 claude-haiku-4-5-20251001. 은퇴 ID(claude-3-* 계열)는 404 not_found_error.

thinking — 모델마다 기본 동작이 뒤집힌다

현행 노브는 thinking: {type: "adaptive"}. 예전 {type:"enabled", budget_tokens} 는 Opus 4.7/4.8/5·Fable 5·Sonnet 5 에서 400(Haiku 4.5 만 아직 enabled+budget_tokens 방식).

모델 thinking 생략 시 {type:"disabled"}
Opus 5 ON (adaptive) effort high 이하에서만. xhigh/max 와 조합하면 400
Opus 4.8 OFF 허용
Opus 4.7 OFF 허용
Fable 5 ON (항상) 400 — 에러가 권하는 enabled 도 거부. 필드 자체를 생략해야 adaptive
Sonnet 5 (재확인 필요) —

같은 코드에 모델만 바꿔 끼우면 사고가 난다. Opus 4.8 에서 잘 돌던 요청을 Opus 5 로 올리면 thinking 이 몰래 켜지고, Fable 5 에 disabled 를 남겨두면 400 으로 죽는다. thinking.display 기본값은 "omitted"(Fable 5/Opus 5/4.8/4.7/Sonnet 5) — 요약을 보려면 display:"summarized" 를 명시한다. 원본 chain of thought 는 절대 반환되지 않는다.

effort 5단계 — 비용·지연의 1순위 레버

output_config: {effort: "low"|"medium"|"high"|"xhigh"|"max"}. top-level 이 아니라 output_config 안에 넣는다. 기본값 high.

  • xhigh 는 Opus 4.7 부터. 코딩·에이전트 워크로드 권장.
  • Opus 5 는 low/medium 이 유난히 강하다. 비용·지연을 줄일 첫 번째 손잡이가 모델 다운그레이드가 아니라 effort 하향이다.
  • Opus 5 에서 thinking disabled 를 쓰려면 effort 가 high 이하여야 한다(위 표).

샘플링 파라미터·prefill — 넣으면 400

마이그레이션 때 가장 자주 터지는 두 지점이다.

  • temperature/top_p/top_k → Opus 4.7/4.8/5·Fable 5 에서 400. 온도 낮추던 습관은 프롬프팅(지시문)으로 대체한다.
  • assistant prefill 금지 → Fable 5/Opus 5/4.6·4.7·4.8/Sonnet 4.6 에서 400 ("conversation must end with a user message"). 출력 형태를 강제하려면 prefill 대신 output_config.format(JSON schema)을 쓴다. 상세는 structured-output.

프롬프트 캐시 최소 길이 — 단조증가가 아니다 (함정)

캐시 가능한 최소 토큰이 모델마다 다르고, 신·구/가격 순서와 무관하다 (verified 2026-07):

최소 토큰 모델
512 Opus 5, Fable 5, Mythos 5
1,024 Opus 4.8, Sonnet 5, Sonnet 4.6, Sonnet 4.5
2,048 Opus 4.7
4,096 Opus 4.6, Opus 4.5, Haiku 4.5

Opus 4.7(2048) → 4.8(1024) → 5(512) 로 갈수록 임계가 내려가다가, 가장 싼 Haiku 4.5 가 도리어 4096 으로 제일 높다. "구세대로 내렸으니 캐시도 그대로 되겠지" 하면 미달 프롬프트가 에러 없이 조용히 캐시 미적용된다. 캐시 기전 전반은 prompt-caching.

어떤 Claude 를 쓸까

상황 선택 이유
모르겠다 / 기본 Opus 5 에이전트 코딩·엔터프라이즈 기본값, 지식컷 최신
최고 난도 추론·장기 자율 에이전트 Fable 5 최상위 능력, thinking 항상 ON
속도·비용 균형 프로덕션 Sonnet 5 Opus 근접 품질에 Sonnet 가격
대량·저지연 단순 작업 Haiku 4.5 최속·최저가 (컨텍스트 200K 로 작음 주의)
Opus 5 비용 낮추기 Opus 5 + effort low/medium 모델 안 바꾸고 지연·비용 절감
재현성 위해 세대 고정 Opus 4.8 등 pinned ID 4.6 세대부터 dateless ID 도 pinned snapshot

방어적 사이버보안 워크플로우로 Glasswing 초대를 받았다면 Mythos 5. 그 외엔 접근 자체가 안 된다.

함정

  • thinking 기본 동작 반전: Opus 5 는 생략 = ON, Opus 4.8/4.7 은 생략 = OFF. 모델만 스왑하면 조용히 바뀐다.
  • Fable 5 에 disabled 금지: 필드를 아예 빼야 한다. enabled 도 거부한다.
  • Opus 5 disabled + xhigh/max = 400: disabled 는 effort high 이하 전용.
  • 캐시 최소 토큰 비단조: 위 표. 낮은 모델이 더 높을 수 있다.
  • tokenizer 교체(Opus 4.7 부터): 같은 텍스트가 4.7 이전 대비 약 30% 더 많은 토큰을 만든다(Fable 5 도 동일 tokenizer). 토큰 예산·비용 착시 주의.
  • temperature/prefill 잔재: 다른 프로바이더 코드에서 옮겨오면 두 값이 400 을 만든다.
  • 인트로 가격 만료: Sonnet 5 $2/$10 은 2026-08-31 이후 죽은 값. $3/$15 로 되돌아간다.

참고

출처: Anthropic first-party [HIGH] (platform.claude.com). 값은 부패한다 — 30일마다 재검증. 원본 → 2026-07-25-anthropic-claude-deep.