Claude Fable 5.2와 Opus 5.5 중 무엇을 써야 할까요? Anthropic의 권장은 이렇습니다. 대부분의 작업은 Opus 5.5로 시작하고, 고난도 추론이나 오래 실행되는 Agent 작업, 또는 Opus 5.5의 effort를 높여도 부족할 때 Fable 5.2로 바꾸라는 것입니다(공식 모델 개요). Fable 5.2의 API 단가는 Opus 5.5의 정확히 2배입니다.
이 글은 비교표로 시작해 Claude Code에서 두 모델을 전환하는 방법, 메인 Agent는 Fable로, 서브 Agent는 Opus로 실행하는 방법, Codex와 Cursor에서 고르는 방법을 다룹니다. 2026년 11월 12일 16:18~16:30(베이징 시간, UTC+8)에 Claude Code 2.1.322와 AICodeWith API Key로 두 모델에 같은 버그 수정 작업을 맡겼습니다. 소요 시간과 결과는 아래에 있습니다.
결론부터
| 비교 항목 | Claude Fable 5.2 | Claude Opus 5.5 |
|---|---|---|
| API 모델 ID | claude-fable-5-2 | claude-opus-5-5 |
| 공식 포지셔닝 | 고난도 추론, 오래 실행되는 Agent 작업 | 오래 실행되는 Agent 코딩과 지식 작업. 공식적으로 대부분의 작업은 여기서 시작하라고 권장 |
| 공식 API 가격(입력 / 출력, 100만 tokens당) | $8 / $40 | $4 / $20 |
| 캐시 읽기(100만 tokens당) | $0.20 | $0.20 |
| 컨텍스트 / 최대 출력 | 1M / 128K | 1M / 128K |
| API 기본 effort | high | medium |
| 공식 상대 지연 시간 | Moderate | Moderate |
| Claude Code 최소 버전 | v2.1.321 | v2.1.280 |
| 직접 테스트(같은 버그 수정 작업, Claude Code 2.1.322) | 2회, 약 17.1초와 18.9초, 모두 3턴, 테스트 모두 통과 | 3회, 약 154.5초, 327.7초, 153.6초, 4~8턴, 테스트 모두 통과 |
가격, 사양, 기본 effort는 Anthropic 가격 페이지와 모델 개요, 최소 버전은 Claude Code 모델 설정 문서를 따랐습니다. 확인 시각은 11월 12일 16:20(베이징 시간)입니다.
한마디로 고르는 법:
- 일상적인 코딩, 범위가 분명한 변경: Opus 5.5부터 쓰세요. 토큰 단가가 Fable의 절반입니다.
- 원인을 모르는 조사, 여러 모듈에 걸친 리팩터링, 오래 걸리는 작업: Fable 5.2로 바꾸세요.
- 함께 쓰기: Fable 메인 Agent가 계획과 오케스트레이션을 맡고, 테스트 작성이나 자료 조사처럼 범위가 분명한 하위 작업은 Opus로 실행되는 서브 Agent에 넘깁니다. 반대로 Opus 메인 Agent가 어려운 문제만 Fable 서브 Agent에 넘기는 구성도 가능합니다. 설정 방법은 아래에 있습니다.
Fable 5.2와 Opus 5.5의 차이
사양은 거의 같습니다. 둘 다 1M 컨텍스트, 최대 출력 128K, 적응형 사고 항상 켜짐, 지식 기준 시점 2026년 6월입니다. 차이는 크게 세 가지입니다.
- 포지셔닝: Anthropic은 Fable 5.2를 "고난도 추론과 오래 실행되는 Agent 작업용", Opus 5.5를 "오래 실행되는 Agent 코딩과 지식 작업용"으로 설명합니다. Claude Code 문서에 따르면 Fable은 한 번에 끝나지 않는 규모의 작업에 맞고, 행동하기 전에 먼저 조사하며, 자기 작업을 더 자주 검증합니다.
- 가격: Fable 5.2는 입력 $8, 출력 $40, Opus 5.5는 $4, $20로 정확히 2배입니다. 빠른 모드에서는 Fable 5.2가 $16 / $80, Opus 5.5가 $8 / $40입니다.
- 기본 effort: API에서 Fable 5.2는 기본 high, Opus 5.5는 기본 medium입니다. Anthropic 발표에 따르면 Claude Code에서 Fable 5.2의 기본 effort는 medium입니다.
Fable 5.2 자체의 가격, 벤치마크, 1M 컨텍스트는 「Claude Fable 5.2란」을, Opus 5.5의 effort 조정은 「Opus 5.5 effort 고르는 법」을 참고하세요. Sonnet과 Opus 사이에서 고민 중이라면 「Sonnet 5.5 vs Opus 5.5」와 「Claude Code에서는 어떤 모델을 쓸까」를 보세요.
개발자들의 반응
아래는 제3자의 주장이며, 모두 X의 요약과 사용자 후기입니다.
- Agent 순위: X 요약에 따르면 Fable 5.2는 Arena.ai의 Agent Arena에서 1위에 올랐고 코드, 대화, 업무 작업에서 앞섰습니다. 같은 요약은 일상 작업에는 단가가 낮은 Opus 5.5를 선호하는 개발자도 있다고 전합니다.
- 혼합 라우팅: X 요약 「Developers Compare Claude Fable 5.2 and Opus 5.5 in Real Tests」에 따르면 개발자들은 대체로 Fable 5.2가 Agent 코딩과 긴 작업에서 더 강하지만 가격이 약 2배라고 평가하며, 많은 사람이 평소에는 Opus를 쓰고 Fable은 오케스트레이션과 어려운 문제에 아껴 둡니다.
- 구독 사용 한도: X에 요약된 사용자 후기에 따르면 Claude 구독에서 Fable을 쓰면 주간 한도에 더 빨리 도달해, Fable은 계획에만 쓰고 무거운 작업은 Opus에 맡기는 사람도 있습니다.
- Opus가 느려졌다는 반응: X에 요약된 사용자 후기에 따르면 일부 개발자는 11월 3일 이후 Claude Code의 Opus 5.5가 도구 호출이 늘고 작업 시간이 길어졌다고 말합니다. Anthropic은 이에 대해 입장을 내지 않았습니다.
이런 반응은 아래 테스트 결과와 같은 방향을 가리키지만 모두 표본이 작습니다. 최종 판단은 여러분의 프로젝트에서 직접 테스트한 결과로 하세요.
직접 테스트: 같은 버그 수정 작업을 두 모델로 실행
테스트 환경: Linux x64, Claude Code 2.1.322, 전역 ~/.claude/settings.json에 AICodeWith API Key 연결, 비대화형 claude -p, --permission-mode bypassPermissions(일회용 테스트 디렉터리에서만 사용. 실제 저장소에서는 이렇게 쓰지 마세요).
테스트 프로젝트: 약 40줄짜리 Python 재고 모듈입니다. README에 규칙 3개가 있고 코드는 3개 모두 어깁니다(기존 SKU를 다시 추가하면 수량이 더해지지 않고 덮어써짐, 수량이 0이 되어도 삭제되지 않음, 재고 부족 판정에 <= 대신 < 사용). 기존 unittest 테스트 3개는 모두 통과하며 이 문제들을 잡지 못합니다.
프롬프트(두 모델 동일. 실제로는 중국어로 실행했고 여기서는 번역해 실었습니다):
README.md에 사양이 있습니다. inventory/stock.py에는 사양과 맞지 않는 곳이 있습니다. 모든 불일치를 찾아 고치고, 각각 unittest 테스트를 하나씩 추가한 다음, python3 -m unittest를 실행해 모두 통과하는지 확인하세요. 마지막으로 무엇을 바꿨는지 한 줄로 요약하세요.
명령:
claude -p "<위 프롬프트>" --model claude-fable-5-2 --output-format json
claude -p "<위 프롬프트>" --model claude-opus-5-5 --output-format json
| 실행 | 모델 | 소요 시간(duration_ms) | 턴 수 | 결과 |
|---|---|---|---|---|
| 1회차(두 모델 동시 실행) | Fable 5.2 | 약 17.1초 | 3 | 3곳을 찾아 모두 수정, 테스트 3개 추가, Ran 6 tests ... OK |
| 1회차(두 모델 동시 실행) | Opus 5.5 | 약 154.5초 | 4 | 3곳을 찾아 모두 수정, 테스트 3개 추가, 6개 모두 통과 |
| 2회차(차례로 실행) | Opus 5.5 | 약 327.7초 | 8 | 위와 같음, 6개 모두 통과 |
| 2회차(차례로 실행) | Fable 5.2 | 약 18.9초 | 3 | 위와 같음, Ran 6 tests ... OK |
| 3회차 | Opus 5.5 | 약 153.6초 | 4 | 위와 같음, 6개 모두 통과 |
매번 실행이 끝난 뒤 프로젝트 디렉터리에서 직접 python3 -m unittest를 다시 돌렸고, 결과는 모두 OK였습니다.
관찰한 점:
- 두 모델 모두 정답: 불일치 3곳을 모두 찾았고, 같은 방식으로 고쳤으며, 테스트는 기존 테스트 파일에 추가했습니다. Opus의 요약이 더 길고, 원래 코드가 왜 틀렸는지 하나씩 설명했습니다(예:
qty < 0조건은 절대 참이 될 수 없다고 지적). - 이번에는 Opus가 확실히 느렸음: 별도로 curl로 "OK라고만 답해" 수준의 최소 요청을 모델별로 두 번씩 보냈더니 Opus 5.5는 약 1.2초, Fable 5.2는 약 2.9초였습니다. 즉 느린 원인은 Claude Code의 여러 턴, 긴 컨텍스트 요청에 있었고, 모델이 처음부터 느리게 답한 것은 아닙니다. 이 결과는 이 시간대, 이 경로에서의 것이며 다른 시간에는 달라질 수 있습니다. 위의 "Opus가 느려졌다"는 반응과 함께 보세요.
- 작은 작업에서는 능력 차이가 드러나지 않음: 이 작업은 두 모델 모두 한 번에 맞혔습니다. Anthropic에 따르면 Fable의 강점은 더 어렵고 긴 작업에서 드러나므로, 그런 작업은 여러분의 저장소로 비교해 보세요.
Claude Code에서 Fable과 Opus 전환하기
1. 버전 확인: Fable 5.2는 Claude Code v2.1.321 이상, Opus 5.5는 v2.1.280 이상이 필요합니다. claude --version으로 확인하고 claude update로 업데이트하세요.
2. API 연결: 아래 설정을 전역 ~/.claude/settings.json(Windows는 %USERPROFILE%\.claude\settings.json)에 넣습니다. 파일이 이미 있으면 통째로 덮어쓰지 말고 이 필드들만 합치세요. 저장소에 커밋되는 프로젝트 설정에는 넣지 마세요. 전체 절차는 「Claude Code 서드파티 API 설정」에 있습니다.
{
"model": "claude-opus-5-5",
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "내 AICodeWith API Key",
"ANTHROPIC_API_KEY": ""
}
}
여기서는 "model"을 Opus 5.5로 두어 평소 기본 모델로 씁니다. 테스트에서 이를 claude-fable-5-2로 바꾸자 --model 없이 실행해도 Fable 5.2가 쓰였고, 컨텍스트는 1M, 최대 출력은 128K였습니다.
3. 세션 안에서 전환:
| 하고 싶은 일 | 방법 |
|---|---|
| 현재 세션을 Fable 5.2로 전환 | /model fable 또는 /model claude-fable-5-2 |
| Opus 5.5로 돌아가기 | /model opus 또는 /model claude-opus-5-5 |
| 이번 세션에만 적용하고 기본값은 유지 | /model을 입력해 선택기를 열고 해당 행에서 s 누르기 |
| 실행할 때 지정 | claude --model fable |
| 기본 모델 고정 | settings.json의 "model" 필드 |
공식 문서에 따르면 /model <이름>을 직접 입력하거나 선택기에서 Enter를 누르면 선택이 사용자 설정의 model 필드에 저장되어 이후 새 세션의 기본값이 됩니다. AICodeWith를 통한 테스트에서 --model fable과 --model opus는 각각 claude-fable-5-2와 claude-opus-5-5로 연결됐습니다. 별칭이 나중에 새 모델을 가리키지 않도록 버전을 고정하려면 전체 ID를 쓰세요.
함께 쓰기: 메인 Agent는 Fable, 서브 Agent는 Opus
Claude Code의 사용자 정의 서브 Agent는 YAML frontmatter가 있는 Markdown 파일로, ~/.claude/agents/(모든 프로젝트에서 사용 가능)나 프로젝트의 .claude/agents/에 둡니다. frontmatter의 model 필드가 서브 Agent가 쓸 모델을 정합니다. sonnet, opus, haiku, fable 같은 별칭, 전체 모델 ID, 또는 inherit(메인 대화와 동일)를 쓸 수 있습니다.
테스트에 쓴 서브 Agent 파일은 .claude/agents/test-writer.md입니다(중국어에서 번역):
---
name: test-writer
description: 이미 고친 코드에 unittest 테스트를 추가하고 실행한다. 메인 Agent가 버그를 고친 뒤 호출한다.
tools: Read, Edit, Write, Bash
model: claude-opus-5-5
---
너는 테스트만 담당한다. README.md의 사양과 변경 사항을 읽고, 수정마다 unittest 테스트를 하나씩 추가한 뒤 python3 -m unittest를 실행해 통과한 개수를 보고한다. inventory/ 아래의 비즈니스 코드는 수정하지 않는다.
그다음 메인 세션을 Fable 5.2로 실행해 버그는 직접 고치게 하고, 테스트 작성은 서브 Agent에 넘기게 합니다:
claude -p "inventory/stock.py에서 사양과 맞지 않는 곳을 직접 고치고(테스트는 쓰지 말 것), 그다음 test-writer 서브 Agent를 호출해 수정마다 테스트를 추가하고 python3 -m unittest를 실행하게 하세요." --model claude-fable-5-2 --output-format json
테스트 결과: 총 약 74.0초, 메인 세션 5턴. 출력 JSON의 modelUsage에 claude-fable-5-2와 claude-opus-5-5가 모두 기록되어 두 모델이 실제로 호출됐음을 확인했습니다. Fable이 3곳을 고쳤고, Opus 서브 Agent가 테스트 6개를 추가해 최종적으로 9개 테스트가 모두 통과했습니다.
설정할 때 주의할 점(공식 서브 Agent 문서 기준):
- 모델 결정 순서: 호출 시 전달되는
model매개변수 → 서브 Agent 파일의model필드 → 환경 변수CLAUDE_CODE_SUBAGENT_MODEL→ 메인 대화의 모델. 호출 시 매개변수는 별칭(opus,fable등)만 받고 전체 ID는 받지 않습니다. model을 쓰지 않으면 메인 세션을 따라감:/model로 Fable로 바꾸면 모델을 지정하지 않은 서브 Agent도 Fable로 실행됩니다. 서브 Agent를 Opus로 고정하려면 파일에model을 적어 두세요.- 별칭이 메인 세션의 모델로 해석될 수 있음: 메인 세션이 이미 Opus 계열이라면
opus로 적은 서브 Agent는 그 모델을 그대로 씁니다.claude-opus-5-5같은 전체 ID가 가장 확실합니다. - 필드 이름 오타는 오류 없이 무시됨: Claude Code는 모르는 필드를 조용히 무시합니다. 서브 Agent의 모델이 예상대로 바뀌지 않으면
claude --debug로 디버그 로그를 확인하세요.
서브 Agent 모델 설정 예시는 「Claude Code에서 Haiku 5.5 서브 Agent 설정하기」와 「백그라운드 서브 Agent 모델 설정」도 참고하세요.
Codex와 Cursor에서 고르는 법
Codex: Codex는 OpenAI의 GPT 계열 모델을 쓰므로 Fable과 Opus는 모델 목록에 없습니다. Codex에서 같은 "일상용과 어려운 문제용" 분담은 GPT 모델 사이를 전환하는 것입니다. 실행할 때는 codex -m <모델>, 세션 안에서는 /model을 씁니다. AICodeWith로 연결할 때 전역 ~/.codex/config.toml은 다음과 같이 씁니다:
model_provider = "aicodewith"
model = "gpt-6.1-sol"
[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "내 AICodeWith API Key"
GPT와 Opus 비교는 「GPT-6.1 Sol vs Claude Opus 5.5」를 보세요.
Cursor: Agent 패널의 모델 드롭다운에서 고릅니다. Cursor 공식 문서에 따르면 Fable 5.2의 입력·출력 단가는 Opus 5.5의 약 2배입니다. 개인정보 보호 모드를 켠 계정과 Enterprise 고객은 관리자가 먼저 대시보드에서 Anthropic의 데이터 보존 약관에 동의해야 쓸 수 있습니다. 요청이 Fable의 보안 가드레일에 걸리면 Cursor가 자동으로 Claude Opus로 넘깁니다.
자주 나는 오류와 해결법
| 오류 / 증상 | 원인 | 해결법 |
|---|---|---|
| API Error: 400 {"error":"模型 claude-fable-5.2 不存在或未上线 ..."}(모델이 없거나 아직 출시되지 않음) | 모델 ID 오타. 일부러 5-2를 5.2로 썼더니 AICodeWith가 HTTP 400을 반환 | 하이픈 사용: claude-fable-5-2, claude-opus-5-5. GET https://api.aicodewith.ai/v1/models로 현재 Key로 쓸 수 있는 모델 확인 |
| 시작할 때 [claude-code:unrecognized_model]이 뜨고 modelUsage에 컨텍스트 200000, 최대 출력 32000으로 표시 | Claude Code가 v2.1.321보다 낮아 Fable 5.2를 인식하지 못함(2.1.319에서 직접 겪음) | claude update로 v2.1.321 이상으로 업데이트하고 modelUsage가 1000000 / 128000인지 확인 |
| There's an issue with the selected model | 공식 문서에 따르면 settings.json, --model, ANTHROPIC_MODEL의 모델 이름에 오타가 있으면 첫 요청에서 이 메시지가 뜸 | 경고가 제안한 이름이나 표의 전체 ID로 수정 |
| 서브 Agent가 지정한 모델을 쓰지 않음 | frontmatter 필드 이름 오타로 무시됨, 또는 호출 시 전달된 model 매개변수가 우선 | model 철자를 확인하고 claude --debug로 로그 확인, 전체 ID 사용 |
| 401 Unauthorized | Key가 틀렸거나 만료됨, 요청 헤더 오류 | 401 문제 해결 글을 따라 하나씩 확인 |
| 429 또는 사용 한도에 빨리 도달 | 동시 요청이 너무 많거나 속도 제한. Fable은 단가가 높아 같은 작업에도 한도가 더 빨리 소모됨 | 동시 실행을 줄이고 기다렸다가 재시도, 일상 작업은 Opus로 전환 |
401의 전체 해결 절차는 「Codex 401 Unauthorized 해결 방법」, 429는 「Codex 429 Too Many Requests 해결 방법」에 있습니다. 같은 접근법이 Claude Code에도 그대로 적용됩니다.
FAQ
Fable 5.2가 항상 Opus 5.5보다 낫나요?
공식 포지셔닝상 Fable 5.2는 더 어렵고 긴 작업용이고 벤치마크 점수도 더 높습니다. 하지만 이번 작은 작업에서는 두 모델 모두 한 번에 맞혔습니다. 범위가 분명한 일상 작업이라면 단가가 절반인 Opus 5.5로 충분합니다.
Claude Code의 기본 모델은 무엇인가요?
공식 문서에 따르면 어떤 요금제나 제공업체에서도 Fable은 기본 모델이 아니며 직접 골라야 합니다. 서드파티 API로 쓸 때는 settings.json의 "model"에 명시하는 것을 권장합니다.
Claude Code가 두 모델을 자동으로 전환하게 할 수 있나요?
작업 난이도에 따라 자동으로 전환하는 설정은 없습니다. 흔한 방법은 이 글의 서브 Agent 분담입니다. 메인 세션에 모델 하나를 쓰고, 서브 Agent 파일에 다른 모델을 고정합니다.
AICodeWith로 Fable 5.2를 쓸 수 있나요?
네. 11월 12일 AICodeWith Key로 /v1/models를 조회했을 때 목록에 claude-fable-5-2와 claude-opus-5-5가 있었고, 위의 테스트는 모두 AICodeWith를 통해 진행했습니다.



