Cmd. /model

Claude 모델을 전환해 새 세션 기본값으로 저장하고, picker에서 effort를 조정하거나 s로 현재 세션에만 적용하는 명령. provider별 alias 해석과 Fable 5.1·Opus 5 운영 기준을 함께 정리한다

핵심 요약

모델 선택 및 기본값 저장
입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.

역할

모델 선택 및 기본값 저장

/model [model]

사용 조건

항목	기준
입력 위치	실행 중인 CLI의 입력창
종류	내장 명령
상태	현재 공식 표
별칭	—
공식 최소 버전	명시되지 않음
검증 기준	2026-09-22 · Claude Code 2.1.278

인자 없는 호출은 picker를 엽니다. v2.1.205+의 -p에서는 모델 인자가 필요하고 현재 세션에만 적용됩니다.

사용 예

/model

/model sonnet

/model fable

/model opus

/model <name>을 직접 실행하거나 picker에서 모델을 고르면 사용자 settings의 model 기본값으로 저장되어 새 세션에도 적용됩니다. 현재 세션에만 적용하려면 picker 행에서 s를 누릅니다. effort도 함께 조정하려면 picker에서 좌/우 화살표를 씁니다(모델이 지원하는 경우).

선택 시점

긴 설계 논의 전 분석형 모델로 전환
단순 수정 반복 구간에서 속도형 모델로 전환
리뷰 단계와 구현 단계를 모델 정책으로 분리

명령어	차이점	언제 선택
`/model`	모델 전환 + 기본값 저장	응답 품질/속도 균형 조정
`/effort`	같은 모델의 추론 강도만 조정	모델은 유지하고 사고량만 올리거나 내림
`/config`(`/settings`)	테마·모델·output style 등 설정 UI	GUI에서 모델·기본값을 함께 점검
`/status`	현재 설정 확인 중심	버전·모델·계정·연결 상태 점검

실행 결과와 유지 범위

선택한 모델을 새 세션 기본값으로 저장합니다. picker 행에서 s를 누르거나 지원되는 -p 호출을 사용하면 현재 세션에만 적용합니다.

공식 문서는 /model을 "AI 모델을 전환하고 이를 새 세션의 기본값으로 저장한다(Switch the AI model and save it as your default for new sessions)"로 설명합니다. 인자 없이 실행하면 picker가 열리고, 모델이 지원하는 경우 좌/우 화살표로 effort level을 조정합니다. picker 행에서 s를 누르면 현재 세션에만 적용됩니다. 대화에 이전 출력이 쌓여 있으면 picker가 확인을 요청하는데, 다음 응답이 캐시 없이 전체 히스토리를 다시 읽기 때문입니다. 확인하면 현재 응답이 끝나길 기다리지 않고 바로 적용됩니다.

Fable 계열이 추가된 뒤로는 모델 이름 자체보다 alias가 provider마다 무엇으로 해석되는지를 확인하는 쓰임새가 실무에서 더 중요해졌습니다. 2026-09-01 Fable 5.1이 출시되면서 fable alias가 가리키는 대상도 한 번 더 움직였으니, 아래 표로 현재 해석을 확인하세요.

모델 표시

Anthropic API 세션의 /model에는 Fable이 항상 표시되며 조직 설정이 비활성화했을 때만 회색으로 표시됩니다. 표시 여부와 실제 사용 권한·요금은 별도로 확인하세요.

Changelog

Fable 5.1 운영 기준

Fable 5.1(claude-fable-5-1)은 2026-09-01 출시된 Fable 5의 후속 모델입니다. Claude Code v2.1.257 Changelog는 "Claude Fable 5.1을 추가하고 기본 Fable 모델로 지정"했다고 적고, 공식 Model configuration은 Claude Code v2.1.255 이상을 요구 버전으로 명시합니다. fable[1m] 표기도 v2.1.255 이상에서 동작합니다.
가장 어려운 코딩 작업, 수 시간짜리 자율 조사, 모호한 장애 원인 분석, 고위험 아키텍처 판단에 배정합니다. 공식 문서는 대부분의 워크로드는 Opus 5로 시작하고, Opus 5의 높은 effort로도 평가가 부족할 때 Fable 5.1로 올리라고 권합니다.
Fable 5.1과 Fable 5 모두 어떤 플랜·provider에서도 기본 모델이 아닙니다. /model fable, claude --model fable, model 설정, ANTHROPIC_DEFAULT_FABLE_MODEL, 또는 접근 권한이 있는 조직의 best alias로 선택합니다. best는 Fable 접근 권한이 있으면 최신 Fable, 없으면 최신 Opus로 해석됩니다.
/advisor fable로 보조 모델 의견을 Fable에 맡길 수 있습니다. v2.1.260부터 headless(-p·Agent SDK)와 desktop·Remote Control에서도 /advisor <model>·/advisor off 텍스트 형태를 지원합니다.
사양은 Fable 5와 같습니다. 기본이자 최대인 1M context, 최대 128K output token, $10/MTok input·$ 50/MTok output. **prompt cache read만 $0.25/MTok(기본 입력 단가의 2.5%)로 Fable 5의 1/4**이며, 5분 cache write$ 12.50·1시간 cache write $20, Batch API는 입력·출력 50% 할인입니다. Anthropic은 일반 워크로드에서 약 25%, agentic 작업에서 최대 약 45%의 비용 절감을 안내합니다.
Covered Model로 30일 데이터 보존이 적용되며, Anthropic이 명시적으로 승인하지 않는 한 ZDR(Zero Data Retention) 환경에서는 제공되지 않습니다. 지식 기준일은 2026년 6월이고, 은퇴는 2027-09-01 이전에는 없습니다.
adaptive thinking이 항상 켜져 있으므로 MAX_THINKING_TOKENS=0, 세션 thinking toggle, alwaysThinkingEnabled로 thinking을 끌 수 없습니다. 깊이는 /effort로 조절하며, v2.1.260부터 Fable 5.1에서는 세션 중 effort를 바꿔도 prompt cache가 무효화되지 않습니다.
자동 모델 fallback: 요청이 안전 분류기에 걸리면 Claude Code가 다른 모델로 자동 재실행하고 알림을 띄웁니다. 공식 표는 Fable 5.1·5의 생물학 플래그 → Opus 5, 사이버보안 플래그 → Opus 4.8, Opus 5의 사이버보안 플래그 → Opus 4.8, Opus 5의 생물학 플래그 → 거절(fallback 없음)입니다. switchModelsOnFlag: false로 끌 수 있고, third-party provider에서는 ANTHROPIC_DEFAULT_OPUS_MODEL을 지정해야 fallback이 동작합니다. repo 컨텍스트가 원인인지 확인하려면 claude --safe-mode로 설정·MCP·플러그인·스킬·훅을 끄고 재현합니다. git status와 디렉토리명은 safe mode에서도 포함됩니다.
Fable 5.1 특유의 행동 변화: Fable 5보다 병렬 tool call을 덜 묶고, 긴 tool 루프에서 진행 메시지를 덜 쓰며, low effort에서는 검색 대신 기억으로 답하는 경우가 늘고, 작은 수정에도 파일 전체를 다시 쓰는 경향이 있습니다. Claude Code 자체는 이를 하네스에서 처리하지만, 커스텀 에이전트·스킬 프롬프트를 5.1로 옮길 때는 공식 "Prompting Claude Fable 5.1" 문서의 배치 지시·진행 보고 지시를 추가하세요.
Fable 5 위치: 공식 models overview는 Fable 5(claude-fable-5)를 "legacy, still available"로 분류합니다. 은퇴 공지는 없으므로 회귀 비교나 gateway 호환 용도로 계속 pinning할 수 있지만, 신규 운영 기준은 Fable 5.1로 옮기세요.
Mythos 5.1과의 구분: Mythos 5.1(claude-mythos-5-1)은 Fable 5.1과 동일 사양·단가이며 Project Glasswing 승인 고객에게만 제공됩니다. Anthropic 발표는 두 모델을 "안전장치 수준이 다른 같은 모델"로 설명하고, Cyber Verification Program·Life Sciences Verification Program을 통과한 미국 조직으로 접근을 제한합니다. 접근은 Anthropic·AWS·Google Cloud 계정 팀에 문의하며, 일반 Claude Code /model로는 선택할 수 없습니다.
재배포 이력(2026-07): Fable 5는 2026-06-09 GA로 출시됐고, 2026-06-12 미국 수출통제로 Mythos 5와 함께 전 사용자 접근이 약 19일간 중단됐다가 2026-07-01 전역 복원됐습니다. 재배포 시 취약점 탐지 행위를 겨냥한 개선된 안전 분류기가 적용됐고, Fable 5.1은 같은 stop_details 카테고리를 커버하는 분류기를 갖습니다. Anthropic은 5.1 출시와 함께 생물학 분류기의 무해 질의 오탐을 85% 줄였다고 발표했습니다.

Fable 5.1과 Fable 5의 Messages API 차이

Claude Code 사용자에게는 대부분 투명하지만, 같은 팀이 Messages API로 커스텀 하네스를 운영한다면 claude-fable-5를 claude-fable-5-1로 바꿀 때 아래 세 가지 breaking change를 먼저 점검하세요.

구분	Fable 5	Fable 5.1	대응
강제 tool 호출	`tool_choice` `any`·`tool` 허용	`any`·`tool`은 400 `invalid_request_error` (`count_tokens`·Batch 포함)	`auto` + 프롬프트에서 도구 지정, `strict: true`, 또는 structured outputs
thinking block 귀속	모델 간 재사용	5.1이 만든 thinking block은 이전 모델이 읽지 못하고 무과금으로 drop됨. 5.1은 Opus 5·Fable 5·이전 모델 block을 읽음	fallback·라우터로 모델이 바뀌는 경로에서 추론 손실을 감안. `thinking-binding-controls-2026-08-01` beta로 drop을 `input_transformations`에 보고
이전 턴 편집	허용	`system`·`tools`·이전 메시지를 바꾸면 이후 thinking block이 무효화. 2026-08-31 이후 생성 계정은 400 강제, 이전 계정은 `thinking.block_binding.prefix_mismatch_behavior`로 opt-in	대화를 append-only로 유지. 지시 변경은 mid-conversation system message, 컨텍스트 축소는 서버 측 compaction·context editing 사용

추가된 기능은 모두 additive입니다. per-message effort(mid-conversation-output-config-2026-07-01 beta, Opus 5도 지원), 한 턴만 유효한 system message clear_at: "next_user_message"(mid-conversation-system-clear-at-2026-08-21 beta), tool 호출 사이 진행 메시지를 텍스트로 받는 thinking.display: "updates"(thinking-display-updates-2026-08-18 beta), 그리고 텍스트 워터마크·C2PA 기반 content provenance입니다. Mythos 5.1은 이전 턴 편집 검사를 실행하지 않습니다. 코드베이스 마이그레이션은 Claude Code에서 /claude-api migrate this project to claude-fable-5-1로 시작할 수 있습니다.

Fable 구독 및 usage credits

2026-07-07까지 적용된 한시적 포함량은 종료됐습니다. 2026-07-19 기준 구독 플랜과 API를 같은 사용량 풀로 오해하지 않도록 다음처럼 구분합니다. Fable 5.1 출시 공지는 Claude Code· Claude.ai·Enterprise에서 사용 가능하다고만 밝히고 구독 포함량을 별도로 바꾸지 않았으므로, 아래 Fable 5 기준을 Fable 계열 공통 기준으로 두고 플랜별 공지가 나오면 재검증하세요.

경로	현재 사용 기준	운영 메모
Pro·Max·Team	usage credits 필요	credits가 꺼져 있거나 잔액이 없으면 Fable 5에 접근할 수 없음
Standard Enterprise seat	usage credits 필요	한시적 포함량 대상이 아니었음
Premium/select Enterprise seat	usage credits 필요	2026-07-07까지만 좌석 사용량의 최대 50%에 포함
Claude API·소비 기반 Enterprise	토큰 기반 API 과금	좌석별 주간 포함량과 별도이며 Fable 5 표준 단가 적용

usage credits는 구독료와 별도로 표준 API 단가로 청구됩니다. 개인 플랜은 Claude 웹의 Settings > Usage에서 결제 수단·선불 잔액·월 한도·자동 충전을 설정하고, Claude Code에서는 /usage-credits로 현재 설정 흐름을 엽니다. 팀 운영자는 조직 정책과 월 한도를 먼저 정하고 Fable을 기본 워크플로우로 허용하세요.

Messages API 거절·폴백 처리

Fable 5.1·Fable 5의 안전 분류기가 요청을 거절해도 Messages API는 오류가 아니라 HTTP 200 성공 응답을 반환합니다. 따라서 4xx/5xx만 감시하면 거절과 폴백 누락을 놓칩니다. content나 stop_details 유무가 아니라 stop_reason을 기준으로 분기하세요. 거절 처리·fallback·fallback credit·stop_details 카테고리는 Fable 5.1에서도 그대로 유지됩니다.

{
  "model": "claude-fable-5-1",
  "content": [],
  "stop_reason": "refusal",
  "stop_details": {
    "type": "refusal",
    "category": "cyber",
    "explanation": "..."
  }
}

stop_details.category는 cyber, bio처럼 분류 영역을 알려주지만 null일 수 있습니다. explanation 문구도 고정 계약이 아니므로 화면에는 표시하되 로직에서 파싱하지 않습니다.

폴백 방식	적용 범위	구현 기준
서버 측 폴백	Claude API·Claude Platform on AWS 베타	`fallbacks`에 최대 3개 모델을 지정하고 `server-side-fallback-2026-06-01` beta header 사용. 또는 `server-side-fallback-2026-07-01` beta의 `fallbacks: "default"`로 거절 카테고리별 권장 모델에 자동 재시도. Fable 5.1의 허용 fallback 대상은 Opus 4.8과 Opus 5
SDK middleware	모든 지원 플랫폼	refusal-fallback middleware와 대화별 상태를 재사용해 수락한 모델에 후속 턴을 고정
수동 재시도	모든 플랫폼·언어	거절을 직접 감지해 다른 모델로 재요청하고 `fallback-credit-2026-06-01` 흐름으로 캐시 비용 환급

서버 측 fallbacks와 SDK middleware는 같은 요청에 함께 설정하지 않습니다.
Message Batches에서 거절 항목은 result.type: "succeeded"로 반환될 수 있으므로 stop_reason을 확인합니다. 서버 측 fallbacks는 batch에서 지원되지 않습니다.
Claude Code의 fallbackModel/--fallback-model은 모델 가용성 실패에 대비한 체인입니다. Fable 안전 분류기 거절을 처리하는 Messages API fallbacks와 같은 설정이 아닙니다.
출력 생성 전 거절된 요청에는 요금이 부과되지 않습니다. 서버 측 폴백과 SDK middleware는 fallback credit을 자동 적용하고, 수동 재시도는 거절 응답의 credit token을 재전송해야 모델 전환에 따른 prompt-cache write 비용을 이중 부담하지 않습니다.
refusal 수와 usage.iterations의 fallback_message 수를 별도 지표로 기록합니다. 둘의 차이가 커지면 폴백 설정이 누락된 요청 경로가 있는지 확인합니다.

Fable 계열에게 내부 추론을 그대로 복사·전사·설명하라고 요구하는 prompt, skill, harness 지시는 reasoning_extraction 거절과 Opus 폴백을 늘릴 수 있습니다. 내부 chain-of-thought 대신 결론의 근거 요약, 검증 결과, 사용자에게 필요한 진행 상황을 요청하고, API에서 reasoning 가시성이 필요하면 adaptive thinking의 구조화된 thinking block을 사용합니다.

Opus 5 운영 기준

Opus 5는 v2.1.219부터 Anthropic API와 주요 provider의 최신 고성능 Opus 경로입니다. 복잡한 multi-step 작업, 큰 설계 판단, 장기 agentic task에 배정합니다.
native 1M context를 지원하고, Claude Code에서는 claude-opus-5 또는 opus로 선택합니다.
fast mode는 Opus 5와 Opus 4.8에서 지원되며, Opus 5 fast 단가는 입력 $10·출력$ 50/MTok입니다.
Microsoft Foundry에서는 opus가 아직 Opus 4.6이므로 provider를 넘나드는 재현 작업은 alias 대신 full model name을 고정하세요.
일반 구현/문서/테스트 반복은 sonnet, 단순 보조 작업은 haiku를 기본으로 두면 비용 관리에 유리합니다.

Sonnet 5 운영 기준

Sonnet 5는 Claude Code v2.1.197부터 Claude Code의 기본 Sonnet 경로입니다.
Anthropic API에서 sonnet alias와 Pro·Team Standard·Enterprise subscription seat의 default가 Sonnet 5로 해석됩니다.
Sonnet 5는 1M 컨텍스트를 기본으로 지원하므로 일반 Anthropic API에서는 sonnet[1m] 접미사가 별도 효과를 내지 않습니다. LLM gateway 뒤에서 1M 지원을 명시해야 할 때만 이 접미사를 씁니다.
지원 effort는 low/medium/high/xhigh/max이고 기본값은 high입니다.

주의사항

모델 전환 후 응답 성향이 바뀌므로 출력 포맷을 다시 고정
고난도 작업은 전환 직후 작은 샘플로 품질 확인
/model 선택이 기본값으로 저장되는 동작을 팀원에게 명확히 안내. 현재 세션만 바꿀 때는 picker의 s 사용
대화에 이전 출력이 있으면 모델 전환 시 picker가 확인을 요청함. 다음 응답이 캐시 없이 전체 히스토리를 다시 읽기 때문이며, 토큰 비용·지연이 늘 수 있음
claude --resume, --continue, /resume은 transcript에 저장된 모델을 우선 유지
gateway나 third-party provider에서는 /model에 보이는 alias가 최신 Anthropic API alias와 다를 수 있음
Opus 5를 쓰려면 Claude Code v2.1.219 이상인지 /status 또는 claude --version으로 확인
Sonnet 5를 쓰려면 Claude Code v2.1.197 이상인지 /status 또는 claude --version으로 확인
Fable 5.1을 쓰려면 Claude Code v2.1.255 이상, Fable 5는 v2.1.170 이상인지 /status 또는 claude --version으로 확인. v2.1.257~259에서는 조직에 권한이 있어도 picker에 Fable 5.1이 안 보이고 /model claude-fable-5-1로만 선택되는 버그가 있었으며 v2.1.260에서 수정됨
v2.1.260 이전 빌드에서는 Fable 5.1의 tool result 뒤 컨텍스트가 prompt cache에 포함되지 않아 매 tool 턴마다 비캐시 입력으로 재전송됐음. Fable 5.1 비용이 예상보다 높게 나오면 먼저 버전을 확인
model: fable 서브에이전트가 ANTHROPIC_DEFAULT_FABLE_MODEL의 [1m] 태그를 무시하고 200K로 돌던 문제는 v2.1.260에서 수정됨
v2.1.261부터 /model picker와 VS Code 모델 pill은 Claude Code가 인식하는 Bedrock·Vertex AI·LLM gateway ID를 raw ID 대신 모델 이름으로 표시함. 재현 문서에는 여전히 full ID를 적을 것
v2.1.184+ model restriction과 v2.1.187+ deprecated model warning 때문에 오래된 full model ID는 팀 설정에서 정리
availability failure 대비가 필요한 장기 세션은 settings의 fallbackModel 또는 claude --fallback-model opus,sonnet으로 fallback chain을 지정
Fable에 대해서만 prompt caching을 끄려면 DISABLE_PROMPT_CACHING_FABLE=1을 사용
v2.1.73에서 Bedrock, Vertex, Microsoft Foundry의 기본 Opus 모델이 Opus 4.6으로 변경됨
v2.1.68에서 Opus 4.6이 Max/Team 구독자에게 medium effort 기본값으로 적용
Opus 4, 4.1이 first-party API에서 제거되어 Opus 4.6으로 자동 마이그레이션됨 (v2.1.68)
v2.1.77에서 Opus 4.6의 기본 최대 출력 토큰이 64k로 증가 (상한 128k)
v2.1.117부터 /model 선택은 재시작 후에도 유지되며, project/managed settings pin이 활성 모델을 바꾸면 startup header에 출처가 표시됩니다. v2.1.153 이후로는 user settings 기본값 저장 방식이 더 명확해졌습니다.
v2.1.201에서 Sonnet 5 세션은 mid-conversation system role을 더 이상 사용하지 않습니다. Sonnet 5 기반 세션의 운영자 지시 주입 동작이 바뀌었으니 관련 훅/스크립트를 재검증하세요. (참고: v2.1.198부터 서브에이전트가 기본 백그라운드 실행, v2.1.200부터 기본 permission mode가 Manual)

공식 근거

전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록

핵심 요약

모델 선택 및 기본값 저장
입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.

역할

모델 선택 및 기본값 저장

/model [model]

사용 조건

항목	기준
입력 위치	실행 중인 CLI의 입력창
종류	내장 명령
상태	현재 공식 표
별칭	—
공식 최소 버전	명시되지 않음
검증 기준	2026-09-22 · Claude Code 2.1.278

인자 없는 호출은 picker를 엽니다. v2.1.205+의 -p에서는 모델 인자가 필요하고 현재 세션에만 적용됩니다.

사용 예

/model

/model sonnet

/model fable

/model opus

선택 시점

긴 설계 논의 전 분석형 모델로 전환
단순 수정 반복 구간에서 속도형 모델로 전환
리뷰 단계와 구현 단계를 모델 정책으로 분리

명령어	차이점	언제 선택
`/model`	모델 전환 + 기본값 저장	응답 품질/속도 균형 조정
`/effort`	같은 모델의 추론 강도만 조정	모델은 유지하고 사고량만 올리거나 내림
`/config`(`/settings`)	테마·모델·output style 등 설정 UI	GUI에서 모델·기본값을 함께 점검
`/status`	현재 설정 확인 중심	버전·모델·계정·연결 상태 점검

Fable 5.1(claude-fable-5-1)은 2026-09-01 출시된 Fable 5의 후속 모델입니다. Claude Code v2.1.257 Changelog는 "Claude Fable 5.1을 추가하고 기본 Fable 모델로 지정"했다고 적고, 공식 Model configuration은 Claude Code v2.1.255 이상을 요구 버전으로 명시합니다. fable[1m] 표기도 v2.1.255 이상에서 동작합니다.
가장 어려운 코딩 작업, 수 시간짜리 자율 조사, 모호한 장애 원인 분석, 고위험 아키텍처 판단에 배정합니다. 공식 문서는 대부분의 워크로드는 Opus 5로 시작하고, Opus 5의 높은 effort로도 평가가 부족할 때 Fable 5.1로 올리라고 권합니다.
Fable 5.1과 Fable 5 모두 어떤 플랜·provider에서도 기본 모델이 아닙니다. /model fable, claude --model fable, model 설정, ANTHROPIC_DEFAULT_FABLE_MODEL, 또는 접근 권한이 있는 조직의 best alias로 선택합니다. best는 Fable 접근 권한이 있으면 최신 Fable, 없으면 최신 Opus로 해석됩니다.
/advisor fable로 보조 모델 의견을 Fable에 맡길 수 있습니다. v2.1.260부터 headless(-p·Agent SDK)와 desktop·Remote Control에서도 /advisor <model>·/advisor off 텍스트 형태를 지원합니다.
사양은 Fable 5와 같습니다. 기본이자 최대인 1M context, 최대 128K output token, $10/MTok input·$ 50/MTok output. **prompt cache read만 $0.25/MTok(기본 입력 단가의 2.5%)로 Fable 5의 1/4**이며, 5분 cache write$ 12.50·1시간 cache write $20, Batch API는 입력·출력 50% 할인입니다. Anthropic은 일반 워크로드에서 약 25%, agentic 작업에서 최대 약 45%의 비용 절감을 안내합니다.
Covered Model로 30일 데이터 보존이 적용되며, Anthropic이 명시적으로 승인하지 않는 한 ZDR(Zero Data Retention) 환경에서는 제공되지 않습니다. 지식 기준일은 2026년 6월이고, 은퇴는 2027-09-01 이전에는 없습니다.
adaptive thinking이 항상 켜져 있으므로 MAX_THINKING_TOKENS=0, 세션 thinking toggle, alwaysThinkingEnabled로 thinking을 끌 수 없습니다. 깊이는 /effort로 조절하며, v2.1.260부터 Fable 5.1에서는 세션 중 effort를 바꿔도 prompt cache가 무효화되지 않습니다.
자동 모델 fallback: 요청이 안전 분류기에 걸리면 Claude Code가 다른 모델로 자동 재실행하고 알림을 띄웁니다. 공식 표는 Fable 5.1·5의 생물학 플래그 → Opus 5, 사이버보안 플래그 → Opus 4.8, Opus 5의 사이버보안 플래그 → Opus 4.8, Opus 5의 생물학 플래그 → 거절(fallback 없음)입니다. switchModelsOnFlag: false로 끌 수 있고, third-party provider에서는 ANTHROPIC_DEFAULT_OPUS_MODEL을 지정해야 fallback이 동작합니다. repo 컨텍스트가 원인인지 확인하려면 claude --safe-mode로 설정·MCP·플러그인·스킬·훅을 끄고 재현합니다. git status와 디렉토리명은 safe mode에서도 포함됩니다.
Fable 5.1 특유의 행동 변화: Fable 5보다 병렬 tool call을 덜 묶고, 긴 tool 루프에서 진행 메시지를 덜 쓰며, low effort에서는 검색 대신 기억으로 답하는 경우가 늘고, 작은 수정에도 파일 전체를 다시 쓰는 경향이 있습니다. Claude Code 자체는 이를 하네스에서 처리하지만, 커스텀 에이전트·스킬 프롬프트를 5.1로 옮길 때는 공식 "Prompting Claude Fable 5.1" 문서의 배치 지시·진행 보고 지시를 추가하세요.
Fable 5 위치: 공식 models overview는 Fable 5(claude-fable-5)를 "legacy, still available"로 분류합니다. 은퇴 공지는 없으므로 회귀 비교나 gateway 호환 용도로 계속 pinning할 수 있지만, 신규 운영 기준은 Fable 5.1로 옮기세요.
Mythos 5.1과의 구분: Mythos 5.1(claude-mythos-5-1)은 Fable 5.1과 동일 사양·단가이며 Project Glasswing 승인 고객에게만 제공됩니다. Anthropic 발표는 두 모델을 "안전장치 수준이 다른 같은 모델"로 설명하고, Cyber Verification Program·Life Sciences Verification Program을 통과한 미국 조직으로 접근을 제한합니다. 접근은 Anthropic·AWS·Google Cloud 계정 팀에 문의하며, 일반 Claude Code /model로는 선택할 수 없습니다.
재배포 이력(2026-07): Fable 5는 2026-06-09 GA로 출시됐고, 2026-06-12 미국 수출통제로 Mythos 5와 함께 전 사용자 접근이 약 19일간 중단됐다가 2026-07-01 전역 복원됐습니다. 재배포 시 취약점 탐지 행위를 겨냥한 개선된 안전 분류기가 적용됐고, Fable 5.1은 같은 stop_details 카테고리를 커버하는 분류기를 갖습니다. Anthropic은 5.1 출시와 함께 생물학 분류기의 무해 질의 오탐을 85% 줄였다고 발표했습니다.

Fable 5.1과 Fable 5의 Messages API 차이

구분	Fable 5	Fable 5.1	대응
강제 tool 호출	`tool_choice` `any`·`tool` 허용	`any`·`tool`은 400 `invalid_request_error` (`count_tokens`·Batch 포함)	`auto` + 프롬프트에서 도구 지정, `strict: true`, 또는 structured outputs
thinking block 귀속	모델 간 재사용	5.1이 만든 thinking block은 이전 모델이 읽지 못하고 무과금으로 drop됨. 5.1은 Opus 5·Fable 5·이전 모델 block을 읽음	fallback·라우터로 모델이 바뀌는 경로에서 추론 손실을 감안. `thinking-binding-controls-2026-08-01` beta로 drop을 `input_transformations`에 보고
이전 턴 편집	허용	`system`·`tools`·이전 메시지를 바꾸면 이후 thinking block이 무효화. 2026-08-31 이후 생성 계정은 400 강제, 이전 계정은 `thinking.block_binding.prefix_mismatch_behavior`로 opt-in	대화를 append-only로 유지. 지시 변경은 mid-conversation system message, 컨텍스트 축소는 서버 측 compaction·context editing 사용

Fable 구독 및 usage credits

경로	현재 사용 기준	운영 메모
Pro·Max·Team	usage credits 필요	credits가 꺼져 있거나 잔액이 없으면 Fable 5에 접근할 수 없음
Standard Enterprise seat	usage credits 필요	한시적 포함량 대상이 아니었음
Premium/select Enterprise seat	usage credits 필요	2026-07-07까지만 좌석 사용량의 최대 50%에 포함
Claude API·소비 기반 Enterprise	토큰 기반 API 과금	좌석별 주간 포함량과 별도이며 Fable 5 표준 단가 적용

Messages API 거절·폴백 처리

{
  "model": "claude-fable-5-1",
  "content": [],
  "stop_reason": "refusal",
  "stop_details": {
    "type": "refusal",
    "category": "cyber",
    "explanation": "..."
  }
}

폴백 방식	적용 범위	구현 기준
서버 측 폴백	Claude API·Claude Platform on AWS 베타	`fallbacks`에 최대 3개 모델을 지정하고 `server-side-fallback-2026-06-01` beta header 사용. 또는 `server-side-fallback-2026-07-01` beta의 `fallbacks: "default"`로 거절 카테고리별 권장 모델에 자동 재시도. Fable 5.1의 허용 fallback 대상은 Opus 4.8과 Opus 5
SDK middleware	모든 지원 플랫폼	refusal-fallback middleware와 대화별 상태를 재사용해 수락한 모델에 후속 턴을 고정
수동 재시도	모든 플랫폼·언어	거절을 직접 감지해 다른 모델로 재요청하고 `fallback-credit-2026-06-01` 흐름으로 캐시 비용 환급

서버 측 fallbacks와 SDK middleware는 같은 요청에 함께 설정하지 않습니다.
Message Batches에서 거절 항목은 result.type: "succeeded"로 반환될 수 있으므로 stop_reason을 확인합니다. 서버 측 fallbacks는 batch에서 지원되지 않습니다.
Claude Code의 fallbackModel/--fallback-model은 모델 가용성 실패에 대비한 체인입니다. Fable 안전 분류기 거절을 처리하는 Messages API fallbacks와 같은 설정이 아닙니다.
출력 생성 전 거절된 요청에는 요금이 부과되지 않습니다. 서버 측 폴백과 SDK middleware는 fallback credit을 자동 적용하고, 수동 재시도는 거절 응답의 credit token을 재전송해야 모델 전환에 따른 prompt-cache write 비용을 이중 부담하지 않습니다.
refusal 수와 usage.iterations의 fallback_message 수를 별도 지표로 기록합니다. 둘의 차이가 커지면 폴백 설정이 누락된 요청 경로가 있는지 확인합니다.

Opus 5 운영 기준

Opus 5는 v2.1.219부터 Anthropic API와 주요 provider의 최신 고성능 Opus 경로입니다. 복잡한 multi-step 작업, 큰 설계 판단, 장기 agentic task에 배정합니다.
native 1M context를 지원하고, Claude Code에서는 claude-opus-5 또는 opus로 선택합니다.
fast mode는 Opus 5와 Opus 4.8에서 지원되며, Opus 5 fast 단가는 입력 $10·출력$ 50/MTok입니다.
Microsoft Foundry에서는 opus가 아직 Opus 4.6이므로 provider를 넘나드는 재현 작업은 alias 대신 full model name을 고정하세요.
일반 구현/문서/테스트 반복은 sonnet, 단순 보조 작업은 haiku를 기본으로 두면 비용 관리에 유리합니다.

Sonnet 5 운영 기준

Sonnet 5는 Claude Code v2.1.197부터 Claude Code의 기본 Sonnet 경로입니다.
Anthropic API에서 sonnet alias와 Pro·Team Standard·Enterprise subscription seat의 default가 Sonnet 5로 해석됩니다.
Sonnet 5는 1M 컨텍스트를 기본으로 지원하므로 일반 Anthropic API에서는 sonnet[1m] 접미사가 별도 효과를 내지 않습니다. LLM gateway 뒤에서 1M 지원을 명시해야 할 때만 이 접미사를 씁니다.
지원 effort는 low/medium/high/xhigh/max이고 기본값은 high입니다.

주의사항

모델 전환 후 응답 성향이 바뀌므로 출력 포맷을 다시 고정
고난도 작업은 전환 직후 작은 샘플로 품질 확인
/model 선택이 기본값으로 저장되는 동작을 팀원에게 명확히 안내. 현재 세션만 바꿀 때는 picker의 s 사용
대화에 이전 출력이 있으면 모델 전환 시 picker가 확인을 요청함. 다음 응답이 캐시 없이 전체 히스토리를 다시 읽기 때문이며, 토큰 비용·지연이 늘 수 있음
claude --resume, --continue, /resume은 transcript에 저장된 모델을 우선 유지
gateway나 third-party provider에서는 /model에 보이는 alias가 최신 Anthropic API alias와 다를 수 있음
Opus 5를 쓰려면 Claude Code v2.1.219 이상인지 /status 또는 claude --version으로 확인
Sonnet 5를 쓰려면 Claude Code v2.1.197 이상인지 /status 또는 claude --version으로 확인
Fable 5.1을 쓰려면 Claude Code v2.1.255 이상, Fable 5는 v2.1.170 이상인지 /status 또는 claude --version으로 확인. v2.1.257~259에서는 조직에 권한이 있어도 picker에 Fable 5.1이 안 보이고 /model claude-fable-5-1로만 선택되는 버그가 있었으며 v2.1.260에서 수정됨
v2.1.260 이전 빌드에서는 Fable 5.1의 tool result 뒤 컨텍스트가 prompt cache에 포함되지 않아 매 tool 턴마다 비캐시 입력으로 재전송됐음. Fable 5.1 비용이 예상보다 높게 나오면 먼저 버전을 확인
model: fable 서브에이전트가 ANTHROPIC_DEFAULT_FABLE_MODEL의 [1m] 태그를 무시하고 200K로 돌던 문제는 v2.1.260에서 수정됨
v2.1.261부터 /model picker와 VS Code 모델 pill은 Claude Code가 인식하는 Bedrock·Vertex AI·LLM gateway ID를 raw ID 대신 모델 이름으로 표시함. 재현 문서에는 여전히 full ID를 적을 것
v2.1.184+ model restriction과 v2.1.187+ deprecated model warning 때문에 오래된 full model ID는 팀 설정에서 정리
availability failure 대비가 필요한 장기 세션은 settings의 fallbackModel 또는 claude --fallback-model opus,sonnet으로 fallback chain을 지정
Fable에 대해서만 prompt caching을 끄려면 DISABLE_PROMPT_CACHING_FABLE=1을 사용
v2.1.73에서 Bedrock, Vertex, Microsoft Foundry의 기본 Opus 모델이 Opus 4.6으로 변경됨
v2.1.68에서 Opus 4.6이 Max/Team 구독자에게 medium effort 기본값으로 적용
Opus 4, 4.1이 first-party API에서 제거되어 Opus 4.6으로 자동 마이그레이션됨 (v2.1.68)
v2.1.77에서 Opus 4.6의 기본 최대 출력 토큰이 64k로 증가 (상한 128k)
v2.1.117부터 /model 선택은 재시작 후에도 유지되며, project/managed settings pin이 활성 모델을 바꾸면 startup header에 출처가 표시됩니다. v2.1.153 이후로는 user settings 기본값 저장 방식이 더 명확해졌습니다.
v2.1.201에서 Sonnet 5 세션은 mid-conversation system role을 더 이상 사용하지 않습니다. Sonnet 5 기반 세션의 운영자 지시 주입 동작이 바뀌었으니 관련 훅/스크립트를 재검증하세요. (참고: v2.1.198부터 서브에이전트가 기본 백그라운드 실행, v2.1.200부터 기본 permission mode가 Manual)

공식 근거

전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록

역할

사용 조건

사용 예

선택 시점

관련 명령 선택

실행 결과와 유지 범위

모델 표시

Fable 5.1 운영 기준

Fable 5.1과 Fable 5의 Messages API 차이

Fable 구독 및 usage credits

Messages API 거절·폴백 처리

Opus 5 운영 기준

Sonnet 5 운영 기준

주의사항

공식 근거

On this page

Cmd. /model

역할

사용 조건

사용 예

선택 시점

관련 명령 선택

실행 결과와 유지 범위

모델 표시

Fable 5.1 운영 기준

Fable 5.1과 Fable 5의 Messages API 차이

Fable 구독 및 usage credits

Messages API 거절·폴백 처리

Opus 5 운영 기준

Sonnet 5 운영 기준

주의사항

공식 근거

On this page