Claude Code
Claude Code에서 Sonnet과 Opus 전환
Claude Code에서 /model, model aliases, 전체 model IDs, provider differences 및 cost impact를 알아보세요.
짧은 답변
Claude Code에서 Sonnet, Opus 또는 다른 model을 전환할 때는 지원되는 /model entry point 또는 official model configuration path를 우선 사용하세요.
Model aliases, 전체 model IDs 및 provider mappings는 항상 동일하지 않습니다. web UI에 표시되는 marketing name이 API-recognized model ID인 것은 아닙니다.
third-party gateway를 사용한다면 해당 gateway 또는 provider documentation에 표시된 model ID를 사용하세요.
이 내용이 필요한 경우
- 저렴한 model과 강력한 model 사이를 전환하고 싶음
- Sonnet / Opus / Haiku aliases가 보이지만 입력할 값을 모름
- third-party Base URL 또는 model gateway를 사용함
- Claude Code token cost를 제어하고 싶음
- model not found가 표시되거나 model selection이 적용되지 않음
model names의 세 가지 계층
| 계층 | 의미 |
|---|---|
| Display name | UI에 표시되는 사람이 읽기 쉬운 name |
| Alias | tool 안의 short name 또는 shortcut |
| Model ID | API가 실제로 인식하는 identifier |
성공한 request에서 중요한 것은 current provider가 Model ID를 인식하는지 여부입니다.
권장 방법
- current provider가 지원하는 models를 확인하세요.
- Claude Code
/model또는 official model configuration path를 사용하세요. - third-party gateway를 사용한다면 해당 model plaza에서 available model ID를 복사하세요.
- model choice와 cost를 함께 고려하세요.
- model names를 직접 추측하지 마세요.
BetterToken 정보
모델 광장에서 정확한 Model ID를 복사하세요. 설정에서 Model ID를 변경하고 Claude Code를 다시 시작하세요. 세션 중에는 /model YOUR_MODEL_ID로 전환하세요.
Model choice는 quality, speed 및 cost에 영향을 줍니다. usage records는 models 간 actual consumption을 비교하는 데 도움이 됩니다.
관련 문서
- Claude Code가 많은 tokens를 사용하는 이유
- Claude Code에서 API Key와 Base URL 구성
- Claude Code permissions와 hooks
- OpenAI-compatible API와 Anthropic-compatible API 비교

