Claude Code의 기본 모델은 Sonnet 입니다. 구체적으로는 사용 중인 프로바이더에서 제공하는 최신 Sonnet 릴리스(2026년 중반 기준 Anthropic API의 Sonnet 5)입니다. Sonnet은 빠르고 대부분의 코딩 작업을 잘 처리하며 긴 세션에서도 합리적인 비용을 유지합니다. 아무것도 변경하지 않았다면 바로 이 모델을 사용하고 있는 것입니다.
모델 변경은 한 번의 명령으로 끝납니다. 세션 내에서 /model opus를 입력하거나, 실행 시 claude --model opus를 사용하면 됩니다. 이 가이드의 나머지 부분에서는 각 모델로 전환할 만한 시점, 각기 다른 프로바이더에서 축약 별칭이 어떤 모델로 해석되는지, 그리고 Novita AI 엔드포인트를 사용해 토큰당 비용을 낮추면서 더 다양한 오픈 가중치 모델에 액세스하는 방법을 다룹니다.
모델 빠르게 변경하기
단순히 Claude Code 모델을 변경하려면 다음 중 하나를 사용하세요.
- Claude Code에서
/model을 실행하고sonnet,opus,haiku또는 다른 사용 가능한 별칭을 선택합니다. claude --model opus로 일회성 세션을 시작합니다.- 새 모델을 유지하려면
~/.claude/settings.json에"model": "opus"를 설정합니다.
대부분의 사용자에게는 /model sonnet, /model opus, claude --model opus만 알면 충분합니다. ANTHROPIC_MODEL은 여전히 스크립트와 CI에서 유용하지만, 일반적인 모델 전환에 프로바이더별 별칭 환경 변수는 필요하지 않습니다.
Claude Code의 기본 모델은 무엇인가요?
모델을 지정하지 않고 Claude Code를 실행하면 **sonnet 별칭 ** 으로 시작되며, 이는 사용 중인 프로바이더의 최신 Sonnet 릴리스로 해석됩니다. 기본 엔드포인트인 Anthropic API에서는 2026년 중반 기준 Claude Sonnet 5 입니다. 무료 및 Pro 플랜 사용자 모두 기본적으로 Sonnet 5를 사용하게 됩니다.
그 이유는 간단합니다. Sonnet은 일상적인 코딩 작업에 있어 속도와 성능의 최상의 균형을 제공합니다. 파일 편집, 다단계 리팩터링, 테스트 생성, 대부분의 저장소 규모 작업을 Opus가 가져오는 추가 지연 시간이나 비용 없이 처리합니다. 대부분의 세션에서 더 무거운 모델로 전환해도 의미 있는 결과 차이는 나지 않습니다.
조직에서 Claude Code 관리 콘솔에 조직 기본 모델을 설정했다면 해당 값이 시스템 기본값을 덮어쓰며, 다음 세션 시작 시 적용됩니다. 세션별로는 /model 또는 --model 플래그로 여전히 재정의할 수 있습니다. 기본값 동작을 결정하는 프로젝트 규칙은 CLAUDE.md의 프로젝트 규칙을 참조하세요.
사용 가능한 모델과 별칭
Claude Code는 일상적인 모델 선택에 전체 모델 ID 대신 별칭 을 사용합니다. sonnet 같은 별칭은 항상 사용 중인 프로바이더의 권장 버전을 가리키므로 새 모델이 출시될 때마다 구성을 업데이트할 필요가 없습니다.
| 별칭 | 선택되는 모델 | 가장 적합한 경우 |
|---|---|---|
sonnet |
최신 Sonnet (Anthropic API의 Sonnet 5) | 기본값 — 대부분의 코딩 작업에 빠르고 뛰어나며 효율적 |
opus |
최신 Opus (Anthropic API의 Opus 4.8) | 복잡한 아키텍처 추론, 대규모 코드베이스 분석 |
haiku |
최신 Haiku (Haiku 4.5) | 속도가 깊이보다 중요한 단순하고 빠른 작업 |
fable |
Claude Fable 5 | 장기 실행 자율 세션, 모호하거나 개방형 작업 |
best |
사용 가능한 경우 Fable 5, 그렇지 않으면 최신 Opus | 수동 지정 없이 가장 높은 가용 성능 |
opusplan |
계획에는 Opus, 실행에는 Sonnet | 매 단계 Opus 비용을 지불하지 않고 아키텍처에 대한 Opus의 추론을 활용 |
sonnet[1m] |
1M 토큰 컨텍스트 창의 Sonnet | 매우 긴 세션 또는 확장된 컨텍스트가 필요한 대규모 코드베이스 |
opus[1m] |
1M 토큰 컨텍스트 창의 Opus | Opus 추론이 필요한 복잡한 장문 컨텍스트 작업 |
default |
모든 재정의를 해제하고 계정 기본값으로 복귀 | 다른 모델을 테스트한 후 시스템 기본값으로 재설정 |
별칭은 시간이 지나면서 업데이트됩니다. 재현성을 위해 또는 모델 업데이트 후 예기치 않은 동작을 피하기 위해 특정 릴리스를 고정하려면 전체 모델 ID를 대신 사용하세요.
claude --model claude-sonnet-5
claude --model claude-opus-4-8
현재 Claude 모델 (Anthropic API)
| 모델 | API ID | 컨텍스트 | 입력 비용 | 출력 비용 |
|---|---|---|---|---|
| Claude Fable 5 | claude-fable-5 |
1M 토큰 | $10/MTok | $50/MTok |
| Claude Opus 4.8 | claude-opus-4-8 |
1M 토큰 | $5/MTok | $25/MTok |
| Claude Sonnet 5 | claude-sonnet-5 |
1M 토큰 | $2/MTok* | $10/MTok* |
| Claude Haiku 4.5 | claude-haiku-4-5-20251001 |
200k 토큰 | $1/MTok | $5/MTok |
*Sonnet 5는 2026년 8월 31일까지 할인 출시 가격이 적용되며, 이후 표준 요금은 MTok당 $3/$15입니다.
모든 모델은 100만 토큰 컨텍스트 창을 갖고 있으며, Haiku 4.5만 200k로 제한됩니다. 대부분의 코딩 작업에서 컨텍스트 창 크기는 전체 저장소를 로드하거나 매우 긴 에이전틱 세션을 실행할 때만 결정 요인이 됩니다.
Claude Code에서 모델 변경하기
모델을 구성하는 방법은 우선순위 순으로 네 가지가 있습니다.
1. 세션 중: /model
인자 없이 /model을 입력하면 대화형 선택기가 열립니다. /model <alias>를 입력하면 즉시 전환됩니다.
/model opus
/model sonnet
/model haiku
/model fable
Claude Code v2.1.153부터 /model은 선택한 모델을 향후 세션의 기본값으로 저장합니다. 현재 세션에서만 전환하려면 선택기에서 Enter 대신 s를 누르세요. /model <alias>를 직접 입력하면 (Enter와 동일하게) 선택 사항이 저장됩니다.
2. 실행 시: --model 플래그
Claude Code를 시작할 때 --model을 전달하면 해당 세션에만 선택이 적용됩니다.
claude --model opus
claude --model haiku
claude --model claude-sonnet-5 # full model ID, pins to a specific version
이 방법은 저장된 기본값에 영향을 주지 않으며 다음 실행에는 유지되지 않습니다.
3. 환경 변수: ANTHROPIC_MODEL
ANTHROPIC_MODEL을 설정하면 셸 세션 또는 스크립트 동안 모델이 적용됩니다.
export ANTHROPIC_MODEL="opus"
--model과 마찬가지로 세션 범위로 적용되며 설정 파일에 기록되지 않습니다.
4. 설정 파일 (영구 기본값)
영구 기본값을 설정하려면 Claude Code 설정 파일(일반적으로 ~/.claude/settings.json)에 model 필드를 추가하세요.
{
"model": "opus"
}
이 설정은 --model 플래그 또는 ANTHROPIC_MODEL 환경 변수로 재정의되지 않는 한 해당 머신에서 Claude Code를 실행할 때마다 적용됩니다.
코딩에 적합한 모델 선택하기
필요한 모델 등급은 단순한 복잡도보다 작업 유형에 더 크게 좌우됩니다.
다음 작업에는 Sonnet(기본값)을 사용하세요:
- 일상적인 코딩 작업 — 기능 구현, 테스트 작성, 리팩터링
- diff를 검토하고 후속 질문을 하는 반복적인 세션
- 코드베이스가 컨텍스트 창에 들어오는 대부분의 다중 파일 편집
- 속도가 중요한 경우 (Sonnet은 Opus보다 눈에 띄게 빠르게 응답)
Sonnet의 주요 한계는 정말로 모호한 아키텍처 질문에 대한 추론 깊이입니다. 대안을 평가하기보다 첫 번째로 그럴듯한 접근 방식을 선택하는 경향이 있습니다. 트레이드오프를 잘못 판단했을 때 리팩터링 비용이 크게 드는 결정이라면 Opus로 업그레이드할 가치가 있습니다.
다음 작업에는 Opus로 전환하세요:
- 문제가 명확하지 않은 근본 원인 디버깅
- 아키텍처 결정: 디자인 패턴 선택, 리팩터링 전략 평가, 기술 부채가 문제가 될 지점 파악
- 작업 메모리에 더 많은 컨텍스트를 유지해야 하는 대규모 코드베이스 분석
- 누적된 컨텍스트 저하가 요인으로 작용하는 수시간 자율 세션
Opus 4.8은 Sonnet 5보다 토큰당 2.5배 비싸고 속도도 느립니다. 짧은 작업의 경우 추론 품질 차이가 비용을 정당화하지 못하는 경우가 많습니다. opusplan 별칭은 실용적인 중간 지점입니다. 계획 단계에서는 Opus를 사용하고(더 깊은 추론이 효과적인 단계), 구현 단계에서는 Sonnet으로 전환합니다(처리량이 더 중요한 단계).
다음 작업에는 Haiku를 사용하세요:
- 코드 포맷팅, 주석 정리, 간단한 변수 이름 변경
- 최소한의 변경에 빠른 응답이 필요한 작업
- 토큰 비용이 가장 중요한 대량 스크립트 사용 사례
Haiku 4.5는 가장 빠르고 MTok당 $1/$5로 가장 저렴한 모델이지만, 다단계 추론이나 복잡한 코드베이스에서는 Sonnet이나 Opus를 따라잡지 못합니다. 이러한 트레이드오프의 팀 정책 측면에 대해서는 비용에 민감한 팀을 위한 Claude Code 자동 모드를 읽어보세요.
다음 작업에는 Fable 5를 사용하세요:
- 장애 디버깅 및 장애 조사
- 행동하기 전에 모델이 조사하도록 하려는 길고 개방형 에이전틱 실행
- 보통 여러 세션으로 나누어야 하는 모호한 문제
Fable 5는 대부분의 코딩 세션에서 필요하지 않기 때문에 기본값이 아닙니다. 속도가 더 느리고 Opus보다 두 배 비쌉니다. 진정으로 복잡하고 지속적인 작업에서 그 가치를 발휘합니다. 자체 출력을 더 철저히 검증하고, 맥락을 잃지 않고 도구 호출 시퀀스를 처리하며, 수정 프롬프트가 필요한 결정을 더 적게 내립니다. 일반적인 기능 작업에는 과한 선택입니다.
Bedrock, Vertex 및 기타 프로바이더에서의 모델 선택
별칭이 해석되는 방식은 사용 중인 API 프로바이더에 따라 다릅니다. Claude Code를 Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry를 통해 라우팅하는 경우 별칭은 기본적으로 이전 모델로 해석됩니다.
| 프로바이더 | opus 별칭이 해석되는 모델 |
sonnet 별칭이 해석되는 모델 |
|---|---|---|
| Anthropic API (기본값) | Opus 4.8 | Sonnet 5 |
| Claude Platform on AWS | Opus 4.7 | Sonnet 4.6 |
| Amazon Bedrock | Opus 4.6 | Sonnet 4.5 |
| Google Cloud Agent Platform | Opus 4.6 | Sonnet 4.5 |
| Microsoft Foundry | Opus 4.6 | Sonnet 4.5 |
Bedrock, Vertex 또는 Foundry에서 최신 모델을 사용하려면 전체 모델 ID를 명시적으로 사용하거나 ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL 환경 변수를 원하는 버전의 프로바이더별 모델 ARN 또는 배포 이름으로 설정하세요.
Novita AI로 더 많은 모델에 액세스하는 방법
Claude Code는 ANTHROPIC_BASE_URL을 읽어 요청을 보낼 API 엔드포인트를 결정합니다. 이 값을 Novita AI의 Anthropic 호환 엔드포인트로 지정하면 Claude Code의 에이전틱 워크플로를 유지하면서 DeepSeek, Qwen, GLM, Kimi, MiniMax 변형을 포함한 오픈 가중치 모델을 사용할 수 있습니다.
다음과 같은 경우에 유용합니다.
- 실제 코드베이스에서 특정 오픈 가중치 모델(Qwen3-Coder, GLM-4.7, MiniMax M2.7)을 시험해보고 싶은 경우
- 토큰당 비용이 제약이고 대량 에이전틱 세션을 실행하는 경우
- API 비용을 지출하기 전에 자체 작업에서 모델 품질을 벤치마킹하는 경우
설정
- novita.ai에 가입하여 무료 평가판 크레딧을 받으세요.
- Key Management로 이동하여 새 키를 만들고 복사하세요.
- Claude Code를 실행하기 전에 다음 환경 변수를 설정하세요.
macOS / Linux:
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<your Novita API key>"
export ANTHROPIC_MODEL="minimax/minimax-m2.7"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="minimax/minimax-m2.7"
Windows (Command Prompt):
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<your Novita API key>
set ANTHROPIC_MODEL=minimax/minimax-m2.7
set ANTHROPIC_DEFAULT_HAIKU_MODEL=minimax/minimax-m2.7
Windows (PowerShell):
$env:ANTHROPIC_BASE_URL = "https://api.novita.ai/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "<your Novita API key>"
$env:ANTHROPIC_MODEL = "minimax/minimax-m2.7"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "minimax/minimax-m2.7"
변수를 설정한 후 평소처럼 Claude Code를 실행하세요. /model 선택기는 Anthropic 별칭 목록 대신 구성한 Novita 호스팅 모델을 표시합니다.
ANTHROPIC_BASE_URL과 모델 선택에 관한 참고 사항
ANTHROPIC_BASE_URL은 요청이 어디로 가는지 변경하지, 어떤 Anthropic 모델이 응답할지는 변경하지 않습니다. Novita AI를 가리킬 때 ANTHROPIC_MODEL에 설정하는 모델 이름은 sonnet 또는 opus 같은 Anthropic 별칭이 아니라 Novita 호스팅 모델 ID(예: minimax/minimax-m2.7 또는 deepseek/deepseek-v4-flash)여야 합니다. Anthropic 별칭은 Anthropic 자체 엔드포인트에서만 올바르게 해석됩니다.
Novita AI에서 사용 가능한 대표 모델
| 모델 | Novita 모델 ID | 강점 |
|---|---|---|
| MiniMax M2.7 | minimax/minimax-m2.7 |
에이전틱 도구 호출, 97% 도구 정확도 |
| DeepSeek V4 Flash | deepseek/deepseek-v4-flash |
반복 작업에 빠르고 비용 효율적 |
| Qwen3-Coder 480B | qwen/qwen3-coder-480b-a35b-instruct |
코드 생성, 대규모 컨텍스트 |
| GLM-4.7 | zai-org/glm-4.7 |
코딩 및 에이전틱 작업 |
구성 전에 novita.ai/llm-api에서 현재 모델 목록과 검증된 모델 ID를 확인하세요. 모델 가용성과 이름은 변경될 수 있습니다.
FAQ
Claude Code의 기본 모델은 무엇인가요?
Sonnet입니다. 구체적으로는 사용 중인 API 프로바이더의 최신 Sonnet 릴리스입니다. Anthropic API에서는 2026년 중반 기준 Claude Sonnet 5입니다. 조직에서 조직 전체 기본값을 설정했다면 그 값이 우선합니다.
Claude Code에서 모델을 어떻게 전환하나요?
가장 빠른 방법은 활성 세션 중 /model <alias>를 사용하는 것입니다. 영구적으로 설정하려면 설정 파일 ~/.claude/settings.json에 "model": "opus"(또는 원하는 별칭)를 추가하세요. 1회성 세션 재정의에는 실행 시 --model을 사용하세요.
opusplan 별칭은 무엇을 하나요?
Claude Code의 계획 단계에서는 Opus를 사용하고 실행 단계에서는 Sonnet으로 전환합니다. 이를 통해 구현 중 모든 파일 편집에 Opus 요금을 지불하지 않고도 아키텍처 결정에 Opus의 더 깊은 추론을 활용할 수 있습니다. '무엇을 할지 파악’하는 부분에는 Opus를, '코드를 작성’하는 부분에는 Opus가 필요하지 않은 경우가 자주 있다면 좋은 기본값이 됩니다.
특정 모델 버전을 고정할 수 있나요?
네. 별칭 대신 전체 모델 ID를 전달하세요: claude --model claude-sonnet-5 또는 claude --model claude-opus-4-8. 영구적으로 고정하려면 전체 ID를 설정 파일에 추가하거나 환경에 ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5를 설정하세요.
모델이 Claude Code의 도구와 기능에 영향을 주나요?
아니요. 모든 모델은 동일한 Claude Code 도구 세트에 액세스할 수 있습니다: 파일 읽기 및 편집, bash 실행, 웹 검색, MCP 등입니다. 모델 등급은 사용 가능한 도구가 아니라 추론 품질에 영향을 줍니다.
프로젝트별로 다른 모델을 사용할 수 있나요?
네. 프로젝트 수준 설정 파일(프로젝트 루트의 .claude/settings.json)에 model 필드를 추가하세요. 그러면 해당 디렉터리에서 시작하는 세션에 대해 사용자 수준 기본값을 재정의합니다. 프로젝트별 .env 파일이나 스크립트에서 ANTHROPIC_MODEL을 사용할 수도 있습니다.
선택한 모델이 더 이상 사용되지 않거나 사용할 수 없으면 어떻게 되나요?
Claude Code는 시작 시 요청한 모델과 대체된 모델을 명시하는 경고를 표시합니다. 세션은 시스템 기본값으로 시작됩니다. 예기치 않은 대체를 방지하려면 현재 권장 별칭으로 전환하거나 설정을 더 이상 사용되지 않는 모델 ID가 아닌 값으로 업데이트하세요.
추천 문서
- Claude Code 라우터: Claude Code에서 대체 모델 및 프로바이더 사용하기
- Claude Sonnet vs Opus: Claude Code에서 어떤 모델이 적합한가?
- Claude Code CLI 문서: 설정, 슬래시 명령, LLM API 통합
출처 확인: 2026년 7월 10일: Claude Code 모델 구성 문서, Anthropic 모델 개요, Novita AI LLM API.
