Claude Code의 기본 모델은 Sonnet 입니다. 구체적으로는 사용 중인 공급자의 최신 Sonnet 릴리스(2026년 중반 기준 Anthropic API에서는 Sonnet 5)입니다. Sonnet은 빠르고, 대부분의 코딩 작업을 잘 처리하며, 긴 세션에서 합리적인 비용을 유지합니다. 아무것도 변경하지 않았다면 바로 이 모델을 사용하고 있는 것입니다.
모델을 변경하는 명령어는 하나입니다: 세션 내에서 /model opus를 입력하거나, 시작할 때 claude --model opus를 입력하면 됩니다. 이 가이드의 나머지 부분에서는 각 모델을 실제로 전환할 가치가 있는 경우, 축약 별칭이 공급자별로 어떻게 해석되는지, 그리고 Novita AI의 엔드포인트를 사용하여 더 다양한 오픈 가중치 모델을 낮은 토큰당 비용으로 이용하는 방법을 다룹니다.
Claude Code의 기본 모델은 무엇인가요?
모델을 지정하지 않고 Claude Code를 실행하면 **sonnet 별칭 ** 으로 시작하며, 이는 사용 중인 공급자의 최신 Sonnet 릴리스로 해석됩니다. Anthropic API(기본 엔드포인트)의 경우 2026년 중반 기준 Claude Sonnet 5 를 의미합니다. 무료 및 Pro 요금제 사용자 모두 기본적으로 Sonnet 5를 사용합니다.
그 이유는 간단합니다. Sonnet은 일상적인 코딩 작업에 가장 적합한 속도와 기능의 균형을 제공합니다. 파일 편집, 다단계 리팩터링, 테스트 생성 및 대부분의 저장소 규모 작업을 Opus의 추가 지연 시간이나 비용 없이 처리합니다. 대부분의 세션에서 더 무거운 모델로 전환해도 결과가 눈에 띄게 좋아지지 않습니다.
조직에서 Claude Code 관리 콘솔에 조직 전체 기본 모델을 설정한 경우, 해당 설정이 시스템 기본값을 재정의하며 다음 세션 실행 시 적용됩니다. /model 또는 --model 플래그를 사용하여 세션별로 여전히 재정의할 수 있습니다.
사용 가능한 모델 및 별칭
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 |
100만 토큰 | $10/백만 토큰 | $50/백만 토큰 |
| Claude Opus 4.8 | claude-opus-4-8 |
100만 토큰 | $5/백만 토큰 | $25/백만 토큰 |
| Claude Sonnet 5 | claude-sonnet-5 |
100만 토큰 | $2/백만 토큰* | $10/백만 토큰* |
| Claude Haiku 4.5 | claude-haiku-4-5-20251001 |
20만 토큰 | $1/백만 토큰 | $5/백만 토큰 |
*Sonnet 5는 2026년 8월 31일까지 도입 특가 적용; 표준 요금은 백만 토큰당 $3/$15입니다.
모든 모델은 Haiku 4.5(최대 20만 토큰)를 제외하고 100만 토큰 컨텍스트 윈도우를 제공합니다. 대부분의 코딩 작업에서 컨텍스트 윈도우 크기는 전체 저장소를 로드하거나 매우 긴 에이전트 세션을 실행할 때만 결정적인 요소가 됩니다.
Claude Code에서 모델을 변경하는 방법
모델을 구성하는 방법은 우선순위에 따라 네 가지가 있습니다.
1. 세션 중: /model
인수 없이 /model을 입력하면 대화형 선택기가 열립니다. /model <별칭>을 입력하면 즉시 전환됩니다.
/model opus
/model sonnet
/model haiku
/model fable
Claude Code v2.1.153부터 /model은 선택 사항을 향후 세션의 기본값으로 저장합니다. 현재 세션에만 전환하려면 선택기에서 Enter 대신 s를 누르세요. /model <별칭>을 직접 입력하면 선택 사항이 저장됩니다(Enter와 동일).
2. 실행 시: --model 플래그
Claude Code를 시작할 때 --model을 전달하면 해당 세션에만 선택이 적용됩니다.
claude --model opus
claude --model haiku
claude --model claude-sonnet-5 # 전체 모델 ID, 특정 버전 고정
이것은 저장된 기본값에 영향을 주지 않으며 다음 실행에 지속되지 않습니다.
3. 환경 변수: ANTHROPIC_MODEL
ANTHROPIC_MODEL을 설정하면 셸 세션 또는 스크립트 기간 동안 모델이 적용됩니다.
export ANTHROPIC_MODEL="opus"
--model과 마찬가지로 세션 범위로 적용되며 설정 파일에 기록되지 않습니다.
4. 설정 파일 (영구 기본값)
영구 기본값을 설정하려면 Claude Code 설정 파일(보통 ~/.claude/settings.json)에 model 필드를 추가하세요.
{
"model": "opus"
}
이것은 해당 기기에서 Claude Code를 실행할 때마다 적용되며, --model 플래그 또는 ANTHROPIC_MODEL 환경 변수로 재정의되지 않는 한 유효합니다.
별칭별 환경 변수
opus 별칭이 특정 버전으로 해석되도록 하려면 ANTHROPIC_DEFAULT_OPUS_MODEL을 설정하세요. 다른 모델군에도 동일한 패턴이 적용됩니다.
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-8"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5-20251001"
export ANTHROPIC_DEFAULT_FABLE_MODEL="claude-fable-5"
이것은 모든 곳에 전체 모델 ID를 고정하지 않고도 재현 가능한 모델 해석이 필요한 CI/CD 또는 팀 설정에서 유용합니다.
코딩에 적합한 모델 선택하기
필요한 모델 계층은 복잡성뿐만 아니라 작업 유형에 따라 더 많이 달라집니다.
Sonnet(기본값)을 유지해야 하는 경우:
- 일상적인 코딩 작업 — 기능 구현, 테스트 작성, 리팩터링
- diff를 검토하고 후속 질문을 하는 반복 세션
- 코드베이스가 컨텍스트 윈도우에 맞는 대부분의 다중 파일 편집
- 속도가 중요한 경우(Sonnet은 Opus보다 눈에 띄게 빠르게 응답)
Sonnet의 주요 한계는 진정으로 모호한 아키텍처 질문에 대한 추론 깊이입니다. 대안을 평가하기보다는 첫 번째 합리적인 접근 방식을 선택하는 경향이 있습니다. 트레이드오프를 잘못 선택했을 때 상당한 리팩터링 시간이 소요되는 결정의 경우 Opus로 업그레이드할 가치가 있습니다.
Opus로 전환해야 하는 경우:
- 문제가 명확하지 않은 근본 원인 디버깅
- 아키텍처 결정: 디자인 패턴 선택, 리팩터링 전략 평가, 기술 부채가 문제가 될 지점 식별
- Opus가 작업 기억에 더 많은 컨텍스트를 유지해야 하는 대규모 코드베이스 분석
- 누적된 컨텍스트 저하가 요인이 되는 장시간 자율 세션
Opus 4.8은 토큰당 Sonnet 5보다 2.5배 더 비싸고 속도도 느립니다. 짧은 작업의 경우 추론 품질의 차이가 비용을 정당화하지 못하는 경우가 많습니다. opusplan 별칭은 실용적인 중간 지점입니다. 더 깊은 추론이 효과를 발휘하는 계획 단계에서는 Opus를 사용하고, 처리량이 더 중요한 구현 단계에서는 Sonnet으로 전환합니다.
Haiku를 사용해야 하는 경우:
- 코드 포맷팅, 주석 정리, 간단한 변수 이름 변경
- 최소한의 변경에 대해 빠른 응답이 필요한 작업
- 토큰 비용이 가장 중요한 대량 스크립트 사용 사례
Haiku 4.5는 가장 빠른 모델이자 백만 토큰당 $1/$5로 가장 저렴하지만, 다단계 추론이나 복잡한 코드베이스에서는 Sonnet이나 Opus를 따라잡지 못합니다.
Fable 5를 사용해야 하는 경우:
- 장애 디버깅 및 사고 조사
- 모델이 행동하기 전에 조사하도록 하려는 길고 개방적인 에이전트 실행
- 일반적으로 작업을 여러 세션으로 나누어야 하는 모호한 문제
Fable 5는 대부분의 코딩 세션에 필요하지 않기 때문에 기본값이 아닙니다. 속도가 느리고 Opus의 두 배 비용이 듭니다. 진정으로 복잡하고 지속적인 작업에서 그 가치를 발휘합니다. 자체 출력을 더 철저히 검증하고, 도구 호출 시퀀스를 놓치지 않고 처리하며, 수정 프롬프트가 필요한 결정을 더 적게 내립니다. 일반적인 기능 작업에는 과잉입니다.
Bedrock, Vertex 및 기타 공급자의 모델 선택
별칭은 사용 중인 API 공급자에 따라 다르게 해석됩니다. Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry를 통해 Claude Code를 라우팅하는 경우 별칭 해석이 기본적으로 더 오래된 버전입니다.
| 공급자 | opus 별칭 해석 |
sonnet 별칭 해석 |
|---|---|---|
| Anthropic API (기본값) | Opus 4.8 | Sonnet 5 |
| AWS의 Claude Platform | 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 호환 엔드포인트로 지정하면 DeepSeek, Qwen, GLM, Kimi 및 MiniMax 변형을 포함한 오픈 가중치 모델을 사용하면서 Claude Code의 에이전트 워크플로를 그대로 유지할 수 있습니다.
이는 다음과 같은 경우에 유용합니다.
- 특정 오픈 가중치 모델(Qwen3-Coder, GLM-4.7, MiniMax M2.7)을 실제 코드베이스에서 테스트해보고 싶을 때
- 토큰당 비용이 제약 조건이고 대량의 에이전트 세션을 실행 중일 때
- API 지출을 결정하기 전에 자체 작업에서 모델 품질을 벤치마킹할 때
설정
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 (명령 프롬프트):
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를 확인하세요. 모델 가용성과 이름은 변경될 수 있습니다.
자주 묻는 질문
Claude Code의 기본 모델은 무엇인가요?
Sonnet입니다. 구체적으로는 API 공급자의 최신 Sonnet 릴리스입니다. Anthropic API에서는 2026년 중반 기준 Claude Sonnet 5입니다. 조직에서 조직 전체 기본값을 설정한 경우 해당 값이 우선합니다.
Claude Code에서 모델을 어떻게 전환하나요?
가장 빠른 방법은 활성 세션 중 /model <별칭>을 입력하는 것입니다. 영구적으로 설정하려면 설정 파일(~/.claude/settings.json)에 "model": "opus"(또는 원하는 별칭)를 추가하세요. 일회성 세션 재정의를 위해 실행 시 --model을 사용하세요.
opusplan 별칭은 무엇을 하나요?
Claude Code의 계획 단계에서는 Opus를 사용하고 실행 단계에서는 Sonnet으로 전환합니다. 이는 아키텍처 결정에 대해 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가 아닌 값으로 업데이트하세요.
추천 문서
- Novita AI를 통해 Claude Code에서 MiniMax M2.7 사용하기
- Claude Code CLI 문서: 설정, 슬래시 명령어 및 LLM API 통합
- Claude Code에서 Qwen3-Coder-480B-A35B-Instruct 사용하기: 실용 가이드
출처 확인: 2026년 7월 10일 — Claude Code 모델 구성 문서, Anthropic 모델 개요, Novita AI LLM API.
