CoreCode를 더 알뜰하게
Claude 모델 선택하기
Claude Code는 Opus, Sonnet, Haiku, Fable 계열을 쓸 수 있습니다. 알맞은 모델을 고르면 같은 작업의 비용을 절반으로 줄일 수 있고, 잘못 고르면 비싸거나 계속 틀립니다. 여기 나오는 모델 설명과 가격 관계는 Anthropic의 모델 설정 가이드와 공식 가격을 따랐습니다.
이 페이지는 Claude만 다룹니다. CoreCode가 함께 제공하는 GPT, Gemini, Grok 모델은 지원 모델에 있습니다.
- 평소 코딩은 Sonnet 5.5, 복잡한 추론과 아키텍처는 Opus 5.5, 단순한 작업은 Haiku 5.5, 가장 어렵고 긴 작업에만 Fable 5.1을 쓰세요.
- 공식 가격 기준으로 Opus 5.5는 Sonnet 5.5의 2배, Fable 5.1은 5배입니다. Haiku 5.5는 Sonnet의 20분의 1이지만 프롬프트가 100,000토큰을 넘으면 4분의 1로 올라갑니다.
opusplan은 plan 모드에서 Opus를 쓰고 실행할 때 Sonnet으로 바꿉니다.- 5.5 모델의 기본 노력 수준은
medium이며/effort로 바꿉니다. 높을수록 느리고 비용이 더 듭니다. - 모델은 작업을 시작할 때 고르세요. 도중에 바꾸면 다음 턴에 컨텍스트 전체가 쓰기 가격으로 캐시에 다시 기록됩니다.
계열별 용도
| 별칭 | 현재 모델 | 용도 |
|---|---|---|
sonnet | Sonnet 5.5 | 평소 코딩: 버그 수정, 테스트 작성, 명세가 분명한 기능 구현 |
opus | Opus 5.5 | 복잡한 추론: 아키텍처, 여러 파일에 걸친 리팩터링, Sonnet이 계속 틀리는 문제 |
haiku | Haiku 5.5 | 단순하고 빠른 작업 |
fable | Fable 5.1 | 가장 어렵고 오래 걸리는 작업 |
opusplan | Opus + Sonnet | plan 모드에서는 Opus가 계획을 세우고, 이후 Sonnet이 코드를 작성 |
별칭은 시간이 지나며 새 버전을 가리키게 됩니다. 고정하려면 claude-opus-5-5 같은 전체 모델 이름을 쓰거나 ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL 등을 설정하세요.
각 모델의 전체 사양, 가격, 이전 세대와의 차이는 Claude Fable 5.1, Claude Opus 5.5, Claude Sonnet 5.5에 있습니다.
가격 비교
Sonnet 5.5를 1로 한 공식 가격의 상대값입니다. CoreCode의 가격은 요금표에 있으며 비율은 같습니다.
| 모델 | 입력 및 출력 가격 | 캐시 읽기(자체 입력 가격 대비) |
|---|---|---|
| Haiku 5.5 | 1/20, 프롬프트가 100,000토큰을 넘으면 1/4 | 0.1배 |
| Sonnet 5.5 | 1 | 0.05배 |
| Opus 5.5 | 2배 | 0.05배 |
| Fable 5.1 | 5배 | 0.025배 |
Haiku의 긴 컨텍스트 가격에 유의하세요. Claude Code 세션은 조금만 지나도 턴마다 100,000토큰이 넘는 컨텍스트를 보내기 쉽고, 그러면 Haiku는 기본 가격의 5배가 됩니다. Haiku는 긴 세션보다 짧은 작업, 서브에이전트, 스크립트의 일회성 호출에 더 알맞습니다.
고르는 방법
- Sonnet으로 시작하세요. 대부분의 코딩을 잘 처리하며 가격은 Opus의 절반입니다.
- 막히면 Opus로 바꾸세요. Sonnet이 두세 번 틀리거나 여러 모듈에 걸친 설계라면 Opus를 쓰세요. Opus로 한 번에 맞추는 편이 Sonnet으로 다시 작업하는 것보다 낫습니다.
opusplan으로 둘 다 얻으세요. plan 모드(Shift+Tab)에서 Opus가 계획을 확정하게 하면 실행은 Sonnet이 맡습니다.- Fable은 정말 어려운 작업에 아껴 두세요. Sonnet의 5배라서 긴 작업에서는 금세 쌓입니다.
Claude Code의 기본 모델은 계정 유형에 따라 다르며, Anthropic 가이드는 Anthropic API에서 Opus 5.5라고 안내합니다. 어떤 모델인지 모르겠다면 /status나 /model을 실행하세요. 기본값을 Sonnet으로 하려면 전환과 고정을 참고하세요.
노력 수준
노력 수준(effort)은 모델이 단계마다 얼마나 깊이 생각할지 정합니다. 낮으면 단순한 작업에 빠르고 저렴하고, 높으면 어려운 문제를 더 깊이 생각하지만 느리고 토큰을 더 씁니다. Opus 5.5, Sonnet 5.5, Haiku 5.5는 low, medium, high, xhigh, max를 지원하며 기본값은 medium입니다.
- 세션에서
/effort를 실행하세요. 확인하면 해당 모델의 기본값으로 저장됩니다. max는CLAUDE_CODE_EFFORT_LEVEL환경 변수로 설정하지 않는 한 현재 세션에만 적용됩니다.claude --effort high로 시작할 수도 있습니다.
모델 전환과 고정
| 방법 | 효과 |
|---|---|
세션에서 /model | 모델을 고르면 이후 세션이 그 모델로 시작 |
claude --model sonnet | 이번 실행에만 적용 |
settings.json의 "model": "sonnet" | 모든 세션의 기본값이 Sonnet |
ANTHROPIC_DEFAULT_OPUS_MODEL 등 | 별칭을 특정 버전으로 고정 |
새 모델에는 최신 Claude Code가 필요합니다. Opus 5.5는 v2.1.280부터, Sonnet 5.5는 v2.1.284부터, Haiku 5.5는 v2.1.293부터입니다. "does not support this model"이 나오면 claude update를 실행하세요.
세션 도중 전환이 캐시에 미치는 영향
프롬프트 캐시는 모델별입니다. 세션 중간에 모델을 바꾸면 새 모델은 이전 캐시를 읽지 못합니다. 다음 턴에 컨텍스트 전체가 쓰기 가격으로 다시 기록되고 눈에 띄게 느려집니다(Anthropic의 Claude Code 캐싱 가이드 참고). 그러므로 다음과 같이 하세요.
- 작업을 시작할 때 모델을 고르고 그 모델로 작업을 끝내세요.
- 꼭 바꿔야 한다면 바꾼 뒤 상당한 분량의 작업을 이어서 재기록 비용을 분산하거나, 먼저
/compact로 다시 기록할 양을 줄이세요.
캐싱에 대해서는 캐싱과 과금과 Claude Code 요금 저렴하게 쓰기에서 더 볼 수 있습니다.
릴레이를 거쳐도 선택한 모델이 맞나요?
Anthropic 가이드는 분명히 말합니다. ANTHROPIC_BASE_URL은 요청을 보낼 곳을 바꿀 뿐, 어떤 모델이 답하는지를 바꾸지 않습니다. CoreCode에서 Opus를 고르면 요청은 Opus로 갑니다. 직접 확인하려면 콘솔의 사용 로그에서 요청별 모델과 가격을 보거나, 검증 스크립트로 업스트림이 Anthropic인지 확인하세요.
FAQ
Opus는 Sonnet보다 얼마나 더 비싼가요?
공식 가격 기준으로 Opus 5.5의 입력과 출력은 Sonnet 5.5의 2배이며 캐시 읽기 배율은 같습니다. CoreCode의 가격은 요금표에 있습니다.
Haiku가 가장 저렴한데 왜 전부 Haiku로 하지 않나요?
성능 때문입니다. Haiku는 복잡한 작업에서 더 자주 틀리고, 다시 작업하는 비용이 더 큽니다. 또 긴 컨텍스트에서는 프롬프트가 100,000토큰을 넘으면 Haiku는 5배 비싸지는데, 긴 Claude Code 세션은 쉽게 그 길이에 이릅니다.
opusplan이 무엇인가요?
plan 모드에서는 Opus로 추론과 설계를 하고, 이후 Sonnet으로 바꿔 코드를 작성하는 모델 설정입니다. /model opusplan으로 켭니다.
노력 수준은 높을수록 좋은가요?
아닙니다. 높을수록 깊이 생각하지만 느리고 토큰을 더 씁니다. 단순한 작업에는 기본값 medium이나 low로도 충분하니, 어려운 문제에서만 올리세요.