🤖 02. 모델선택

모델 선택은 “더 좋은 모델 하나를 고르는 일”이 아니라, 작업 단계에 맞게 모델을 배치하는 일에 가깝다. 초안 생성, 설계 검토, 최종 검수는 필요한 사고 깊이가 다르기 때문이다. 이 글은 Claude Code 공식 모델 설정 기준으로, 실무에서 바로 쓰는 선택 전략을 정리한다.

flowchart LR
  A[작업 시작] --> B{작업 성격}
  B -->|빠른 초안/반복| C[sonnet]
  B -->|복잡 설계/반박 검증| D[opus]
  C --> E{리스크 높음?}
  E -->|예| D
  E -->|아니오| F[완료]
  D --> G[최종 정리]

🧠 칠판 치트시트

• sonnet: 빠른 생산
• opus: 복잡 추론/검증
• opusplan: 계획은 opus, 실행은 sonnet 자동 전환
• 모델은 /model, --model, ANTHROPIC_MODEL, settings 순으로 제어 가능

한 줄 결론

처음부터 한 모델만 고집하지 말고, Sonnet으로 생산 → Opus로 검증 2패스 루틴을 기본값으로 두면 속도와 품질을 동시에 잡기 쉽다.

1) Claude Code 모델 별칭을 먼저 이해하기

공식 문서 기준으로 자주 쓰는 별칭은 아래 4개다.
모델 설정 문서: https://code.claude.com/docs/en/model-config

• default: 계정 유형에 따라 권장 기본 모델
• sonnet: 일상 코딩/문서 작업의 균형형
• opus: 복잡한 추론, 설계, 반박 검증
• haiku: 간단·빠른 작업
• opusplan: 계획 단계는 opus, 실행 단계는 sonnet 자동 전환

관측: 별칭(alias)은 최신 버전을 가리키므로, 특정 버전 고정이 필요하면 전체 모델명(예: claude-opus-4-6)을 명시하는 방식이 더 안전하다.

2) 모델을 바꾸는 4가지 방법 (우선순위)

1. 세션 중 변경: /model <alias|name>
2. 시작 시 지정: claude --model <alias|name>
3. 환경변수: ANTHROPIC_MODEL=<alias|name>
4. settings.json: "model": "..."

바로 쓰는 예시 코드

# 세션 시작부터 opus로
claude --model opus

/model sonnet

export ANTHROPIC_MODEL=sonnet
claude

3) 초보자용 실전 기준: 언제 sonnet, 언제 opus?

sonnet 우선이 좋은 경우

• 빠른 초안 작성
• 반복 수정이 많은 실무 문서
• 구현 방향이 이미 명확한 작업

opus 우선이 좋은 경우

• 설계 대안 비교가 필요한 과제
• 오류 비용이 큰 의사결정 문서
• 반대 관점 검증이 필요한 상황

가장 안정적인 운영 패턴

• 1차 생성: sonnet
• 2차 반박·누락 검증: opus
• 3차 길이/톤 정리: sonnet 또는 opus(업무 중요도 기준)

4) opusplan을 써야 하는 순간

계획과 실행이 한 세션에서 섞이는 작업이면 opusplan이 유용하다.

• 설계 단계에서 깊게 생각하고
• 실제 구현 단계에서 속도를 회복하는 방식

즉, “고민은 깊게, 실행은 빠르게”를 자동화해 준다.

5) 노력도(effort)와 비용·속도 균형

공식 문서에서 Opus 계열은 effort level(low/medium/high)을 지원한다.

• 단순 작업: low/medium
• 복잡 설계/검증: high(기본)

환경변수 예시:

export CLAUDE_CODE_EFFORT_LEVEL=medium

관측: effort를 무조건 높이면 좋다는 뜻이 아니다. 단순 작업에서 high는 대기시간/비용만 늘릴 수 있다.

6) 10분 재현 실습 (Sonnet → Opus 2패스)

Step 1) Sonnet으로 구조 생성 (3분)

아래 초안을 5개 항목 구조로 재작성해줘.
각 항목은 핵심 문장 2개만 작성.
 
[원문 초안]
(300~700자)

Step 2) Opus로 반박 검증 (4분)

위 초안의 논리 비약/근거 부족/반대 가능 지점을
'문제-근거-수정안' 형식으로 최소 2건 제시해줘.

Step 3) 최종본 정리 (3분)

검수 반영 최종본을 700자 이내로 정리하고,
마지막 줄에 '남은 리스크 1개'를 써줘.

7) 현장형 미니 사례

사례 A (속도 개선)

모든 작업을 opus로 처리하던 팀이, 초안 단계만 sonnet으로 바꿨다. 초안 생성 시간이 짧아지고, opus 사용 구간이 “진짜 검증”에 집중되면서 전체 리드타임이 감소했다.

사례 B (품질 개선)

모든 작업을 sonnet으로 끝내던 팀에서, 대외 문서는 opus 검증 단계를 추가했다. 대안 누락/논리 충돌 피드백이 초기에 잡혀 수정 비용이 줄었다.

8) 자주 하는 실수 4가지

1. 모델 선택 기준 없이 감으로 전환
2. 모든 과업을 한 모델로만 처리
3. 고위험 문서에서 검증 단계를 생략
4. 모델 설정을 팀 문서에 남기지 않아 재현 실패

9) 20분 도입 루틴

1. 오늘 작업 1건을 “속도형/깊이형”으로 분류
2. sonnet 1차 초안 생성
3. opus 검증 1회 실행
4. 최종본에서 변경점 3줄 기록
5. 팀 노트에 “모델 선택 이유 1문장” 남기기

완료 기준

• 같은 루틴을 다음 작업에도 재현 가능
• 시간/오류/재작업 중 1개 이상 개선 확인

다음 차시

• 🛠️ 03. 운영스택 Skills·Memory·Teams

다음 읽기

• 🤖 01. 시작 실전워크플로우
• 🤖 08. 비용 운영 베스트프랙티스
• 🤖 09. insights 명령어 정리

생성형 AI 활용 고지

이 문서는 Claude Code 공식 문서를 기반으로 생성형 AI를 활용해 정리했으며, 최종 공개 전 사람이 검토·보정했다.