Cmd. /model

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

핵심 요약

/model은 AI 모델을 전환하고 그 선택을 새 세션 기본값으로 저장하며, picker 행에서 s를 누르면 현재 세션에만 적용된다.
alias(opus/sonnet/best/fable)는 provider마다 다른 버전으로 해석되므로, CI·벤치마크·재현 작업은 full model name으로 고정한다.
Fable 5는 가장 어려운 코딩·장기 자율 작업용이라 v2.1.170 이상과 조직 접근 권한이 필요하고, adaptive thinking이 항상 켜져 있어 깊이는 /effort로만 조절한다.
2026-07-07 이후 구독 플랜에서 Fable 5를 쓰려면 usage credits가 필요하며, API 통합은 HTTP 200의 stop_reason: "refusal"을 별도 성공 상태로 처리해야 한다.
Sonnet 5는 v2.1.197부터 Claude Code의 기본 Sonnet 경로이며, Anthropic API에서 native 1M context와 xhigh effort를 지원한다.
Opus 5는 v2.1.219부터 Anthropic API의 opus alias이며 native 1M context를 지원한다. Claude Code v2.1.219 이상이 필요하다.
대화에 이전 출력이 쌓인 상태에서 모델을 바꾸면 캐시 없이 전체 히스토리를 다시 읽어 토큰·지연 비용이 늘 수 있다.

명령어 원본 선언

/model [model-name]

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

Fable 5가 추가된 뒤로는 모델 이름 자체보다 alias가 provider마다 무엇으로 해석되는지를 확인하는 쓰임새가 실무에서 더 중요해졌습니다.

최소 지원 버전

초기 내장/legacy 항목으로 보이며, Changelog에 최초 도입 버전이 명시되지 않았습니다.

사용법

/model

/model sonnet

/model fable

/model opus

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

2026-08-03 모델 기준

환경	`fable` / `best`	`opus` alias	`sonnet` alias	운영 메모
Anthropic API	Fable 5(접근 권한 있을 때)	Opus 5	Sonnet 5	Opus 5는 Claude Code `v2.1.219` 이상 필요
Claude Platform on AWS	Fable 5(접근 권한 있을 때)	Opus 5	Sonnet 4.6	재현 작업은 full model name으로 pinning
Amazon Bedrock / Google Cloud Agent Platform	provider model ID pinning	Opus 5	Sonnet 4.5	`ANTHROPIC_DEFAULT_*_MODEL` pinning 권장
Microsoft Foundry	provider model ID pinning	Opus 4.6	Sonnet 4.5	provider별 alias 차이를 운영 문서에 명시

Alias는 provider별 권장 버전을 따라갑니다. 재현성이 중요한 CI, 벤치마크, 고객 재현, 장기 문서화 작업은 full model name으로 고정하세요.

2026-06-25 제한/경고 메모

v2.1.184 이후 main model restriction은 Opus/Sonnet/Haiku/Fable family 중심으로 더 엄격히 적용됩니다.
Haiku는 이 경로에서 main model로는 사용할 수 없지만, subagent model로는 사용할 수 있습니다. 저비용 보조 작업은 subagent에 Haiku를 지정하고 main session은 Sonnet/Opus/Fable 계열로 유지하세요.
v2.1.187부터 deprecated model을 사용할 때 경고가 강화됐습니다. 팀 설정에 오래된 full model ID가 남아 있으면 /model, /status, startup header에서 경고를 확인하고 최신 alias/full ID로 갱신합니다.

Fable 5 운영 기준

Fable 5는 가장 어려운 AI 코딩 작업이나 장시간 자율 조사를 맡길 때 배정합니다. 모호한 장애 원인을 분석하거나 고위험 아키텍처를 판단해야 할 때도 씁니다.
Claude Code v2.1.170 이상과 조직 접근 권한이 필요하며, 어떤 계정 유형에서도 기본 모델은 아닙니다.
/model fable, model 설정, ANTHROPIC_DEFAULT_FABLE_MODEL, 또는 접근 권한이 있는 조직의 best alias로 선택합니다.
best는 Fable 접근 권한이 있으면 Fable 5, 없으면 최신 Opus로 해석됩니다.
/advisor fable로 보조 모델 의견을 Fable에 맡길 수 있습니다.
Fable 5는 기본 1M context, 최대 128k output token, $10/MTok input·$ 50/MTok output 단가를 갖습니다. Covered Model로 30일 데이터 보존이 적용되며 ZDR(Zero Data Retention) 환경에서는 제공되지 않습니다.
adaptive thinking이 항상 켜져 있으므로 MAX_THINKING_TOKENS=0, 세션 thinking toggle, alwaysThinkingEnabled로 thinking을 끌 수 없습니다. 깊이는 /effort로 조절합니다.
요청이 안전 분류기에 걸리면 Claude Code가 기본 Opus 모델로 자동 재실행하고 알림을 띄웁니다. repo 컨텍스트 때문에 fallback이 일어나는지 확인하려면 claude --safe-mode로 설정·MCP·플러그인·스킬·훅을 끄고 재현합니다. git status와 디렉토리명은 safe mode에서도 포함됩니다.
재배포 이력(2026-07): Fable 5는 2026-06-09 GA로 출시됐습니다. 이후 2026-06-12 미국 수출통제로 Mythos 5와 함께 전 사용자 접근이 약 19일간 중단됐습니다. 6-30 통제가 해제되면서 2026-07-01 Claude Platform·Claude.ai·Claude Code·Cowork에 전역 복원됐습니다. 재배포 시 보고된 취약점 탐지 행위를 겨냥한 개선된 안전 분류기가 적용됐으므로, 위의 자동 Opus fallback 빈도는 이 분류기 기준을 따릅니다.
Mythos 5와의 구분: Mythos 5(claude-mythos-5)는 Fable 5와 동일 사양·단가이나 안전 분류기가 없는 최강 사이버보안 모델로, Project Glasswing(초대 전용·미국 핵심인프라 방어 조직)으로만 제공됩니다. 일반 접근이 불가능하고 Claude Code /model로 선택할 수 없으니, 접근 권한이 없으면 동일 성능의 Fable 5를 씁니다.

Fable 5 구독 및 usage credits

2026-07-07까지 적용된 한시적 포함량은 종료됐습니다. 2026-07-19 기준 구독 플랜과 API를 같은 사용량 풀로 오해하지 않도록 다음처럼 구분합니다.

경로	현재 사용 기준	운영 메모
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의 안전 분류기가 요청을 거절해도 Messages API는 오류가 아니라 HTTP 200 성공 응답을 반환합니다. 따라서 4xx/5xx만 감시하면 거절과 폴백 누락을 놓칩니다. content나 stop_details 유무가 아니라 stop_reason을 기준으로 분기하세요.

{
  "model": "claude-fable-5",
  "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 사용
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 5에게 내부 추론을 그대로 복사·전사·설명하라고 요구하는 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`	모델 전환 + 기본값 저장	응답 품질/속도 균형 조정
`/effort`	같은 모델의 추론 강도만 조정	모델은 유지하고 사고량만 올리거나 내림
`/config`(`/settings`)	테마·모델·output style 등 설정 UI	GUI에서 모델·기본값을 함께 점검
`/status`	현재 설정 확인 중심	버전·모델·계정·연결 상태 점검

활용 사례

팀 운영 문서에 “단계별 권장 모델” 표준 정의
PR 리뷰 자동화 시 리뷰 전용 모델 정책 적용
비용/속도 목표에 따른 작업 모드 전환
“ultrathink” 키워드로 다음 턴에 high effort를 활성화해 복잡한 문제 해결 (v2.1.68)
opusplan으로 plan mode는 opus, 실행 단계는 sonnet을 쓰도록 분리

주의사항

모델 전환 후 응답 성향이 바뀌므로 출력 포맷을 다시 고정
고난도 작업은 전환 직후 작은 샘플로 품질 확인
/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를 쓰려면 Claude Code v2.1.170 이상인지 /status 또는 claude --version으로 확인
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.74에서 full model ID(예: claude-opus-4-5)가 에이전트 frontmatter에서 정상 인식되도록 수정
v2.1.77에서 Opus 4.6의 기본 최대 출력 토큰이 64k로 증가 (상한 128k)
v2.1.78에서 ANTHROPIC_CUSTOM_MODEL_OPTION 환경변수로 /model 피커에 커스텀 항목 추가 가능
v2.1.117부터 /model 선택은 재시작 후에도 유지되며, project/managed settings pin이 활성 모델을 바꾸면 startup header에 출처가 표시됩니다. v2.1.153 이후로는 user settings 기본값 저장 방식이 더 명확해졌습니다.
v2.1.126에서 ANTHROPIC_BASE_URL gateway의 /v1/models 목록을 /model picker에 표시하는 기능이 추가되었고, v2.1.129부터는 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1로 opt-in해야 합니다.
v2.1.201에서 Sonnet 5 세션은 mid-conversation system role을 더 이상 사용하지 않습니다. Sonnet 5 기반 세션의 운영자 지시 주입 동작이 바뀌었으니 관련 훅/스크립트를 재검증하세요. (참고: v2.1.198부터 서브에이전트가 기본 백그라운드 실행, v2.1.200부터 기본 permission mode가 Manual)

출처

Commands: https://code.claude.com/docs/en/commands
Model configuration: https://code.claude.com/docs/en/model-config
Changelog: https://code.claude.com/docs/en/changelog
Fable 5 introduction: https://platform.claude.com/docs/en/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5
Fable 5 재배포 성명: https://www.anthropic.com/news/redeploying-fable-5
Refusals and fallback: https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback
Fallback credit: https://platform.claude.com/docs/en/build-with-claude/fallback-credit
Prompting Claude Fable 5: https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5
Usage credits: https://support.claude.com/en/articles/12429409-manage-usage-credits-for-paid-claude-plans
Models overview: https://platform.claude.com/docs/en/about-claude/models/overview
Model configuration (Opus 5 alias/provider matrix): https://code.claude.com/docs/en/model-config
Sonnet 5 announcement: https://www.anthropic.com/news/claude-sonnet-5

핵심 요약

/model은 AI 모델을 전환하고 그 선택을 새 세션 기본값으로 저장하며, picker 행에서 s를 누르면 현재 세션에만 적용된다.
alias(opus/sonnet/best/fable)는 provider마다 다른 버전으로 해석되므로, CI·벤치마크·재현 작업은 full model name으로 고정한다.
Fable 5는 가장 어려운 코딩·장기 자율 작업용이라 v2.1.170 이상과 조직 접근 권한이 필요하고, adaptive thinking이 항상 켜져 있어 깊이는 /effort로만 조절한다.
2026-07-07 이후 구독 플랜에서 Fable 5를 쓰려면 usage credits가 필요하며, API 통합은 HTTP 200의 stop_reason: "refusal"을 별도 성공 상태로 처리해야 한다.
Sonnet 5는 v2.1.197부터 Claude Code의 기본 Sonnet 경로이며, Anthropic API에서 native 1M context와 xhigh effort를 지원한다.
Opus 5는 v2.1.219부터 Anthropic API의 opus alias이며 native 1M context를 지원한다. Claude Code v2.1.219 이상이 필요하다.
대화에 이전 출력이 쌓인 상태에서 모델을 바꾸면 캐시 없이 전체 히스토리를 다시 읽어 토큰·지연 비용이 늘 수 있다.

명령어 원본 선언

/model [model-name]

공식 설명 요약

Fable 5가 추가된 뒤로는 모델 이름 자체보다 alias가 provider마다 무엇으로 해석되는지를 확인하는 쓰임새가 실무에서 더 중요해졌습니다.

최소 지원 버전

초기 내장/legacy 항목으로 보이며, Changelog에 최초 도입 버전이 명시되지 않았습니다.

사용법

/model

/model sonnet

/model fable

/model opus

2026-08-03 모델 기준

환경	`fable` / `best`	`opus` alias	`sonnet` alias	운영 메모
Anthropic API	Fable 5(접근 권한 있을 때)	Opus 5	Sonnet 5	Opus 5는 Claude Code `v2.1.219` 이상 필요
Claude Platform on AWS	Fable 5(접근 권한 있을 때)	Opus 5	Sonnet 4.6	재현 작업은 full model name으로 pinning
Amazon Bedrock / Google Cloud Agent Platform	provider model ID pinning	Opus 5	Sonnet 4.5	`ANTHROPIC_DEFAULT_*_MODEL` pinning 권장
Microsoft Foundry	provider model ID pinning	Opus 4.6	Sonnet 4.5	provider별 alias 차이를 운영 문서에 명시

Alias는 provider별 권장 버전을 따라갑니다. 재현성이 중요한 CI, 벤치마크, 고객 재현, 장기 문서화 작업은 full model name으로 고정하세요.

2026-06-25 제한/경고 메모

v2.1.184 이후 main model restriction은 Opus/Sonnet/Haiku/Fable family 중심으로 더 엄격히 적용됩니다.
Haiku는 이 경로에서 main model로는 사용할 수 없지만, subagent model로는 사용할 수 있습니다. 저비용 보조 작업은 subagent에 Haiku를 지정하고 main session은 Sonnet/Opus/Fable 계열로 유지하세요.
v2.1.187부터 deprecated model을 사용할 때 경고가 강화됐습니다. 팀 설정에 오래된 full model ID가 남아 있으면 /model, /status, startup header에서 경고를 확인하고 최신 alias/full ID로 갱신합니다.

Fable 5 운영 기준

Fable 5는 가장 어려운 AI 코딩 작업이나 장시간 자율 조사를 맡길 때 배정합니다. 모호한 장애 원인을 분석하거나 고위험 아키텍처를 판단해야 할 때도 씁니다.
Claude Code v2.1.170 이상과 조직 접근 권한이 필요하며, 어떤 계정 유형에서도 기본 모델은 아닙니다.
/model fable, model 설정, ANTHROPIC_DEFAULT_FABLE_MODEL, 또는 접근 권한이 있는 조직의 best alias로 선택합니다.
best는 Fable 접근 권한이 있으면 Fable 5, 없으면 최신 Opus로 해석됩니다.
/advisor fable로 보조 모델 의견을 Fable에 맡길 수 있습니다.
Fable 5는 기본 1M context, 최대 128k output token, $10/MTok input·$ 50/MTok output 단가를 갖습니다. Covered Model로 30일 데이터 보존이 적용되며 ZDR(Zero Data Retention) 환경에서는 제공되지 않습니다.
adaptive thinking이 항상 켜져 있으므로 MAX_THINKING_TOKENS=0, 세션 thinking toggle, alwaysThinkingEnabled로 thinking을 끌 수 없습니다. 깊이는 /effort로 조절합니다.
요청이 안전 분류기에 걸리면 Claude Code가 기본 Opus 모델로 자동 재실행하고 알림을 띄웁니다. repo 컨텍스트 때문에 fallback이 일어나는지 확인하려면 claude --safe-mode로 설정·MCP·플러그인·스킬·훅을 끄고 재현합니다. git status와 디렉토리명은 safe mode에서도 포함됩니다.
재배포 이력(2026-07): Fable 5는 2026-06-09 GA로 출시됐습니다. 이후 2026-06-12 미국 수출통제로 Mythos 5와 함께 전 사용자 접근이 약 19일간 중단됐습니다. 6-30 통제가 해제되면서 2026-07-01 Claude Platform·Claude.ai·Claude Code·Cowork에 전역 복원됐습니다. 재배포 시 보고된 취약점 탐지 행위를 겨냥한 개선된 안전 분류기가 적용됐으므로, 위의 자동 Opus fallback 빈도는 이 분류기 기준을 따릅니다.
Mythos 5와의 구분: Mythos 5(claude-mythos-5)는 Fable 5와 동일 사양·단가이나 안전 분류기가 없는 최강 사이버보안 모델로, Project Glasswing(초대 전용·미국 핵심인프라 방어 조직)으로만 제공됩니다. 일반 접근이 불가능하고 Claude Code /model로 선택할 수 없으니, 접근 권한이 없으면 동일 성능의 Fable 5를 씁니다.

Fable 5 구독 및 usage credits

2026-07-07까지 적용된 한시적 포함량은 종료됐습니다. 2026-07-19 기준 구독 플랜과 API를 같은 사용량 풀로 오해하지 않도록 다음처럼 구분합니다.

경로	현재 사용 기준	운영 메모
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",
  "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 사용
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`	모델 전환 + 기본값 저장	응답 품질/속도 균형 조정
`/effort`	같은 모델의 추론 강도만 조정	모델은 유지하고 사고량만 올리거나 내림
`/config`(`/settings`)	테마·모델·output style 등 설정 UI	GUI에서 모델·기본값을 함께 점검
`/status`	현재 설정 확인 중심	버전·모델·계정·연결 상태 점검

활용 사례

팀 운영 문서에 “단계별 권장 모델” 표준 정의
PR 리뷰 자동화 시 리뷰 전용 모델 정책 적용
비용/속도 목표에 따른 작업 모드 전환
“ultrathink” 키워드로 다음 턴에 high effort를 활성화해 복잡한 문제 해결 (v2.1.68)
opusplan으로 plan mode는 opus, 실행 단계는 sonnet을 쓰도록 분리

주의사항

모델 전환 후 응답 성향이 바뀌므로 출력 포맷을 다시 고정
고난도 작업은 전환 직후 작은 샘플로 품질 확인
/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를 쓰려면 Claude Code v2.1.170 이상인지 /status 또는 claude --version으로 확인
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.74에서 full model ID(예: claude-opus-4-5)가 에이전트 frontmatter에서 정상 인식되도록 수정
v2.1.77에서 Opus 4.6의 기본 최대 출력 토큰이 64k로 증가 (상한 128k)
v2.1.78에서 ANTHROPIC_CUSTOM_MODEL_OPTION 환경변수로 /model 피커에 커스텀 항목 추가 가능
v2.1.117부터 /model 선택은 재시작 후에도 유지되며, project/managed settings pin이 활성 모델을 바꾸면 startup header에 출처가 표시됩니다. v2.1.153 이후로는 user settings 기본값 저장 방식이 더 명확해졌습니다.
v2.1.126에서 ANTHROPIC_BASE_URL gateway의 /v1/models 목록을 /model picker에 표시하는 기능이 추가되었고, v2.1.129부터는 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1로 opt-in해야 합니다.
v2.1.201에서 Sonnet 5 세션은 mid-conversation system role을 더 이상 사용하지 않습니다. Sonnet 5 기반 세션의 운영자 지시 주입 동작이 바뀌었으니 관련 훅/스크립트를 재검증하세요. (참고: v2.1.198부터 서브에이전트가 기본 백그라운드 실행, v2.1.200부터 기본 permission mode가 Manual)

출처

Commands: https://code.claude.com/docs/en/commands
Model configuration: https://code.claude.com/docs/en/model-config
Changelog: https://code.claude.com/docs/en/changelog
Fable 5 introduction: https://platform.claude.com/docs/en/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5
Fable 5 재배포 성명: https://www.anthropic.com/news/redeploying-fable-5
Refusals and fallback: https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback
Fallback credit: https://platform.claude.com/docs/en/build-with-claude/fallback-credit
Prompting Claude Fable 5: https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5
Usage credits: https://support.claude.com/en/articles/12429409-manage-usage-credits-for-paid-claude-plans
Models overview: https://platform.claude.com/docs/en/about-claude/models/overview
Model configuration (Opus 5 alias/provider matrix): https://code.claude.com/docs/en/model-config
Sonnet 5 announcement: https://www.anthropic.com/news/claude-sonnet-5

명령어 원본 선언

공식 설명 요약

최소 지원 버전

사용법

2026-08-03 모델 기준

2026-06-25 제한/경고 메모

Fable 5 운영 기준

Fable 5 구독 및 usage credits

Messages API 거절·폴백 처리

Opus 5 운영 기준

Sonnet 5 운영 기준

좋은 사용 예

비슷한 명령어 추천

활용 사례

주의사항

출처

On this page

Cmd. /model

명령어 원본 선언

공식 설명 요약

최소 지원 버전

사용법

2026-08-03 모델 기준

2026-06-25 제한/경고 메모

Fable 5 운영 기준

Fable 5 구독 및 usage credits

Messages API 거절·폴백 처리

Opus 5 운영 기준

Sonnet 5 운영 기준

좋은 사용 예

비슷한 명령어 추천

활용 사례

주의사항

출처

On this page