Claude Code에서 모델을 변경하는 방법
claude --model claude-opus-5 # for this session
/model # inside a session: pick from a menu
/model claude-sonnet-5 # or name it등급별 재정의
Claude Code는 Sonnet, Opus, Haiku라는 등급을 기준으로 동작하며, 각 등급을 구체적인 모델 ID에 매핑합니다. 환경 변수로 이 매핑을 재정의하면 버전을 고정하거나 게이트웨이에서 특정 등급을 다른 모델로 라우팅할 수 있습니다:
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5Haiku 등급은 겉보기보다 중요합니다. Claude Code가 가벼운 내부 작업에 사용하므로, 저렴한 모델로 지정하면 모든 세션에서 비용을 줄일 수 있습니다.
Claude Code 모델 목록: 이 게이트웨이가 제공하는 모든 ID
| 모델 ID | 유형 |
|---|---|
claude-3-5-haiku-20241022 | 기본 모델 |
claude-3-5-sonnet-20240620 | 기본 모델 |
claude-3-5-sonnet-20241022 | 기본 모델 |
claude-3-7-sonnet-20250219 | 기본 모델 |
claude-fable-5 | 기본 모델 |
claude-fable-5-1 | 기본 모델 |
claude-haiku-4-5 | 기본 모델 |
claude-haiku-4-5-20251001 | 기본 모델 |
claude-opus-4-1-20250805 | 기본 모델 |
claude-opus-4-20250514 | 기본 모델 |
claude-opus-4-5 | 기본 모델 |
claude-opus-4-5-20251101 | 기본 모델 |
claude-opus-4-6 | 기본 모델 |
claude-opus-4-7 | 기본 모델 |
claude-opus-4-8 | 기본 모델 |
claude-opus-5 | 기본 모델 |
claude-opus-5-5 | 기본 모델 |
claude-sonnet-4 | 기본 모델 |
claude-sonnet-4-20250514 | 기본 모델 |
claude-sonnet-4-5 | 기본 모델 |
claude-sonnet-4-5-20250929 | 기본 모델 |
claude-sonnet-4-6 | 기본 모델 |
claude-sonnet-5 | 기본 모델 |
claude-sonnet-5-5 | 기본 모델 |
claude-opus-4-6 (1M) | 긴 컨텍스트 |
claude-opus-4-6-thinking | 확장 사고 |
claude-opus-4-7 (1M) | 긴 컨텍스트 |
claude-opus-4-7-thinking | 확장 사고 |
claude-opus-4-8 (1M) | 긴 컨텍스트 |
claude-opus-4-8-thinking | 확장 사고 |
claude-opus-5 (1M) | 긴 컨텍스트 |
claude-opus-5-thinking | 확장 사고 |
claude-sonnet-4-6 (1M) | 긴 컨텍스트 |
다음이 포함된 변형은 (1M) 긴 컨텍스트 등급을 사용합니다; -thinking 변형은 확장 사고를 활성화합니다. 위의 모든 ID는 다음에서 사용할 수 있으며 --model, /model ANTHROPIC_BASE_URL을 https://aiprimetech.io.로 설정하면 등급별 변수에서도 사용할 수 있습니다.
선택 기준
- Sonnet 등급 — 기본값인 데에는 이유가 있습니다. 코딩에 강하며, 가격은 Opus의 삼분의 일입니다.
- Opus 등급 — 아키텍처 결정, 어려운 디버깅, 잘못된 단계의 대가가 큰 장시간 자율 실행에 적합합니다.
- Haiku 등급 — 분류, 요약, 하위 에이전트의 사전 탐색에 적합하며, 주된 편집 반복 작업용은 아닙니다.
- 직감적으로 선택한 것보다 한 등급 낮게 시작하고, 실제로 품질이 부족할 때만 /model로 등급을 올리세요.
먼저 무료로 사용해 보세요
신규 계정에는 $5의 무료 API 크레딧이 제공됩니다 사용할 코드: CLAUDECODE — Sonnet으로 저녁 한나절 Claude Code를 사용하기에 충분합니다. 이후에는 액면가의 7.69231배에 해당하는 크레딧이 제공됩니다.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key자주 묻는 질문
Claude Code의 기본 모델은 무엇인가요?
현재 Sonnet 등급 모델입니다. --model, /model 또는 ANTHROPIC_DEFAULT_SONNET_MODEL 변수로 변경할 수 있습니다.
Claude Code에서 Opus를 사용할 수 있나요?
네. claude --model에 Opus ID를 지정하거나, 세션 도중 /model을 사용하세요. 토큰당 비용은 Sonnet의 약 2.5배로 예상하면 됩니다.
Claude Code에서 모델이 지원되지 않는다고 표시되는 이유는 무엇인가요?
현재 연결된 엔드포인트가 해당 ID를 제공하지 않기 때문입니다. 해당 엔드포인트의 /v1/models를 확인하거나, 이 게이트웨이의 경우 위 목록을 확인하세요.
게이트웨이에서 Claude Code 실행하기
동일한 모델, 환경 변수 두 개, 액면가의 7.69231배에 해당하는 크레딧 또는 정액 무제한 요금제를 이용하세요. 신규 계정: 코드 CLAUDECODE로 $5의 무료 API 크레딧을 받으세요.
API 키 발급받기 무제한 요금제 보기AI Prime Tech는 독립 API 게이트웨이이며 Anthropic과 제휴 관계가 없고, Anthropic의 보증이나 후원을 받지 않습니다. “Claude”와 “Claude Code”는 Anthropic의 상표입니다. 여기에 설명된 Claude Code 기능은 작성 당시 Anthropic의 공개 문서를 기준으로 하며 자주 변경됩니다. 이 페이지의 가격과 모델 목록은 이 게이트웨이의 실시간 설정에서 가져옵니다.