Claude Fable 5.2: Claude Code 설정, API 요금과 Opus 비교
Claude Code 2.1.321 이상과 Messages API에서 Claude Fable 5.2를 사용하고 실제 코드 수정 작업을 검증합니다. effort를 선택하고 토큰 요금과 공개된 작업당 비용을 비교합니다. fast mode 과금과 플랫폼별 차이를 확인하고 thinking, 도구 강제 선택, 대화 기록 이전 과정의 오류를 예방합니다.
목차
effort를 높인 Opus 5.5도 코드 검증을 통과하지 못한다면 Claude Fable 5.2를 시험해 봅니다. 그렇지 않다면 일상적인 작업에는 Opus를 유지합니다. Anthropic의 모델 선택 지침에 따라 Claude Code에서는 medium, API에서는 high로 시작합니다.
effort는 추론의 깊이를 조절하는 설정입니다. 채택된 변경 사항을 완성하는 데 든 비용을 비교해야 합니다. 토큰 단가가 높아도 작업을 끝내는 데 필요한 총비용은 더 낮을 수 있습니다.
Fable 5.2는 2026년 11월 9일에 출시되었으며 API 모델 ID는 claude-fable-5-2입니다. 2026-11-12 기준 모델 사양에 명시된 컨텍스트 창은 1M 토큰이며 최대 출력은 128K 토큰입니다.
Claude Code에서 Fable 5.2를 선택하고 실제 수정 결과 검증하기
Claude Code 2.1.321 이상을 사용하고 전체 모델 ID를 지정합니다. 공식 변경 기록에 따르면 Fable 5.2 지원은 2.1.321에서 추가되었습니다.
설치와 인증을 마친 Claude Code 클라이언트가 필요합니다. 계정이나 제공업체에서도 이 모델의 사용을 허용해야 합니다. 비공개 코드를 보내기 전에 조직에서 Fable에 적용되는 Covered Models 데이터 처리 정책을 승인했는지 확인합니다.
네이티브 설치 방식을 사용했다면 Bash에서 다음 명령을 실행합니다.
claude update
claude --version패키지 관리자로 설치했다면 해당 방식의 업데이트 지침을 따릅니다. 표시되는 버전이 최소 2.1.321인지 확인합니다. 업데이트 명령을 실행했다는 이유만으로 이전 설치가 정상적으로 갱신되었다고 가정하지 않습니다.
진행 중인 세션에서는 다음 명령을 실행합니다.
/model claude-fable-5-2“기본 Fable 모델”이라는 표현이 모든 사용자의 기본 모델을 Fable로 바꾼다는 뜻은 아닙니다. 모델 설정 문서에 따르면 계정 유형별 기본 모델로 지정된 Fable 모델은 없습니다.
기존 작업과 분리해 검증하려면 Bash와 Python 3으로 임시 디렉터리를 만듭니다.
workdir="$(mktemp -d)"
cd "$workdir"
cat > clamp.py <<'PY'
def clamp(value, low, high):
return min(low, max(value, high))
PY
cat > test_clamp.py <<'PY'
from clamp import clamp
assert clamp(-2, 0, 10) == 0
assert clamp(5, 0, 10) == 5
assert clamp(12, 0, 10) == 10
print("3 checks passed")
PY
claude --model claude-fable-5-2 --effort medium이 CLI 옵션은 세션의 모델과 effort를 선택합니다. 작업 전에 /model에서 확인합니다. effort가 다르면 환경 변수 CLAUDE_CODE_EFFORT_LEVEL을 확인합니다. 이 변수는 실행 옵션보다 우선합니다.
Claude Code에 다음 작업을 전달합니다. 테스트 파일은 변경하지 않고 함수를 고친 뒤 검증하며, 하위 에이전트는 사용하지 않도록 지시합니다.
Read clamp.py and test_clamp.py.
Fix clamp.py so all existing assertions pass.
Do not edit test_clamp.py.
Run python3 test_clamp.py and report the exact result.
Do not use subagents.권한 확인 기능은 켜 둡니다. 이 디렉터리의 작업에 필요한 파일 조작과 명령만 승인합니다.
에이전트가 작업을 끝내면 Claude Code를 종료하고 직접 다음 명령을 실행합니다.
python3 test_clamp.py예상 결과는 3 checks passed이며 테스트 파일은 변경되지 않아야 합니다. 패치를 제안하기만 한 상태로는 검증에 성공했다고 볼 수 없습니다. 실제로 수정이 적용되고 테스트를 통과해야 합니다. 이 예제는 도구를 사용하는 경로를 검증할 뿐, 다른 모델보다 Fable이 우수한지 평가하지는 않습니다.
claude-fable-5-2로 첫 API 요청 보내기
먼저 Anthropic의 Messages API에 직접 요청해 모델 동작과 게이트웨이 설정을 구분합니다. 이 예제에는 Bash, --fail-with-body를 지원하는 curl, jq, Anthropic에서 발급한 API 키가 필요합니다.
Console의 API 키 발급 지침에 따라 특정 워크스페이스를 선택하고 본인의 키를 만듭니다. 해당 워크스페이스로 범위가 제한된 키라면 이 예제에서 anthropic-workspace-id를 생략할 수 있습니다. 이 조건은 API 인증 문서에 설명되어 있습니다.
read가 입력을 기다릴 때 키를 붙여 넣고 Enter를 누릅니다.
read -rs ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY동기 요청을 보냅니다.
curl --silent --show-error --fail-with-body \
https://api.anthropic.com/v1/messages \
--header "Authorization: Bearer ${ANTHROPIC_API_KEY}" \
--header "anthropic-version: 2026-10-21" \
--header "content-type: application/json" \
--data '{
"model": "claude-fable-5-2",
"max_tokens": 4096,
"output_config": {
"effort": "high"
},
"messages": [
{
"role": "user",
"content": "Fix this Python function and return the corrected function plus three assertions: def clamp(value, low, high): return min(low, max(value, high))"
}
]
}' \
--output fable-response.json &&
jq '{
model,
stop_reason,
usage,
text: [.content[] | select(.type == "text") | .text]
}' fable-response.json요청은 현재 API 버전 헤더와 문서에 명시된 output_config.effort 필드를 사용합니다. Fable 5.2는 이미 적응형 추론을 사용하므로 thinking은 생략합니다.
응답에 반환된 모델, 비어 있지 않은 텍스트, usage, stop_reason을 확인합니다. 응답이 자연스럽게 끝나면 보통 end_turn이 반환됩니다. max_tokens는 출력이 설정한 한도에 도달했다는 뜻입니다. 응답이 잘렸다고 품질 문제로 단정하기 전에, 중단 사유 안내에 따라 출력 한도를 늘려 확인합니다.
HTTP 요청이 실패하면 저장된 오류를 확인합니다.
jq '.error' fable-response.json이 요청은 코드를 텍스트로 반환합니다. 로컬 파일을 읽거나 assert문을 실행하지는 않습니다. 반환된 코드를 검토한 뒤 실행해야 합니다.
2026-11-12 기준 BetterToken에도 claude-fable-5-2가 등록되어 있습니다. Claude Code 연동에서는 Base URL로 https://bettertoken.ai를 사용합니다. 이 경로의 인증은 별도 지침에 따라 설정합니다. 모델이 등록되어 있다는 사실만으로 모든 effort나 fast mode 매개변수의 지원을 확인할 수는 없습니다.
토큰 요금과 완료한 작업의 비용 비교하기
표준 API 요금에서 Fable 5.2의 토큰 단가는 Fable 5.1보다 낮지만 Opus 5.5의 두 배입니다. 다음은 2026-11-12 기준 Anthropic의 공개 요금이며, 단위는 백만 토큰당 USD입니다.
| 모델, 표준 속도 | 캐시되지 않은 입력 | 출력 |
|---|---|---|
| Claude Fable 5.1 | $10 | $50 |
| Claude Fable 5.2 | $8 | $40 |
| Claude Opus 5.5 | $4 | $20 |
| Claude Sonnet 5.5 | $2 | $10 |
Fable 5.1에서 5.2로 바뀌면서 입력과 출력 요금은 각각 20% 낮아졌습니다. 이는 단가 인하입니다. 세션 전체 청구액이 20% 줄어든다는 보장은 아닙니다.
표준 속도에서 Fable 5.2의 캐시 쓰기 요금은 보관 기간이 5분이면 $10, 1시간이면 $16이며 읽기는 $0.20입니다. 각 요금은 백만 토큰당 금액입니다. 비동기 Batch의 입력/출력 요금은 $4/$20입니다. 대화형 Claude Code 사용에 적용되는 요금과는 다릅니다.
캐시되지 않은 입력 100,000 토큰과 청구 대상 출력 20,000 토큰을 사용한다고 가정한 예상 비용은 다음과 같습니다.
Fable 5.2: 0.1 × $8 + 0.02 × $40 = $1.60
Opus 5.5: 0.1 × $4 + 0.02 × $20 = $0.80이 계산은 표준 속도와 글로벌 요금을 가정합니다. 캐시 작업, 유료 도구, Batch 할인은 포함하지 않으며 적용되는 세금도 제외합니다. 두 모델의 토큰 수를 같게 두었지만 실제 에이전트 세션에서는 다른 경우가 많습니다.
Anthropic의 FrontierCode 2.0 발표는 다른 지표를 비교합니다. Fable 5.2는 High에서 45.3%를 기록했고, Opus 5.5의 최고 점수는 45.5%였습니다. 발표에 따르면 Fable의 작업당 비용은 약 절반이었습니다. 이 비교는 Fable High와 Opus Max를 대상으로 하며 토큰 수나 effort를 동일하게 맞춘 결과가 아닙니다.
Cursor의 현재 CursorBench 4.0 결과는 작업에 따라 결론이 달라지는 이유를 보여 줍니다. Fable 5.2 High는 56.9%에 공개 비용 $9.70이며, Opus 5.5 High는 56.0%에 $3.97입니다. Fable 5.2 Max는 60.0%에 $32.79입니다.
이는 각 평가 주체가 공개한 결과이며 구독 요금이나 실제 사용자의 저장소에서 측정한 값이 아닙니다. Cursor에서 56.9%를 기록한 행은 High입니다. Claude Code의 기본값인 Medium과 다릅니다.
작업당 비용 평가 가이드를 참고해 재시도, 실패한 시도, 에이전트 실행 설정을 모두 비교에 포함합니다.
출력 속도가 중요할 때만 fast mode 켜기
표준 요청이 성공한 뒤 지연 시간에 민감한 작업에서 fast mode를 켭니다. Anthropic이 제시한 것은 최대 2.5배 빠른 토큰 생성 속도입니다. 전체 코딩 작업이 2.5배 빨리 끝난다는 보장은 아닙니다.
Messages API에 직접 요청할 때는 claude-fable-5-2를 유지하고 요청 본문의 최상위에 다음 필드를 추가합니다.
"speed": "fast"fast mode용 베타 헤더는 필요하지 않습니다. 요청이 성공하면 usage.speed가 "fast"인지 확인합니다. 확인 방법은 fast mode API 가이드에 나와 있습니다.
2026-11-12 기준 Fable 5.2 fast mode의 입력/출력 요금은 백만 토큰당 $16/$80입니다. 문서에 명시된 기본 fast mode 한도는 Start, Build, Scale 사용 등급에 적용됩니다.
fast mode의 레이트 제한을 초과하면 API가 retry-after와 함께 429를 반환합니다. 지정된 시간만큼 기다리거나, 명시적으로 speed를 제거하고 표준 속도로 다시 요청합니다.
Claude Code에서는 Fable 5.2를 선택하고 /fast를 실행합니다. 구독 요금제의 fast mode는 포함된 사용량이 남아 있어도 사용 크레딧에서 직접 차감됩니다. 켜기 전에 Claude Code의 요구 사항을 확인합니다.
Google Cloud의 Vertex/Agent Platform 경로에서 fast mode를 쓰려면 Claude Code 2.1.322 이상이 필요합니다. 지원 리전은 global, us, eu입니다. 해당 제공업체의 지침을 따릅니다.
앞의 cURL 설정은 Anthropic의 직접 API용입니다. 다른 클라우드 제공업체의 엔드포인트에 그대로 복사해서 사용하지 않습니다.
이전할 때 발생하는 400 오류 피하기
운영 트래픽을 전환하기 전에 요청 매개변수와 대화 기록을 점검합니다. 항상 켜져 있는 적응형 추론과 도구 강제 선택 제한은 Fable 5.1과 Opus 5.5에도 적용되었습니다. Fable 5.2에서 새로 도입된 제한이 아닙니다.
Fable 5.2 호환성 지침은 다음 오류를 설명합니다.
| 요청 설정 | 결과 | 해결 방법 |
|---|---|---|
thinking: {"type": "enabled"}와 budget_tokens | 400 | thinking을 생략하거나 {"type": "adaptive"}를 사용합니다. 추론 깊이는 effort로 조절합니다. |
thinking: {"type": "disabled"} | 400 | 이 설정을 제거합니다. 적응형 추론은 끌 수 없습니다. |
tool_choice: {"type": "any"} | 400 invalid_request_error | {"type": "auto"}를 사용하고 텍스트 응답이 돌아오는 경우도 처리합니다. |
tool_choice: {"type": "tool", "name": "..."} | 400 invalid_request_error | 강제 선택을 제거하고 애플리케이션에서 도구 선택을 처리합니다. |
도구 인수가 스키마를 따르도록 하려면 지원되는 환경에서 자동 도구 선택과 strict: true를 함께 사용합니다. 엄격 모드는 인수를 제한할 뿐 도구 호출 자체를 강제하지 않습니다. JSON 출력도 다른 선택지입니다.
고객이 관리하는 암호화 키를 사용하는 조직에서는 Fable 5.2의 엄격한 도구 사용과 JSON 출력이 모두 지원되지 않습니다. 이 경우 애플리케이션 코드에서 출력을 검증해야 합니다.
이전 시 중요한 변경 사항은 대화 접두부에 대한 검증이 더 엄격해졌다는 점입니다. Fable 5.2는 모든 계정에 이 검증을 적용합니다. 이전에는 같은 방식의 Fable 5.1 요청이 통과했던 오래된 계정도 포함합니다.
오류 메시지에는 다음 문장이 포함됩니다.
The block is bound to a different conversation.system 프롬프트, tools 또는 이전 대화 내용을 바꾼 뒤 추론 블록을 다시 보내면 이 오류가 발생할 수 있습니다. 같은 요청을 재시도해도 불일치는 해결되지 않습니다.
추론 보존 규칙에 따라 기존 접두부를 변경하지 않고 새 메시지를 끝에 추가합니다. 어시스턴트 응답의 콘텐츠 배열은 받은 그대로 다시 보내야 합니다. 간단한 연동에서는 원래 시스템 프롬프트나 도구 정의를 교체할 때 새 대화를 시작하는 방법을 권장합니다.
computer use나 advisor 도구를 사용하는 애플리케이션은 배포 전에 전체 이전 가이드도 확인해야 합니다.
긴 작업의 effort와 완료 조건 조정하기
추론은 프롬프트 문구가 아니라 effort 설정으로 조절합니다. Anthropic에 따르면 깊이 생각하지 않고 답하라는 요청도 Fable 5.2의 medium 이상에서는 추론을 억제하지 못합니다.
모델별 프롬프트 가이드는 여러 단계로 이루어진 작업이 일찍 끝나는 현상도 설명합니다. 특히 low와 medium에서 더 자주 발생합니다. end_turn 응답은 현재 턴이 끝났다는 뜻입니다. 전체 작업의 완료 여부는 인수 조건 검증으로 판단해야 합니다.
범위가 정해진 저장소 작업에는 완료 조건을 명확히 제시합니다. 다음 프롬프트는 수정과 테스트를 완료하도록 요구합니다. 다만 인증 정보가 없거나, 파괴적인 작업 또는 범위 변경 결정이 필요하면 멈추도록 지시합니다.
Complete the requested change and run the relevant tests.
Do not stop after a plan or a list of remaining steps.
Continue through ordinary implementation failures within the approved scope.
Stop and report the blocker if you need unavailable credentials,
destructive actions, or a decision that changes the requested scope.
Do not start subagents for this trial.긴 코딩 작업에서는 medium 기준 결과와 high를 비교합니다. xhigh는 측정된 개선이 추가 작업량을 정당화할 때만 시도합니다. max는 모델의 성능 한계를 측정하거나 실패 비용이 매우 큰 작업에 남겨 둡니다.
위임도 비용에 영향을 줍니다. Anthropic에 따르면 에이전트 실행 환경에서 위임을 권장하면 Fable은 하위 에이전트에 작업을 적극적으로 맡깁니다. 하위 에이전트가 세션 예산의 상당 부분을 사용할 수도 있습니다. 전체 청구액을 주 모델의 비용으로 판단하기 전에 하위 에이전트의 모델과 사용량을 기록해야 합니다.
일상적인 작업에 사용할 모델 선택하기
범위가 좁고 테스트가 명확한 변경에서는 결과가 요구 사항을 충족하는 한 Sonnet 5.5를 유지합니다. 토큰 단가가 낮으므로 반복적인 수정 작업에서 먼저 시험하기에 적합합니다. 검토 과정에서 놓친 의존성을 발견하거나 수정 시도가 반복되면 더 높은 성능의 모델로 전환해 봅니다.
일반적인 저장소 작업에는 Fable이 측정 가능한 개선을 보이지 않는 한 Opus 5.5를 유지합니다. Opus 선택 가이드에서 다시 전환하고 선택을 유지하는 방법을 확인할 수 있습니다.
effort를 높인 Opus도 잘못 처리하는 어려운 원인 분석, 여러 파일의 변경, 긴 마이그레이션에서 Fable 5.2를 검증합니다. 채택되는 변경 사항이 늘거나 완료까지의 총비용이 개선되어 높은 토큰 단가를 상쇄할 때 Fable을 선택합니다.
설정을 검증한 뒤에는 같은 시작 커밋과 같은 인수 테스트로 모델을 비교합니다. effort, 소요 시간, 캐시 사용량, 하위 에이전트 사용량, 실패한 모든 시도를 기록합니다. 실제 검증을 통과하는 구성 중 비용이 낮은 것을 유지해야 합니다. 벤치마크 점수만으로 이 결정을 대신하지 않습니다.
