Cmd. /model

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

핵심 요약

/model은 AI 모델을 전환하고 그 선택을 새 세션 기본값으로 저장하며, picker 행에서 s를 누르면 현재 세션에만 적용된다.
alias(opus/sonnet/best/fable)는 provider마다 다른 버전으로 해석되므로, CI·벤치마크·재현 작업은 full model name으로 고정한다.
Fable 5는 가장 어려운 코딩·장기 자율 작업용이라 v2.1.170 이상과 조직 접근 권한이 필요하고, adaptive thinking이 항상 켜져 있어 깊이는 /effort로만 조절한다.
Opus 4.8은 v2.1.154에서 high effort가 기본이며 /effort xhigh로 더 올릴 수 있다.
대화에 이전 출력이 쌓인 상태에서 모델을 바꾸면 캐시 없이 전체 히스토리를 다시 읽어 토큰·지연 비용이 늘 수 있다.

명령어 원본 선언

/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-06-10 모델 기준

환경	`fable` / `best`	`opus` alias	`sonnet` alias	운영 메모
Anthropic API	Fable 5(접근 권한 있을 때)	Opus 4.8	Sonnet 4.6	Fable 5는 Claude Code `v2.1.170` 이상, Opus 4.8은 `v2.1.154` 이상 필요
Claude Platform on AWS	Fable 5(접근 권한 있을 때)	Opus 4.7	Sonnet 4.6	Fable 안전 fallback은 platform 기본 Opus 경로로 이동
Bedrock / Vertex / Foundry	provider model ID pinning	Opus 4.6	Sonnet 4.5	최신 모델은 full model name 또는 `ANTHROPIC_DEFAULT_*_MODEL` pinning 필요

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에서도 포함됩니다.

Opus 4.8 운영 기준

Opus 4.8은 Fable을 사용할 수 없거나 비용상 과할 때의 고성능 Opus 경로입니다. 복잡한 multi-step 작업, 큰 설계 판단, 장기 agentic task에 배정합니다.
Claude Code v2.1.154에서 Opus 4.8은 high effort가 기본입니다.
가장 어려운 작업에는 /effort xhigh를 사용할 수 있습니다.
Opus 4.8 fast mode는 표준 대비 2배 요금으로 2.5배 속도를 제공하는 경로입니다.
일반 구현/문서/테스트 반복은 sonnet, 단순 보조 작업은 haiku를 기본으로 두면 비용 관리에 유리합니다.

좋은 사용 예

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

비슷한 명령어 추천

명령어	차이점	언제 선택
`/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 4.8을 쓰려면 Claude Code v2.1.154 이상인지 /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해야 합니다.

출처

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
Models overview: https://platform.claude.com/docs/en/about-claude/models/overview
Opus 4.8 announcement: https://www.anthropic.com/news/claude-opus-4-8

핵심 요약

/model은 AI 모델을 전환하고 그 선택을 새 세션 기본값으로 저장하며, picker 행에서 s를 누르면 현재 세션에만 적용된다.
alias(opus/sonnet/best/fable)는 provider마다 다른 버전으로 해석되므로, CI·벤치마크·재현 작업은 full model name으로 고정한다.
Fable 5는 가장 어려운 코딩·장기 자율 작업용이라 v2.1.170 이상과 조직 접근 권한이 필요하고, adaptive thinking이 항상 켜져 있어 깊이는 /effort로만 조절한다.
Opus 4.8은 v2.1.154에서 high effort가 기본이며 /effort xhigh로 더 올릴 수 있다.
대화에 이전 출력이 쌓인 상태에서 모델을 바꾸면 캐시 없이 전체 히스토리를 다시 읽어 토큰·지연 비용이 늘 수 있다.

명령어 원본 선언

/model [model-name]

공식 설명 요약

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

최소 지원 버전

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

사용법

/model

/model sonnet

/model fable

/model opus

2026-06-10 모델 기준

환경	`fable` / `best`	`opus` alias	`sonnet` alias	운영 메모
Anthropic API	Fable 5(접근 권한 있을 때)	Opus 4.8	Sonnet 4.6	Fable 5는 Claude Code `v2.1.170` 이상, Opus 4.8은 `v2.1.154` 이상 필요
Claude Platform on AWS	Fable 5(접근 권한 있을 때)	Opus 4.7	Sonnet 4.6	Fable 안전 fallback은 platform 기본 Opus 경로로 이동
Bedrock / Vertex / Foundry	provider model ID pinning	Opus 4.6	Sonnet 4.5	최신 모델은 full model name 또는 `ANTHROPIC_DEFAULT_*_MODEL` pinning 필요

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에서도 포함됩니다.

Opus 4.8 운영 기준

Opus 4.8은 Fable을 사용할 수 없거나 비용상 과할 때의 고성능 Opus 경로입니다. 복잡한 multi-step 작업, 큰 설계 판단, 장기 agentic task에 배정합니다.
Claude Code v2.1.154에서 Opus 4.8은 high effort가 기본입니다.
가장 어려운 작업에는 /effort xhigh를 사용할 수 있습니다.
Opus 4.8 fast mode는 표준 대비 2배 요금으로 2.5배 속도를 제공하는 경로입니다.
일반 구현/문서/테스트 반복은 sonnet, 단순 보조 작업은 haiku를 기본으로 두면 비용 관리에 유리합니다.

좋은 사용 예

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

비슷한 명령어 추천

명령어	차이점	언제 선택
`/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 4.8을 쓰려면 Claude Code v2.1.154 이상인지 /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해야 합니다.

출처

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
Models overview: https://platform.claude.com/docs/en/about-claude/models/overview
Opus 4.8 announcement: https://www.anthropic.com/news/claude-opus-4-8

명령어 원본 선언

공식 설명 요약

최소 지원 버전

사용법

2026-06-10 모델 기준

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

Fable 5 운영 기준

Opus 4.8 운영 기준

좋은 사용 예

비슷한 명령어 추천

활용 사례

주의사항

출처

목차

Cmd. /model

명령어 원본 선언

공식 설명 요약

최소 지원 버전

사용법

2026-06-10 모델 기준

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

Fable 5 운영 기준

Opus 4.8 운영 기준

좋은 사용 예

비슷한 명령어 추천

활용 사례

주의사항

출처

목차