/model은 세션 중에 모델을 바꾸는 명령이고, 고른 모델은 새 세션의 기본값으로도 저장됩니다. 어려운 작업과 단순한 작업에 다른 모델을 쓰려고 씁니다.
직접 써보니
이 사이트를 개편하는 긴 세션에서 처음에는 서브에이전트가 메인 모델로 돌았습니다. 비용 때문에 낮추라는 요청이 있어서 진행 중이던 에이전트를 멈추고 Sonnet 모델로 다시 띄웠고, 이미 저장된 결과 파일은 그대로 살렸습니다. 또 세션 중간에 /model로 Opus 5.5로 바꾸자 Claude Code가 기본값으로 저장되어 새 세션에도 적용된다고 안내했습니다.
어떻게 동작하나
/model을 인수 없이 실행하면 선택창이 열리고, /model sonnet처럼 별칭이나 이름을 주면 바로 바뀝니다. 모델을 정하는 곳은 여러 군데이고, 우선순위는 높은 쪽부터 다음과 같습니다.
- 1. 세션 중 /model <별칭 또는 이름>
- 2. 시작할 때 claude --model <별칭 또는 이름>
- 3. 환경 변수 ANTHROPIC_MODEL
- 4. 설정 파일의 model 필드
- 5. 새 세션 기본값 ANTHROPIC_DEFAULT_MODEL (v2.1.236 이상)
저장되는 방식
/model로 고르면 그 선택이 새 세션의 기본값으로 저장됩니다. 사용자 설정(~/.claude/settings.json)의 model 필드에 기록되는 방식입니다. 선택창에서 Enter는 전환하고 저장하며, s 키는 이번 세션에만 적용하고 기본값은 그대로 둡니다. /model <이름>처럼 직접 입력하면 Enter와 같이 저장됩니다.
--model과 ANTHROPIC_MODEL은 그 실행에만 적용됩니다. 프로젝트 설정과 관리형 설정은 내가 저장한 선택보다 우선해서 다음 실행 때 다시 적용됩니다. 이어하기(--resume, --continue, /resume)한 세션은 보통 기록에 저장된 모델을 그대로 씁니다.
별칭과 effort
자주 쓰는 별칭은 sonnet(일상적인 코딩), opus(복잡한 추론), haiku(단순한 작업)입니다. 뒤에 [1m]을 붙인 sonnet[1m], opus[1m]은 100만 토큰 컨텍스트 창 변형입니다. opusplan은 플랜 모드에서는 opus를, 실행할 때는 sonnet을 씁니다. default는 덮어쓴 설정을 지우고 계정의 기본값으로 돌아갑니다.
별칭이 가리키는 버전은 제공자와 Claude Code 버전에 따라 다릅니다. Anthropic API 기준으로 opus는 Opus 5.5, sonnet은 Sonnet 5.5, haiku는 Haiku 5.5입니다. 특정 버전에 고정하려면 claude-opus-5-5 같은 전체 이름을 쓰거나 ANTHROPIC_DEFAULT_OPUS_MODEL 등을 설정합니다.
/effort로 생각 강도를 조절합니다. low, medium, high, xhigh, max가 있고 모델마다 지원하는 범위가 다릅니다. /effort auto는 저장한 값을 지웁니다. max는 환경 변수로 설정하지 않으면 현재 세션에만 적용됩니다. /model 선택창에서도 좌우 화살표로 effort를 조절할 수 있습니다.
/model /model sonnet /model opus[1m] /effort high claude --model opus
서브에이전트와의 관계
서브에이전트는 기본적으로 세션 모델을 이어받습니다. 비용 문서는 Opus로 전환하면 이를 이어받는 서브에이전트에도 적용된다고 설명합니다. 단순한 서브에이전트 작업에는 설정에서 model: haiku처럼 지정하거나, CLAUDE_CODE_SUBAGENT_MODEL 환경 변수로 기본 모델을 정할 수 있습니다.
구독 플랜의 세션·주간 한도에 걸렸을 때는 /model로 모델을 바꿔도 소용이 없습니다. 이 한도는 모든 모델에 공통입니다. 다만 "Opus limit"처럼 특정 모델 계열의 한도 메시지라면 다른 계열로 바꾸면 계속 쓸 수 있습니다.
실제 예시
단순한 문구 수정과 파일 이동 작업인데 가장 큰 모델이 기본으로 돌고 있을 때
/model sonnet
바로 Sonnet으로 전환되고, 이 선택이 새 세션의 기본값으로도 저장됩니다. 이번 세션만 바꾸고 싶었다면 선택창에서 s 키를 누르는 쪽이 맞습니다.
큰 구조 변경은 어려운 모델로 계획하고, 코드 작성은 가벼운 모델로 하고 싶을 때
/model opusplan
플랜 모드에서는 opus가, 계획을 승인한 뒤 실행 단계에서는 sonnet이 쓰입니다. 모델을 직접 번갈아 바꾸지 않아도 됩니다.
한 번만 깊게 따져보게 하고 싶지만 세션 설정은 건드리고 싶지 않을 때
프롬프트에 ultrathink 를 포함해 입력
공식 문서에 따르면 그 한 번의 턴에만 더 깊은 추론을 요청하고, 세션의 effort 설정은 바뀌지 않습니다.
흔한 실수와 쓰지 말아야 할 때
- /model이 이번 세션에만 적용된다고 생각하는 것. 기본 동작은 새 세션의 기본값으로도 저장입니다. 일시적으로만 쓰려면 선택창에서 s 키를 쓰세요.
- 프로젝트 설정에 model이 있는데 /model로 바꾼 것이 다음 실행에 유지되지 않는다고 놀라는 것. 프로젝트와 관리형 설정이 저장한 선택보다 우선합니다.
- 사용 한도에 걸렸을 때 모델만 바꾸면 해결된다고 믿는 것. 세션·주간 한도는 모델 공통입니다.
- 모든 작업에 가장 큰 모델과 높은 effort를 쓰는 것. 비용 문서는 Sonnet이 대부분의 코딩 작업을 잘 처리하고 Opus는 복잡한 설계나 다단계 추론에 아껴 쓰라고 권합니다.
- 별칭의 버전이 고정이라고 믿는 것. 별칭은 Claude Code 버전과 제공자에 따라 가리키는 모델이 바뀝니다. 재현이 중요하면 전체 이름으로 고정하세요.
자주 묻는 질문
/model로 바꾼 모델이 다음 세션에도 유지되나요?
네. /model은 선택을 새 세션의 기본값으로 저장합니다. 이번 세션에만 적용하려면 선택창에서 s 키를 누르세요. 프로젝트나 관리형 설정이 있으면 그쪽이 우선합니다.
지금 어떤 모델을 쓰는지 어디서 보나요?
상태 표시줄(status line)을 설정해 두었다면 거기서, 아니면 /status에서 계정 정보와 함께 확인할 수 있습니다.
opusplan은 무슨 뜻인가요?
플랜 모드에서는 opus를, 실행 단계에서는 sonnet을 쓰는 별칭입니다.
2026-10-30 공식 문서와 대조함. 출처: Claude Code 문서: Model configuration, Claude Code 문서: Commands, Claude Code 문서: Manage costs effectively. 작성 원칙