클로드코드 14-model-config

1. 모델 설정

참고: Claude Code 모델 선택, alias, effort level, extended thinking 설정

1.1. 사용 가능한 모델

1.1.1. 모델 Alias

- Alias: 동작
- default: 계정 유형에 따른 권장 모델
- best: 사용 가능한 가장 강력한 모델 (현재 opus)
- sonnet: 일상 코딩 작업용 최신 Sonnet
- opus: 복잡한 추론 작업용 최신 Opus
- haiku: 간단한 작업용 빠른 Haiku
- sonnet[1m]: 100만 토큰 컨텍스트의 Sonnet
- opus[1m]: 100만 토큰 컨텍스트의 Opus
- opusplan: Plan 모드에서는 opus, 실행 모드에서는 sonnet

참고: Anthropic API와 Claude Platform on AWS에서 opus는 Opus 4.7, sonnet은 Sonnet 4.6을 가리킨다. Bedrock, Vertex, Foundry에서는 opus는 Opus 4.6, sonnet은 Sonnet 4.5를 가리킨다.

1.2. 모델 설정 방법

우선순위 순:

세션 중: /model <alias|name>
시작 시: claude --model <alias|name>
환경 변수: ANTHROPIC_MODEL=<alias|name>
설정 파일: model 필드

# Opus로 시작
claude --model opus

# 세션 중 Sonnet으로 전환
/model sonnet

1.3. 기본 모델 동작

- 계정 유형: 기본 모델
- Max, Team Premium: Opus 4.7
- Pro, Team Standard, Enterprise, API: Sonnet 4.6
- Bedrock, Vertex, Foundry: Sonnet 4.5

1.4. 모델 선택 제한

Enterprise 관리자는 availableModels로 선택 가능 모델을 제한할 수 있다.

{
  "availableModels": ["sonnet", "haiku"]
}

참고: default 옵션은 availableModels의 영향을 받지 않고 항상 사용 가능하다.

1.5. Effort Level

적응형 추론 예산을 제어한다. 낮을수록 빠르고 저렴하며, 높을수록 깊은 추론을 제공한다.

1.5.1. 지원 모델 및 레벨

- 모델: 지원 레벨
- Opus 4.7: low, medium, high, xhigh, max
- Opus 4.6, Sonnet 4.6: low, medium, high, max

1.5.2. 레벨 선택

- 레벨: 사용 시점
- low: 짧고 범위가 좁은 지연 시간 민감 작업
- medium: 비용 민감 작업
- high: 지능 민감 작업의 최소 권장값
- xhigh: 대부분의 코딩/에이전틱 작업에 최적. Opus 4.7 기본값
- max: 까다로운 작업에 유용하나 과도한 사고에 취약. 세션당만 적용

1.5.3. 설정 방법

- /effort - 인터랙티브 슬라이더
- /effort high - 직접 설정
- /effort auto - 모델 기본값으로 리셋
- --effort 플래그
- CLAUDE_CODE_EFFORT_LEVEL 환경 변수
- effortLevel 설정
- Skill/subagent frontmatter의 effort 필드

1.5.4. ultrathink

프롬프트에 ultrathink를 포함하면 해당 턴만 더 깊은 추론을 요청한다. 세션 effort 설정은 변경되지 않는다.

1.6. Extended Thinking

Claude가 응답 전에 수행하는 단계별 추론. 터미널에서 회색 이탤릭체로 표시.

1.6.1. 제어 방법

- 방법: 설정
- 현재 세션 토글: Option+T (macOS) / Alt+T (Windows/Linux)
- 전역 기본값: /config에서 thinking mode 토글 (alwaysThinkingEnabled)
- 강제 비활성화: MAX_THINKING_TOKENS=0

참고: Thinking 출력은 기본적으로 접혀 있다. Ctrl+O로 상세 모드를 토글해 볼 수 있다.

1.7. Extended Context (1M)

Opus 4.7, Opus 4.6, Sonnet 4.6는 100만 토큰 컨텍스트 윈도우를 지원한다.

- 플랜: Opus 1M: Sonnet 1M
- Max, Team, Enterprise: 구독에 포함: Extra usage 필요
- Pro: Extra usage 필요: Extra usage 필요
- API / pay-as-you-go: 전체 접근: 전체 접근

1.7.1. 사용 방법

/model opus[1m]
/model sonnet[1m]

참고: CLAUDE_CODE_DISABLE_1M_CONTEXT=1로 1M 컨텍스트를 완전히 비활성화할 수 있다.

1.8. 환경 변수

- 변수: 설명
- ANTHROPIC_DEFAULT_OPUS_MODEL: opus alias가 가리킬 모델
- ANTHROPIC_DEFAULT_SONNET_MODEL: sonnet alias가 가리킬 모델
- ANTHROPIC_DEFAULT_HAIKU_MODEL: haiku alias가 가리킬 모델
- CLAUDE_CODE_SUBAGENT_MODEL: Subagent용 모델
- ANTHROPIC_CUSTOM_MODEL_OPTION: /model 선택지에 커스텀 모델 추가

참고: Bedrock, Vertex, Foundry 배포 시 버전 고정을 위해 위 환경 변수를 사용하는 것이 권장된다.