Cmd. /model

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

핵심 요약

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

역할

모델 선택 및 기본값 저장

/model [model]

사용 조건

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

인자 없는 호출은 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가 가리키는 대상도 한 번 더 움직였고, 2026-09-22 Opus 5.5 출시(Claude Code v2.1.280)로 opus와 default도 바뀌었습니다. 2026-09-28 Sonnet 5.5 출시(v2.1.284)로 Anthropic API의 sonnet도 Sonnet 5.5가 됐고, 2026-10-07 Haiku 5.5 출시(v2.1.293)로 haiku도 Haiku 5.5가 됐습니다. 아래 표로 현재 해석을 확인하세요.

Provider	`opus`	`sonnet`	`haiku`	`default`
Anthropic API (Pro·Max·Team·Enterprise·API 키)	Opus 5.5	Sonnet 5.5	Haiku 5.5	Opus 5.5
Claude Platform on AWS	Opus 5.5	Sonnet 4.6	Haiku 4.5	Opus 5.5
Amazon Bedrock, Google Cloud Agent Platform	Opus 5.5	Sonnet 4.5	Haiku 4.5	Opus 5.5
Microsoft Foundry	Opus 4.6	Sonnet 4.5	Haiku 4.5	Sonnet 4.5

v2.1.280 이전에는 Pro·Team Standard의 default가 Sonnet 5, 나머지 플랜과 provider는 Opus 5였습니다. v2.1.280부터 Pro·Team Standard도 Max·Team Premium·Enterprise와 같이 Opus가 기본입니다. 조직 기본 모델(organization default model)이 설정돼 있으면 default는 그 모델로 해석됩니다.

모델 표시

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 이상에서 동작합니다.
가장 어려운 코딩 작업, 수 시간짜리 자율 조사, 모호한 장애 원인 분석, 고위험 아키텍처 판단에 배정합니다. 공식 models overview는 대부분의 워크로드를 Opus 5.5로 시작하고, Opus 5.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.5의 생물학 플래그 → Opus 5, 사이버보안 플래그 → Opus 4.8, Opus 5의 사이버보안 플래그 → Opus 4.8, Opus 5의 생물학 플래그 → 거절(fallback 없음), Sonnet 5.5의 사이버보안 플래그 → Sonnet 5, Sonnet 5.5의 생물학 플래그 → 거절(fallback 없음)입니다. v2.1.287부터는 플래그로 모델이 자동 전환돼도 새 모델의 기본값이 아니라 현재 effort 레벨을 유지합니다. 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.5 운영 기준

Opus 5.5(claude-opus-5-5)는 2026-09-22 출시됐고 Claude Code v2.1.280부터 기본 Opus 모델입니다. opus alias는 Anthropic API·Claude Platform on AWS·Bedrock·Google Cloud Agent Platform에서 Opus 5.5로 해석되며, Microsoft Foundry를 제외한 모든 플랜·provider의 default도 Opus 5.5입니다. 요구 버전은 v2.1.280 이상입니다.
공식 설명은 "long-running agentic coding and knowledge work"용입니다. 사양은 1M context, 최대 128K output, $4/MTok input·$ 20/MTok output이며 prompt cache read는 $0.20/MTok(기본 입력 단가의 5%)입니다. 지식 기준일은 2026년 6월, 은퇴는 2027-09-22 이전에는 없습니다.
기본 effort는 medium입니다(다른 모델은 대부분 high). 사용자 settings의 최상위 effortLevel은 Opus 5.5에 적용되지 않으므로 /effort나 /model picker에서 따로 고릅니다. 자세한 규칙은 /effort를 참고하세요.
Fable처럼 adaptive thinking이 항상 켜져 있어 세션 thinking toggle, alwaysThinkingEnabled, MAX_THINKING_TOKENS=0이 효과가 없습니다.
fast mode는 v2.1.280부터 Opus 5.5가 기본이며 단가는 입력 $8·출력$ 40/MTok입니다. Opus 5·Opus 4.8 fast는 $10/$ 50입니다.
v2.1.283부터 /model picker의 Opus 행과 Default 이름에서 "(1M context)" 표기가 빠졌습니다. 이미 1M context인 Opus에서 표기만 없앤 것이고 context window는 그대로입니다.
새 모델 차단: availableModels에 claude-opus-5 같은 항목이 있으면 Opus 5.5 같은 후속 릴리스도 곧바로 허용됩니다. v2.1.283부터 managed settings의 deniedModels로 특정 모델을 막거나, availableModelsMatch: "exact"로 목록에 적은 버전만 허용할 수 있습니다. 이전 버전은 두 키를 무시하므로 requiredMinimumVersion도 함께 설정합니다.
Messages API 마이그레이션: 직접 운영하는 하네스를 Opus 5에서 옮길 때는 thinking 비활성화 불가, 강제 tool_choice(any·tool) 400 오류, 모델·대화에 묶이는 thinking block, Claude API·Google Cloud에서 computer_20251124 미지원이라는 네 가지 breaking change를 먼저 점검합니다.
Opus 5 위치: Opus 5(claude-opus-5, v2.1.219+)는 이전 기본 Opus입니다. 회귀 비교나 재현이 필요하면 full model name으로 pinning하고, Opus 5.5의 생물학 플래그 fallback 대상으로도 쓰입니다.
Microsoft Foundry에서는 opus가 아직 Opus 4.6이므로 provider를 넘나드는 재현 작업은 alias 대신 full model name을 고정하세요.
일반 구현/문서/테스트 반복은 sonnet, 단순 보조 작업은 haiku를 기본으로 두면 비용 관리에 유리합니다.

Sonnet 5.5 운영 기준

Sonnet 5.5(claude-sonnet-5-5)는 2026-09-28 출시됐고 Claude Code v2.1.284부터 Anthropic API의 기본 Sonnet 모델입니다. 요구 버전은 v2.1.284 이상입니다. Claude Platform on AWS(Sonnet 4.6)와 Bedrock·Google Cloud Agent Platform·Foundry(Sonnet 4.5)의 sonnet alias는 그대로이므로, 그 provider에서 쓰려면 full model name을 지정하거나 ANTHROPIC_DEFAULT_SONNET_MODEL을 설정합니다.
사양은 1M context, 최대 128K output, $2/MTok input·$10/MTok output이며 prompt cache read는 $0.10/MTok(기본 입력 단가의 5%)입니다. 지식 기준일은 2026년 6월, 은퇴는 2027-09-28 이전에는 없습니다.
Anthropic API에서는 항상 1M context로 동작하고 200K variant가 없어 sonnet[1m] 접미사는 효과가 없습니다. 어느 플랜에서도 usage credits가 필요하지 않습니다. LLM gateway나 custom ANTHROPIC_BASE_URL 뒤에서도 같은 1M window를 쓰므로(v2.1.285), gateway 한도가 200K라면 /autocompact 200k로 맞춥니다.
Claude Code에서의 기본 effort는 Opus 5.5와 같은 medium이고 지원 레벨은 low/medium/high/xhigh/max입니다. thinking을 끌 수 없는 점도 Opus 5.5와 같습니다.
안전 분류기가 사이버보안 요청을 걸면 Sonnet 5로 다시 실행하고, 생물학 플래그는 fallback 없이 거절로 끝납니다. third-party provider에서는 Opus pin에 더해 ANTHROPIC_DEFAULT_SONNET_MODEL이나 provider 모델 목록의 Sonnet 5 항목이 있어야 재실행됩니다.
auto mode의 client-side classifier는 v2.1.288부터 ANTHROPIC_DEFAULT_SONNET_MODEL이 Sonnet 5.5나 Opus 5.5를 가리키면 그 pin을 무시하고 Sonnet 5를 씁니다.
Sonnet 5 위치: Sonnet 5는 v2.1.197부터 v2.1.283까지 Anthropic API의 기본 Sonnet이었습니다. 지금은 Sonnet 5.5의 사이버보안 fallback 대상이고, 재현이 필요하면 full model name으로 고정합니다. 기본 effort는 high입니다.

Haiku 5.5 운영 기준

Haiku 5.5(claude-haiku-5-5)는 2026-10-07 출시됐고 Claude Code v2.1.293부터 Anthropic API의 기본 Haiku 모델입니다. 공식 Model configuration은 Haiku 5.5에 v2.1.293 이상을 쓰라고 안내합니다. Claude Platform on AWS·Bedrock·Google Cloud Agent Platform·Foundry의 haiku alias는 Haiku 4.5 그대로입니다.
/model claude-haiku-5-5나 claude --model claude-haiku-5-5로 선택합니다. model 설정이 haiku이면 Haiku 4.5에서 저장한 세션도 재개할 때 haiku가 지금 가리키는 Haiku 5.5로 열립니다.
사양은 1M context, 최대 128K output입니다. Anthropic API에서는 모든 플랜에서 [1m] 접미사 없이 1M window로 동작하고, 기본으로 약 967K token에서 auto-compact합니다. 지식 기준일은 2026년 6월, 은퇴는 2027-10-07 이전에는 없습니다.
단가는 prompt 길이로 갈립니다. prompt가 100,000 token 이하인 요청은 $0.10/MTok input·$0.50/MTok output, 넘는 요청은 $0.50·$2.50입니다. prompt cache read는 $0.01(초과 시 $0.05), 5분 cache write는 $0.125($0.625), 1시간 cache write는 $0.20($1)이고 Batch API는 50% 할인입니다. prompt 길이에는 cache read·write를 포함한 입력 token 전체가 들어가고 요청마다 따로 판정합니다. 긴 세션의 비용이 걱정되면 /autocompact로 이 모델의 window를 줄여 더 일찍 compact하게 합니다.
adaptive thinking이 항상 켜져 있어 Opus 5.5·Sonnet 5.5처럼 thinking을 끌 수 없습니다. 기본 effort는 medium이고 지원 레벨은 low/medium/high/xhigh/max입니다.
Claude 4.7 이후 모델과 같은 tokenizer를 쓰므로 같은 텍스트가 Haiku 4.5보다 약 30% 많은 token으로 계산됩니다.
v2.1.296은 일부 gateway 뒤에서 실패하던 Haiku 5.5의 token count를 고쳤습니다.

주의사항

모델 전환 후 응답 성향이 바뀌므로 출력 포맷을 다시 고정
고난도 작업은 전환 직후 작은 샘플로 품질 확인
/model 선택이 기본값으로 저장되는 동작을 팀원에게 명확히 안내. 현재 세션만 바꿀 때는 picker의 s 사용
대화에 이전 출력이 있으면 모델 전환 시 picker가 확인을 요청함. 다음 응답이 캐시 없이 전체 히스토리를 다시 읽기 때문이며, 토큰 비용·지연이 늘 수 있음
claude --resume, --continue, /resume은 transcript에 저장된 모델을 우선 유지
gateway나 third-party provider에서는 /model에 보이는 alias가 최신 Anthropic API alias와 다를 수 있음
Opus 5.5를 쓰려면 Claude Code v2.1.280 이상(Opus 5는 v2.1.219 이상)인지 /status 또는 claude --version으로 확인
Sonnet 5.5는 Claude Code v2.1.284 이상, Sonnet 5는 v2.1.197 이상, Haiku 5.5는 v2.1.293 이상이 필요하므로 /status 또는 claude --version으로 확인
v2.1.287부터 Bedrock·Vertex·Foundry·Claude apps gateway의 Opus 4.7 이상과 Fable은 [1m] 접미사 없이 1M context를 기본으로 씁니다. 200K를 유지하려면 CLAUDE_CODE_DISABLE_1M_CONTEXT=1을 설정합니다.
v2.1.290부터 claude agents에서 바쁜 background session에 보낸 /model·/effort·/rename은 턴이 끝나기를 기다리지 않고 확인 없이 바로 적용됩니다.
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-10-23 · Claude Code 2.1.308

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

사용 예

/model

/model sonnet

/model fable

/model opus

선택 시점

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

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

실행 결과와 유지 범위

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

Provider	`opus`	`sonnet`	`haiku`	`default`
Anthropic API (Pro·Max·Team·Enterprise·API 키)	Opus 5.5	Sonnet 5.5	Haiku 5.5	Opus 5.5
Claude Platform on AWS	Opus 5.5	Sonnet 4.6	Haiku 4.5	Opus 5.5
Amazon Bedrock, Google Cloud Agent Platform	Opus 5.5	Sonnet 4.5	Haiku 4.5	Opus 5.5
Microsoft Foundry	Opus 4.6	Sonnet 4.5	Haiku 4.5	Sonnet 4.5

모델 표시

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 이상에서 동작합니다.
가장 어려운 코딩 작업, 수 시간짜리 자율 조사, 모호한 장애 원인 분석, 고위험 아키텍처 판단에 배정합니다. 공식 models overview는 대부분의 워크로드를 Opus 5.5로 시작하고, Opus 5.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.5의 생물학 플래그 → Opus 5, 사이버보안 플래그 → Opus 4.8, Opus 5의 사이버보안 플래그 → Opus 4.8, Opus 5의 생물학 플래그 → 거절(fallback 없음), Sonnet 5.5의 사이버보안 플래그 → Sonnet 5, Sonnet 5.5의 생물학 플래그 → 거절(fallback 없음)입니다. v2.1.287부터는 플래그로 모델이 자동 전환돼도 새 모델의 기본값이 아니라 현재 effort 레벨을 유지합니다. 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.5 운영 기준

Opus 5.5(claude-opus-5-5)는 2026-09-22 출시됐고 Claude Code v2.1.280부터 기본 Opus 모델입니다. opus alias는 Anthropic API·Claude Platform on AWS·Bedrock·Google Cloud Agent Platform에서 Opus 5.5로 해석되며, Microsoft Foundry를 제외한 모든 플랜·provider의 default도 Opus 5.5입니다. 요구 버전은 v2.1.280 이상입니다.
공식 설명은 "long-running agentic coding and knowledge work"용입니다. 사양은 1M context, 최대 128K output, $4/MTok input·$ 20/MTok output이며 prompt cache read는 $0.20/MTok(기본 입력 단가의 5%)입니다. 지식 기준일은 2026년 6월, 은퇴는 2027-09-22 이전에는 없습니다.
기본 effort는 medium입니다(다른 모델은 대부분 high). 사용자 settings의 최상위 effortLevel은 Opus 5.5에 적용되지 않으므로 /effort나 /model picker에서 따로 고릅니다. 자세한 규칙은 /effort를 참고하세요.
Fable처럼 adaptive thinking이 항상 켜져 있어 세션 thinking toggle, alwaysThinkingEnabled, MAX_THINKING_TOKENS=0이 효과가 없습니다.
fast mode는 v2.1.280부터 Opus 5.5가 기본이며 단가는 입력 $8·출력$ 40/MTok입니다. Opus 5·Opus 4.8 fast는 $10/$ 50입니다.
v2.1.283부터 /model picker의 Opus 행과 Default 이름에서 "(1M context)" 표기가 빠졌습니다. 이미 1M context인 Opus에서 표기만 없앤 것이고 context window는 그대로입니다.
새 모델 차단: availableModels에 claude-opus-5 같은 항목이 있으면 Opus 5.5 같은 후속 릴리스도 곧바로 허용됩니다. v2.1.283부터 managed settings의 deniedModels로 특정 모델을 막거나, availableModelsMatch: "exact"로 목록에 적은 버전만 허용할 수 있습니다. 이전 버전은 두 키를 무시하므로 requiredMinimumVersion도 함께 설정합니다.
Messages API 마이그레이션: 직접 운영하는 하네스를 Opus 5에서 옮길 때는 thinking 비활성화 불가, 강제 tool_choice(any·tool) 400 오류, 모델·대화에 묶이는 thinking block, Claude API·Google Cloud에서 computer_20251124 미지원이라는 네 가지 breaking change를 먼저 점검합니다.
Opus 5 위치: Opus 5(claude-opus-5, v2.1.219+)는 이전 기본 Opus입니다. 회귀 비교나 재현이 필요하면 full model name으로 pinning하고, Opus 5.5의 생물학 플래그 fallback 대상으로도 쓰입니다.
Microsoft Foundry에서는 opus가 아직 Opus 4.6이므로 provider를 넘나드는 재현 작업은 alias 대신 full model name을 고정하세요.
일반 구현/문서/테스트 반복은 sonnet, 단순 보조 작업은 haiku를 기본으로 두면 비용 관리에 유리합니다.

Sonnet 5.5 운영 기준

Sonnet 5.5(claude-sonnet-5-5)는 2026-09-28 출시됐고 Claude Code v2.1.284부터 Anthropic API의 기본 Sonnet 모델입니다. 요구 버전은 v2.1.284 이상입니다. Claude Platform on AWS(Sonnet 4.6)와 Bedrock·Google Cloud Agent Platform·Foundry(Sonnet 4.5)의 sonnet alias는 그대로이므로, 그 provider에서 쓰려면 full model name을 지정하거나 ANTHROPIC_DEFAULT_SONNET_MODEL을 설정합니다.
사양은 1M context, 최대 128K output, $2/MTok input·$10/MTok output이며 prompt cache read는 $0.10/MTok(기본 입력 단가의 5%)입니다. 지식 기준일은 2026년 6월, 은퇴는 2027-09-28 이전에는 없습니다.
Anthropic API에서는 항상 1M context로 동작하고 200K variant가 없어 sonnet[1m] 접미사는 효과가 없습니다. 어느 플랜에서도 usage credits가 필요하지 않습니다. LLM gateway나 custom ANTHROPIC_BASE_URL 뒤에서도 같은 1M window를 쓰므로(v2.1.285), gateway 한도가 200K라면 /autocompact 200k로 맞춥니다.
Claude Code에서의 기본 effort는 Opus 5.5와 같은 medium이고 지원 레벨은 low/medium/high/xhigh/max입니다. thinking을 끌 수 없는 점도 Opus 5.5와 같습니다.
안전 분류기가 사이버보안 요청을 걸면 Sonnet 5로 다시 실행하고, 생물학 플래그는 fallback 없이 거절로 끝납니다. third-party provider에서는 Opus pin에 더해 ANTHROPIC_DEFAULT_SONNET_MODEL이나 provider 모델 목록의 Sonnet 5 항목이 있어야 재실행됩니다.
auto mode의 client-side classifier는 v2.1.288부터 ANTHROPIC_DEFAULT_SONNET_MODEL이 Sonnet 5.5나 Opus 5.5를 가리키면 그 pin을 무시하고 Sonnet 5를 씁니다.
Sonnet 5 위치: Sonnet 5는 v2.1.197부터 v2.1.283까지 Anthropic API의 기본 Sonnet이었습니다. 지금은 Sonnet 5.5의 사이버보안 fallback 대상이고, 재현이 필요하면 full model name으로 고정합니다. 기본 effort는 high입니다.

Haiku 5.5 운영 기준

Haiku 5.5(claude-haiku-5-5)는 2026-10-07 출시됐고 Claude Code v2.1.293부터 Anthropic API의 기본 Haiku 모델입니다. 공식 Model configuration은 Haiku 5.5에 v2.1.293 이상을 쓰라고 안내합니다. Claude Platform on AWS·Bedrock·Google Cloud Agent Platform·Foundry의 haiku alias는 Haiku 4.5 그대로입니다.
/model claude-haiku-5-5나 claude --model claude-haiku-5-5로 선택합니다. model 설정이 haiku이면 Haiku 4.5에서 저장한 세션도 재개할 때 haiku가 지금 가리키는 Haiku 5.5로 열립니다.
사양은 1M context, 최대 128K output입니다. Anthropic API에서는 모든 플랜에서 [1m] 접미사 없이 1M window로 동작하고, 기본으로 약 967K token에서 auto-compact합니다. 지식 기준일은 2026년 6월, 은퇴는 2027-10-07 이전에는 없습니다.
단가는 prompt 길이로 갈립니다. prompt가 100,000 token 이하인 요청은 $0.10/MTok input·$0.50/MTok output, 넘는 요청은 $0.50·$2.50입니다. prompt cache read는 $0.01(초과 시 $0.05), 5분 cache write는 $0.125($0.625), 1시간 cache write는 $0.20($1)이고 Batch API는 50% 할인입니다. prompt 길이에는 cache read·write를 포함한 입력 token 전체가 들어가고 요청마다 따로 판정합니다. 긴 세션의 비용이 걱정되면 /autocompact로 이 모델의 window를 줄여 더 일찍 compact하게 합니다.
adaptive thinking이 항상 켜져 있어 Opus 5.5·Sonnet 5.5처럼 thinking을 끌 수 없습니다. 기본 effort는 medium이고 지원 레벨은 low/medium/high/xhigh/max입니다.
Claude 4.7 이후 모델과 같은 tokenizer를 쓰므로 같은 텍스트가 Haiku 4.5보다 약 30% 많은 token으로 계산됩니다.
v2.1.296은 일부 gateway 뒤에서 실패하던 Haiku 5.5의 token count를 고쳤습니다.

주의사항

모델 전환 후 응답 성향이 바뀌므로 출력 포맷을 다시 고정
고난도 작업은 전환 직후 작은 샘플로 품질 확인
/model 선택이 기본값으로 저장되는 동작을 팀원에게 명확히 안내. 현재 세션만 바꿀 때는 picker의 s 사용
대화에 이전 출력이 있으면 모델 전환 시 picker가 확인을 요청함. 다음 응답이 캐시 없이 전체 히스토리를 다시 읽기 때문이며, 토큰 비용·지연이 늘 수 있음
claude --resume, --continue, /resume은 transcript에 저장된 모델을 우선 유지
gateway나 third-party provider에서는 /model에 보이는 alias가 최신 Anthropic API alias와 다를 수 있음
Opus 5.5를 쓰려면 Claude Code v2.1.280 이상(Opus 5는 v2.1.219 이상)인지 /status 또는 claude --version으로 확인
Sonnet 5.5는 Claude Code v2.1.284 이상, Sonnet 5는 v2.1.197 이상, Haiku 5.5는 v2.1.293 이상이 필요하므로 /status 또는 claude --version으로 확인
v2.1.287부터 Bedrock·Vertex·Foundry·Claude apps gateway의 Opus 4.7 이상과 Fable은 [1m] 접미사 없이 1M context를 기본으로 씁니다. 200K를 유지하려면 CLAUDE_CODE_DISABLE_1M_CONTEXT=1을 설정합니다.
v2.1.290부터 claude agents에서 바쁜 background session에 보낸 /model·/effort·/rename은 턴이 끝나기를 기다리지 않고 확인 없이 바로 적용됩니다.
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.5 운영 기준

Sonnet 5.5 운영 기준

Haiku 5.5 운영 기준

주의사항

공식 근거

On this page

Cmd. /model

역할

사용 조건

사용 예

선택 시점

관련 명령 선택

실행 결과와 유지 범위

모델 표시

Fable 5.1 운영 기준

Fable 5.1과 Fable 5의 Messages API 차이

Fable 구독 및 usage credits

Messages API 거절·폴백 처리

Opus 5.5 운영 기준

Sonnet 5.5 운영 기준

Haiku 5.5 운영 기준

주의사항

공식 근거

On this page