작성자 메모: Claude Code에서는 Fable의 기본 effort가 Medium이고, API에서 effort를 지정하지 않으면 Fable 5.2의 기본값이 high예요. 이 차이를 설명하고, API 호출에서 두 환경의 사용량을 맞추는 방법을 안내해요.
Claude Code에서 Fable 5.2로 코드를 작성하면 token 소모가 그리 크지 않다고 느끼는 개발자가 많아요. 그런데 같은 모델 ID를 API로 호출하면 비슷한 작업인데도 사용량이 눈에 띄게 늘어나요. 그래서 두 환경에서 서로 다른 모델이 돌아가는 건 아닌지 의심하게 되죠. 결론부터 말씀드릴게요. Claude 앱과 Claude Code의 기본 effort는 Medium이고, Claude API에서 effort를 지정하지 않으면 Fable 5.2의 기본값은 high예요.
서로 다른 모델도, 과금 오류도 아니에요. 같은 파라미터의 기본값이 진입점마다 다를 뿐이에요. Anthropic이 2026-11-09에 올린 발표 글과 Claude 플랫폼의 모델 페이지, Effort 문서에도 이 내용이 명시되어 있어요.
핵심 가치: 이 글을 읽고 나면 Claude Code와 API의 사용량이 왜 다른지 알 수 있어요. 또 API 요청에서 effort를 명시적으로 설정해, 두 환경의 비용을 같은 단계 기준으로 비교하는 방법도 알게 될 거예요.
Claude Code의 Fable 기본값 Medium과 API 기본값 high 핵심 요약
먼저 두 진입점의 차이를 표로 정리해 볼게요. 표의 내용은 모두 공식 발표문, 모델 페이지, Effort 문서에서 가져왔어요.
| 요점 | 설명 | 나에게 미치는 영향 |
|---|---|---|
| Claude Code 기본값 Medium | 공식 발표문에 따르면 Medium effort가 Claude 앱과 Claude Code의 기본값이에요 | Claude Code에서 보이는 사용량은 Medium 단계의 사용량이에요 |
| API 기본값 high | 모델 페이지 비교표에서 Fable 5.2의 Default effort는 high예요. Claude API에서 effort 파라미터의 기본값을 뜻해요 | API 요청에 effort를 쓰지 않으면 high로 실행돼요 |
| 동일한 모델 | 양쪽 모두 Fable 5.2를 호출하고, 차이는 effort 단계뿐이에요 | 사용량 차이를 모델 버전이 달라서 생긴 것으로 오해하면 안 돼요 |
| 선택 가능한 단계 | Fable 5.2는 low, medium, high, xhigh, max를 지원해요 | API에서도 medium을 명시해 Claude Code와 맞출 수 있어요 |
Claude Code와 API에서 Fable 사용량이 다른 이유
effort 파라미터는 모델이 한 작업에 추론과 출력을 얼마나 투입할지 조절해요. 단계가 높을수록 모델은 대체로 더 충분히 생각하고 더 길게 풀어서 답하기 때문에 토큰도 더 많이 쓰는 경향이 있어요. 단계가 낮을수록 더 빠르고 아껴서 결과를 내놓는 경향이 있고요. Claude Code는 일상적인 코딩 상호작용을 위한 도구라서, 효과와 소비 사이의 균형을 맞추려고 기본값을 Medium으로 잡았어요.
Claude API는 개발자가 직접 통합해 쓰는 인터페이스예요. Fable 5.2의 API effort 기본값은 high라서, 요청 본문에 effort 파라미터가 없으면 서버는 high로 처리해요. Claude Code에서 API로 넘어올 때 base_url과 모델 ID만 바꾸고 effort를 넣지 않는 경우가 많은데, 이러면 실제 실행 단계가 Medium에서 high로 올라가요.
Medium 기본값에 대한 공식 설명
Anthropic은 2026-11-09 발표문에서 기본 단계인 Medium에서 Fable 5.2가 어려운 작업을 끝내는 데 5.1보다 적은 토큰을 쓴다고 밝혔어요. 이는 공식 자체 보고이고, 제3자가 재현한 결론은 아니에요. 이 문장은 Medium 단계의 효율을 보여 주지만, high가 Medium보다 몇 배나 더 소비하는지에 대한 통일된 배수는 제시하지 않아요.
그러니 “high는 Medium보다 몇 배 비싸다”를 고정된 숫자로 받아들이면 안 돼요. 작업의 복잡도, 컨텍스트 길이, 출력 길이에 따라 실제 차이가 달라지기 때문에, 가장 믿을 만한 방법은 내 작업에서 medium과 high를 각각 돌려 보고 usage 필드를 비교하는 거예요.
Fable 5.2의 effort 단계와 Claude Code 기본값 Medium 비교
아래 표는 Fable 5.2가 지원하는 다섯 가지 단계와, 두 가지 진입 경로의 기본값과의 관계를 정리한 거예요. 각 단계의 성향은 effort 파라미터의 일반적인 의미이고, 실제 동작은 여러분의 작업에서 돌아오는 결과를 기준으로 판단하세요.
| effort 단계 | 특정 경로의 기본값 여부 | 일반적인 성향 | 적합한 작업 |
|---|---|---|---|
low |
아니요 | 더 빠르고 저렴하며, 추론 투입이 적음 | 간단한 문장 다듬기, 형식 변환, 분류 |
medium |
Claude 앱과 Claude Code의 기본값 | 효과와 소비의 균형 | 일상적인 코딩, 일반 질의응답, 일괄 처리 |
high |
Claude API 기본값(생략 시) | 추론이 더 충분하고, 소비도 더 많아지는 경향 | 복잡한 디버깅, 아키텍처 분석 |
xhigh |
아니요 | high보다 더 많이 투입 | 난도가 높은 다단계 추론 |
max |
아니요 | 최대 투입 | 품질 요구가 매우 높은 소수의 핵심 작업 |
이 표에서 핵심은 가운데 두 행이에요. Claude Code에서 쌓인 사용량에 대한 감각은 medium 기준이고, API에서 파라미터를 생략하면 high로 실행돼요. Claude Code와 같은 경험과 비용을 재현하는 게 목표라면, API 요청에 medium을 명시적으로 지정해야 해요.
API에서 Fable 5.2를 Claude Code 기본값 Medium에 맞추는 방법
아래 단계에는 코드 블록이 없으니 순서대로 확인해 보세요. 요청 본문에서 effort 필드를 정확히 어떻게 쓰는지는 Claude 플랫폼의 Effort 문서와 사용하는 플랫폼의 API 문서를 기준으로 하세요.
1단계: 모델 ID와 접속 주소 확인
- APIYI의 모델 가격 페이지 docs.apiyi.com/models 에서 Fable 5.2의 모델 ID를 확인하세요:
claude-fable-5-2 - API 주소는 OpenAI 호환 base_url을 사용해요:
https://api.apiyi.com/v1 - 같은 API 키 하나로 호출할 수 있어서, Claude용 계정을 따로 만들 필요가 없어요
2단계: effort 파라미터 명시하기
- Claude Code와 동일하게 맞추고 싶다면: effort를
medium으로 설정하세요 - 더 강한 추론이 필요하다면:
high로 설정하세요. 생략했을 때의 기본값이기도 해요 - 단순한 변환 작업이라면:
low로 소비를 줄여 볼 수 있어요 - 기본값에 의존하지 마세요. 그러면 로그에서 이번 요청이 어떤 단계로 실행됐는지 알 수 없어요
3단계: usage 필드로 두 단계의 사용량 비교하기
- 같은 작업 묶음을 골라
medium과high로 각각 한 번씩 실행하세요 - 매번 반환되는 입력 토큰, 출력 토큰, 캐시 읽기 토큰을 기록하세요
- 단가로 비용을 환산해서, 고정 배수를 그대로 적용하지 말고 여러분의 업무에서 나타나는 실제 차이를 구하세요
🚀 빠른 시작: effort 단계가 사용량에 미치는 영향을 먼저 확인해 보고 싶다면, APIYI(apiyi.com)에서 신규 가입자용 무료 테스트 크레딧으로 medium과 high 비교 테스트를 돌려 보세요. 이 플랫폼은 키 하나로 Claude, OpenAI, Gemini 등의 모델을 모두 지원해서, 나중에 다른 모델로 비교할 때도 접속 방식을 바꿀 필요가 없어요.
Fable 5.2 API 가격과 effort 사용량의 관계
effort 자체는 단가를 바꾸지 않아요. 바뀌는 것은 요청 한 번에 소비하는 토큰 수예요. 그래서 비용 차이는 토큰 수 차이에 단가를 곱한 값이 돼요. 아래 표는 APIYI 가격 페이지의 2026-11-11 기준 데이터예요.
| 모델 ID | 입력 | 출력 | 캐시 읽기 | 그룹 | 데이터 날짜 |
|---|---|---|---|---|---|
claude-fable-5-2 |
$8 | $40 | $0.2 | ClaudeCode 포함 | 2026-11-11 |
가격 단위와 최신 수치는 APIYI 가격 페이지 docs.apiyi.com/models에 실시간으로 표시된 내용을 기준으로 확인해 주세요. 표를 보면 출력 단가가 입력의 5배예요. effort 단계를 높이면 모델이 추론과 답변을 더 많이 생성하는 경우가 많은데, 출력 토큰의 단가가 가장 높기 때문에 high 단계의 비용 증가분은 주로 출력 부분에서 나와요.
캐시 읽기 단가는 입력보다 훨씬 낮아요. 요청에 반복되는 시스템 프롬프트나 고정 컨텍스트가 많다면, 캐시를 켜는 것만으로 입력 쪽 비용을 눈에 띄게 줄일 수 있어요. 다만 캐시는 입력 부분에만 영향을 주기 때문에, effort를 높여서 늘어나는 출력 비용까지 상쇄하지는 못해요.
Fable 5.2 비용을 제대로 추정하는 방법
비용을 추정할 때 “high가 Medium보다 몇 배 비싸다”라는 말 한마디로 예산을 계산하면 안 돼요. 공식 자료에서 밝힌 것은 두 진입 경로의 기본값, 그리고 Medium 단계에서 Fable 5.2가 5.1보다 토큰을 덜 쓴다는 공식 자체 보고 결론뿐이에요. high와 Medium 사이의 통일된 환산 비율은 제시되지 않았어요.
더 안전한 방법은 대표성 있는 실제 작업 20~50건을 골라 두 단계에서 각각 돌려 보고, 평균 입력·출력·캐시 읽기 토큰을 집계하는 거예요. 그런 다음 위 표의 단가로 작업당 평균 비용을 계산하면, 여러분의 업무에 딱 맞는 데이터를 얻을 수 있어요.
Fable 5.2 사용량이 맞지 않을 때 점검 체크리스트
API 사용량이 Claude Code와 크게 차이 난다면, 아래 표를 보면서 항목별로 하나씩 점검해 보세요.
| 현상 | 가능한 원인 | 해결 방법 |
|---|---|---|
| API 사용량이 Claude Code보다 눈에 띄게 많음 | 요청에 effort를 지정하지 않아 기본값인 high로 실행됨 | 명시적으로 medium으로 설정한 뒤 다시 비교 |
| effort를 지정했는데 사용량이 그대로임 | 필드 위치나 이름이 API 규격과 맞지 않아 무시됨 | Effort 문서와 플랫폼 API 문서를 보고 필드 작성법을 확인 |
| 요청에서 파라미터 오류가 반환됨 | effort 값이 지원 범위를 벗어남 | low, medium, high, xhigh, max만 사용 |
| 모델 이름 오류가 발생함 | 모델 ID 철자가 잘못됨 | APIYI 가격 페이지에서 claude-fable-5-2가 맞는지 확인 |
| 양쪽 모두 medium인데도 사용량이 다름 | 컨텍스트 길이, 도구 호출, 캐시 적중 여부가 다름 | 입력 내용을 고정한 뒤 비교하고, 캐시 읽기 토큰은 따로 확인 |
마지막 항목은 놓치기 쉬워요. Claude Code는 코딩하는 동안 파일 내용과 대화 기록을 자동으로 함께 보내지만, 직접 작성한 API 요청에는 그만큼의 컨텍스트가 들어 있지 않을 수 있거든요. effort가 같더라도 입력 토큰은 달라질 수 있으니, 비교할 때는 입력을 고정해 두는 게 좋아요.
자주 묻는 질문 FAQ
Q1: Claude Code의 Fable과 API의 Fable 5.2는 같은 모델인가요?
같은 모델이에요. 차이는 effort 파라미터의 기본값에 있어요. Claude 앱과 Claude Code는 기본값이 Medium이고, Claude API에서 effort를 지정하지 않으면 Fable 5.2는 기본적으로 high로 동작해요.
Q2: API에서 effort를 지정하지 않으면 어떻게 되나요?
서버가 Claude API에서 Fable 5.2의 기본값인 high로 실행해요. Claude Code에서 API로 바꾼 뒤 사용량이 늘었다고 느끼는 분이 많은 것도 이 때문이에요.
Q3: high는 Medium보다 몇 배 더 비싼가요?
공식적으로 제시된 통일된 배수는 없어요. effort는 단가를 바꾸지 않고 토큰 소비량에만 영향을 주는데, 그 차이는 작업 난이도, 컨텍스트, 출력 길이에 따라 달라져요. 직접 하는 작업에서 두 단계를 각각 실행해 보고 usage 데이터로 계산해 보시길 권해요.
Q4: Fable 5.2는 어떤 effort 단계를 지원하나요?
Effort 문서에 따르면 Fable 5.2는 `low`, `medium`, `high`, `xhigh`, `max`의 다섯 단계를 지원해요. 일상적인 코딩에는 보통 `medium`이면 충분하고, 복잡한 추론이 필요할 때 더 높은 단계를 고려하면 돼요.
Q5: API로 Fable 5.2를 호출하면서 effort를 설정하려면 어떻게 하나요?
아래 세 단계를 따라 하면 돼요.
1. APIYI(apiyi.com)에 가입해서 API 키를 발급받으세요. 신규 사용자에게는 무료 테스트 크레딧이 제공돼요.
2. base_url에는 `https://api.apiyi.com/v1`을, 모델 ID에는 `claude-fable-5-2`를 입력하세요.
3. 요청에 effort를 명시적으로 지정하세요. 필드 작성 방식은 Effort 문서와 플랫폼 API 문서를 기준으로 하세요.
Q6: APIYI에서 Fable 5.2의 가격은 얼마인가요?
2026-11-11 기준 가격 데이터로 `claude-fable-5-2`는 입력 $8, 출력 $40, 캐시 읽기 $0.2이고, 그룹에는 ClaudeCode가 포함돼요. 가격은 바뀔 수 있으니 주문 전에 APIYI 가격 페이지의 실시간 데이터를 확인해 주세요.
Q7: Medium 단계에서 Fable 5.2가 5.1보다 토큰을 덜 쓴다는 결론은 믿을 만한가요?
이건 Anthropic이 2026-11-09 발표문에서 직접 밝힌 내용이고, 어려운 작업 전반의 성능을 설명한 거예요. high와 Medium을 비교한 수치는 제시되지 않았어요. 비용이 중요하다면 역시 직접 하는 작업의 데이터로 검증해 보셔야 해요.
Q8: 모든 API 요청을 medium으로 바꿔야 하나요?
꼭 그렇지는 않아요. Claude Code와 같은 경험과 비용을 재현하고 싶다면 `medium`이면 충분해요. 복잡한 디버깅이나 중요한 분석에는 `high`를 유지하고, 간단한 작업은 `low`로 낮춰도 돼요. 핵심은 기본값에 판단을 맡기지 말고 단계를 명시적으로 지정하는 거예요.
Claude Code에서 Fable 기본값 Medium과 API 기본값 high의 핵심 요약
- 같은 모델, 다른 기본값: Claude Code는 기본값이 Medium이고, API에서 effort를 지정하지 않으면 Fable 5.2는 기본값이 high예요
- 파라미터를 비우면 high로 실행돼요: API로 옮기면서 effort를 함께 넘기지 않은 경우가 사용량이 늘어나는 가장 흔한 원인이에요
- 다섯 단계 선택 가능: Fable 5.2는 low, medium, high, xhigh, max를 지원해요
- 고정 배율은 없어요: 공식적으로 high와 Medium 사이의 통일된 환산 비율은 제공하지 않아요. 직접 작업 데이터로 계산해야 해요
- 비용은 출력이 좌우해요: 출력 단가가 입력의 5배라서, effort를 높였을 때 늘어나는 비용은 대부분 출력 토큰에서 나와요
- 시작하기 쉬워요: APIYI의 OpenAI 호환 인터페이스와 모델 ID
claude-fable-5-2로 단계별 비교를 바로 해볼 수 있어요
정리
Claude Code에서 Fable의 기본값은 Medium이고, API에서는 effort를 비우면 high로 동작해요. 다음 세 가지만 기억하세요.
- 기본값이 달라요: Claude 앱과 Claude Code는 기본값이 Medium이고, Claude API에서 Fable 5.2의 기본값은 high예요
- effort를 명시적으로 설정하세요: Claude Code와 동일하게 맞추고 싶다면 API 요청에
medium을 직접 지정하세요 - 데이터로 비용을 추정하세요: 고정 배율을 그대로 적용하지 말고, usage 필드와 단가로 실제 차이를 계산하세요
다음 단계로, 실제 작업을 한 묶음 골라 medium과 high로 각각 실행해 보고 그 결과를 비용 모델에 반영해 보세요. 먼저 APIYI(apiyi.com)의 무료 크레딧으로 비교 테스트를 마친 뒤, 운영 환경의 기본 단계를 정하면 좋아요.
📚 참고 자료
- Anthropic 발표문: Fable 및 Mythos 5.2 릴리스 노트, 2026-11-09
- 링크:
anthropic.com/claude-fable-and-mythos-5-2 -
설명: Claude 앱과 Claude Code의 기본 단계가 Medium effort인 이유와, Medium에서 5.1보다 토큰을 더 적게 쓴다는 Anthropic의 자체 보고 내용을 확인할 수 있어요
-
Fable 5.2 모델 페이지: 모델 파라미터 비교표
- 링크:
platform.claude.com/docs/en/models/fable-5-2/overview -
설명: Default effort는 high이며, Claude API에서 effort 파라미터의 기본값이에요
-
Effort 문서: effort 파라미터 설명
- 링크:
platform.claude.com/docs/en/build-with-claude/effort -
설명: Fable 5.2가 지원하는 단계와 API 기본값을 안내해요
-
APIYI 모델 가격 페이지: 모델 ID 및 가격
- 링크:
docs.apiyi.com/models - 설명:
claude-fable-5-2의 입력, 출력, 캐시 읽기 가격과 그룹 정보를 확인할 수 있어요. 데이터 기준일은 2026-11-11이에요
작성자: APIYI 기술팀
기술 문의: effort 설정이나 사용량 비교와 관련해 궁금한 점이 있다면 APIYI 공식 홈페이지에서 편하게 문의해 주세요.
