빠른 요약: Claude Fable 5.1은 어려운 디버깅, 리포지토리 단위의 리팩터링, 여러 파일과 도구 호출에 걸친 구현 작업에 평가할 가치가 있습니다. Claude Code에서는 모델을 명시적으로 선택하고, 활성 모델과 연결을 확인한 뒤, 작업에 맞는 effort 수준을 고르세요. 이 가이드는 네이티브 접근, 선택적 CometAPI 라우팅, 지속적 설정, 그리고 실용적인 분석–구현–테스트–리뷰 워크플로를 다룹니다. 목표는 더 긴 모델 응답이 아니라 작동하며 리뷰 가능한 변경사항입니다.
핵심 포인트
- 선택 및 검증: 계정 또는 프로바이더에서 모델을 사용할 수 있을 때 /model 또는 --model을 사용하고, 큰 작업을 시작하기 전에
/status로 확인하세요. - 역량을 작업에 맞추기: 지연과 비용을 감수할 가치가 있는 어려운 다단계 작업에 모델을 할당하세요. 벤치마크 점수는 특정 리포지토리에서의 성능을 보장하지 않습니다.
- 의도적으로 effort를 조율: 까다로운 코딩 작업은 high로 시작하고, 일상적인 작업에서는 medium과 비교해 보며, xhigh나 max는 자체 평가 결과가 이를 정당화할 때만 사용하세요.
- 워크플로를 보호: API 키를 공유 프로젝트 설정에 넣지 말고, 연결을 검증하며, 범위를 합의하고, 관련 테스트를 실행한 뒤, 최종 diff를 검토하세요.
Claude Fable 5.1이란 무엇인가요?
Claude Fable 5.1은 2026년 9월에 출시된 Claude Fable 5의 후속 모델입니다. Anthropic은 이를 요구되는 추론과 장기적인 에이전트형 작업을 위해 포지셔닝합니다. 100만 토큰 컨텍스트 윈도우, 최대 128K 출력 토큰, 텍스트 및 이미지 입력, 항상 활성화된 적응형 사고, low부터 max까지 다섯 가지 effort 레벨을 지원합니다.
레이블보다 작업 형태가 더 중요합니다. Fable 5.1은 많은 파일, 명령, 테스트, 수정, 복구 단계를 포괄할 수 있는 작업을 위해 설계되었습니다. Anthropic은 여전히 대부분의 워크로드를 Opus 5로 시작하고, 더 높은 effort의 Opus 평가가 충분하지 않을 때 Fable 5.1로 전환할 것을 권장합니다.
| 공식 사양 | Claude Fable 5.1 |
|---|---|
| Developer | Anthropic |
| Model ID | claude-fable-5-1 |
| Release date | September 1, 2026 |
| Context window | 1M tokens |
| Maximum output | 128K tokens |
| Input / output | Text and images → text |
| Thinking | Adaptive, always on |
| Default effort | high |
| Effort levels | low, medium, high, xhigh, max |
| Knowledge cutoff | June 2026 |
| Official input price | $10 / MTok |
| Official output price | $50 / MTok |
| Cache read | $0.25 / MTok |
| Comparative latency | Slower |
Claude Code에서 Claude Fable 5.1이 중요한 이유
Claude Code는 에이전트형 코딩 환경입니다. 단편적인 코드 조각 생성만이 아니라 리포지토리를 조사하고, 파일을 편집하며, 명령을 실행하고, 테스트를 수행할 수 있습니다. 따라서 일반 상식 점수보다 에이전트형 코딩과 비즈니스 워크플로 벤치마크가 더 관련성이 높습니다.
어떤 작업에 사용하는 것이 타당한가요? Claude Fable 5.1은 모듈 간 리팩터링, 원인이 불분명한 반복적 실패, API·퍼시스턴스·테스트에 걸친 조정이 필요한 기능 등에 고려하세요. 이는 벤치마크 기반 보장이 아닌 실용적 의사결정 규칙입니다. 일반적인 작업은 Claude Opus 5로 시작하고, 더 높은 effort 평가에서도 부족할 때 에스컬레이션하세요. 작은 수정이나 빠르고 저렴한 반복에는 Claude Sonnet 5를 고려하세요. 선택은 해당 리포지토리에서 검증된 완료 품질과 총 작업 비용으로 판단하세요.
| 선정된 공식 벤치마크 | Fable 5.1 | Fable 5 | Opus 5 | GPT-5.6 Sol |
|---|---|---|---|---|
| Terminal-Bench 4.0 | 55.8% | 42.0% | 52.3% | 37.3% |
| AutomationBench | 31.4% | 17.1% | 26.9% | 19.6% |
| CursorBench 3.2.0 | 73.4% | 70.5% | 70.0% | 67.2% |
Anthropic은 Terminal-Bench 4.0에서 55.8%, AutomationBench에서 31.4%, CursorBench 3.2.0에서 73.4%를 보고합니다. 이 결과는 터미널 중심 및 다단계 코딩 워크플로에서 Fable 5.1의 의도된 역할을 뒷받침하지만, 모든 코드베이스나 모든 effort 수준에서 항상 최적임을 보장하지는 않습니다.
Claude Code에서 Claude Fable 5.1을 사용하기 전에 필요한 것
Claude Code에서 Fable 5.1을 설정하기 전에 다음 세 가지 사전 점검을 완료하세요:
- Claude Code 버전: Claude Code v2.1.255 이상을 사용하세요.
claude --version을 실행하고, 모델 선택 문제 해결에 앞서 클라이언트를 업데이트하세요. - 계정 또는 API 접근: Claude 플랜, Anthropic API 계정, 또는 호환 게이트웨이 자격 증명이 활성 상태인지 확인하세요.
- 모델 가용성: 지속적 설정을 추가하기 전에
claude-fable-5-1이 계정, 조직, 또는 프로바이더에 대해 활성화되어 있는지 확인하세요.
claude --version
npm install -g @anthropic-ai/claude-code@latest
또한 Claude 플랜 또는 API/게이트웨이 구성 중 하나를 통해 접근이 필요합니다. Anthropic은 해당 모델이 지원되는 개발자 플랫폼에서 활성이라고 안내합니다.
API 키를 노출하지 않고 구성을 지속시키는 방법
셸에서 export한 환경변수는 현재 터미널에만 적용됩니다. Claude Code는 사용자 수준과 프로젝트 로컬 설정에서 env 블록을 지원합니다. Windows의 사용자 수준 경로는 %USERPROFILE%\.claude\settings.json, macOS와 Linux에서는 ~/.claude/settings.json입니다.
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.cometapi.com",
"ANTHROPIC_MODEL": "claude-fable-5-1"
}
}
비밀 정보는 커밋되는 프로젝트 설정 밖에 두세요. Anthropic은 공유 프로젝트 설정 파일에 자격 증명을 넣지 말라고 명시합니다. COMETAPI_KEY 또는 ANTHROPIC_AUTH_TOKEN은 로컬 셸, 운영체제 자격 증명 워크플로, 또는 시크릿 매니저를 통해 제공하세요.
방법 1: Claude Code에서 Claude Fable 5.1을 직접 사용하기
1단계: 리포지토리 루트에서 Claude Code 시작
cd /path/to/your/project
claude
리포지토리 루트에서 시작하면 처음부터 Claude Code가 의도된 프로젝트 컨텍스트를 갖게 됩니다.
2단계: /model로 Fable 5.1 선택
/model
선택기에서 Claude Fable 5.1을 고르세요. Claude Code는 세션 내 명령, 실행 플래그, 환경변수, 설정을 통한 모델 선택을 지원합니다. 공식 참고 문서는 /model과 --model이 ANTHROPIC_MODEL을 오버라이드함을 확인합니다.
3단계: Fable 5.1로 직접 실행
claude --model claude-fable-5-1
이미 세션이 Fable 5.1을 필요로 한다고 판단되면 실행 플래그를 사용하여 시작 후 전환을 피하세요.
4단계: 활성 모델 확인
/status
여러 구성 레이어가 있을 때 검증이 중요합니다. Status 탭은 활성 모델, base URL, 자격 증명 소스를 보여주어, 예기치 않은 사용자 설정, 프로젝트 설정, 환경변수, 게이트웨이 라우트를 쉽게 파악할 수 있습니다.
방법 2: Claude Code를 CometAPI에 어떻게 연결하나요?
Claude Code는 지원되는 API 형식을 노출하는 게이트웨이에 연결할 수 있습니다. Anthropic 문서는 게이트웨이 URL과 자격 증명을 설정하는 방법을 설명하며, 서드파티 게이트웨이는 Anthropic이 보증하거나 유지보수하지 않는다고 경고합니다. 워크플로에서 의존하는 모든 Claude Code 기능을 검증하세요.
CometAPI는 Claude Fable 5.1이 라이브라고 명시하고, /v1/messages에 Anthropic 호환 Messages 엔드포인트를 제공합니다. Claude Code가 ANTHROPIC_AUTH_TOKEN을 Authorization bearer 헤더로 매핑하므로, 프로덕션 사용 전에 라이브 모델 페이지에서 최신 인증 형식을 확인하세요.
macOS, Linux, 또는 WSL
export COMETAPI_KEY="YOUR_COMETAPI_KEY"
export ANTHROPIC_BASE_URL="https://api.cometapi.com"
export ANTHROPIC_AUTH_TOKEN="$COMETAPI_KEY"
export ANTHROPIC_MODEL="claude-fable-5-1"
claude
Windows PowerShell
$env:COMETAPI_KEY = "YOUR_COMETAPI_KEY"
$env:ANTHROPIC_BASE_URL = "https://api.cometapi.com"
$env:ANTHROPIC_AUTH_TOKEN = $env:COMETAPI_KEY
$env:ANTHROPIC_MODEL = "claude-fable-5-1"
claude
실행 후 /status를 실행하세요. Anthropic base URL과 자격 증명 라인이 게이트웨이 라우트와 활성 인증 토큰을 보여야 합니다. 긴 작업 전에 작은 테스트 프롬프트를 전송하세요.
게이트웨이는 새로운 Claude Code 필드나 엔드포인트를 따라가지 못할 수 있습니다. CometAPI를 통해 특정 기능이 다르게 동작하면, 그 동작을 모델 탓으로 돌리기 전에 동일한 워크플로를 Anthropic에 직접 연결하여 반복해 보세요.
코딩에서 어떤 effort 레벨을 선택해야 하나요?
Fable 5.1은 적응형 사고를 사용하며 low, medium, high, xhigh, max effort를 지원합니다. Anthropic은 기본 high에서 시작하고 자체 평가 세트로 다른 수준을 테스트하라고 권장합니다. Effort는 지능, 지연, 비용의 균형을 조절하는 핵심 수단입니다.
| Effort | 적합한 Claude Code 사용 사례 | 트레이드오프 |
|---|---|---|
| low | 작은 수정, 빠른 설명, 단순한 로컬 변경 | 추론 비용이 가장 낮음; 검색이 줄 수 있음 |
| medium | 일반적인 구현, 직관적인 수정, 보통 난이도의 코드 리뷰 | 품질과 비용의 균형이 좋음 |
| high | 진지한 다중 파일 작업, 디버깅, 테스트 포함 구현 | 권장 시작점 |
| xhigh | 어려운 리팩터링, 난해한 디버깅, 아키텍처 민감 작업 | 더 많은 추론과 지연 |
| max | 역량 민감, 비정상적으로 어려운 장기 작업 | 시간과 토큰 사용량이 가장 큼 |
Anthropic에 따르면 medium effort에서 Fable 5.1은 더 낮은 비용으로 대략 Fable 5에 상응할 수 있습니다. low에서는 검색과 검색 도구 호출 빈도가 줄 수 있으므로, 최신 코드나 문서에 의존하는 작업에 자동으로 올바른 선택은 아닙니다.
실용적인 Fable 5.1 Claude Code 워크플로
설정은 절반에 불과합니다. Fable 5.1은 작업을 분석, 범위 확인, 구현, 검증, 리뷰로 명시적으로 구분할 때 가장 잘 동작합니다.
1단계: 리포지토리 분석으로 시작
Analyze this repository before editing anything.
Goal: add a new /api/v1/reports endpoint that returns a paginated report list.
First:
1. Find the current API routing pattern.
2. Identify the service and persistence layers involved.
3. Find existing pagination conventions.
4. Identify the relevant tests.
5. Propose the smallest implementation plan.
Do not modify files until you have summarized the plan.
이 첫 번째 단계는 잘못된 가정을 여러 파일에 퍼뜨리기 전에 드러나게 해 줍니다.
2단계: 범위를 확정한 후 구현
Implement the approved plan.
Constraints:
- Change only files required for this feature.
- Follow existing project conventions.
- Prefer targeted edits over whole-file rewrites.
- Do not refactor unrelated code.
- Add or update only the tests needed for this feature.
- Report unrelated defects instead of fixing them automatically.
이 문구는 Anthropic이 정밀한 수정 선호와 요청된 범위 내에서 작업 유지 권장 사항을 따릅니다.
3단계: 관련 테스트 실행
Run the relevant unit and integration tests after implementation.
If a test fails:
1. Identify the root cause.
2. Explain whether this change caused the failure.
3. Fix only failures caused by this change.
4. Rerun the smallest relevant test set before the broader suite.
체크포인트는 관찰 가능합니다. 관련 테스트가 통과하거나, 남은 실패와 요청된 변경과의 관계를 보고합니다.
4단계: 작업을 수용하기 전에 diff 리뷰
Review your final changes as if you were a code reviewer.
Check for:
- behavior outside the requested scope,
- missing edge cases,
- regressions,
- duplicated logic,
- unnecessary file changes,
- tests that do not verify the new behavior.
Then summarize the final diff, tests run, and remaining risks.
이 마지막 단계는 사람이 수용할 체크리스트를 간결하게 제공하고, PR에 올라가기 전에 불필요한 작업을 드러내는 데 도움을 줍니다.
Claude Fable 5.1을 위한 권장 CLAUDE.md 지침
짧은 리포지토리 수준 지침 파일은 세션 간 일관성을 높여줍니다. Claude가 매번 다시 찾아야 할 규칙과 명령만 포함하세요.
# Repository Instructions
- Inspect the existing implementation before editing.
- Keep changes within the requested scope.
- Prefer surgical edits over whole-file rewrites.
- Follow existing project conventions.
- Run relevant tests after implementation.
- Fix root causes rather than patching symptoms.
- Report unrelated issues instead of changing them automatically.
- Summarize files changed, tests run, and remaining risks.
대형 모노레포에서는 패키지 매니저, 테스트/린트 명령, 아키텍처 경계, 생성 파일 규칙, 수동 편집 금지 디렉터리를 추가하세요.
Opus 5 대신 Claude Fable 5.1을 언제 사용해야 하나요?
실무적인 질문은 더 최신이냐가 아니라, 작업이 Opus 5가 안정적으로 제공할 수 있는 것보다 더 지속적인 추론을 필요로 하느냐입니다. Anthropic은 대부분의 워크로드에 Opus 5를 권장합니다. Claude Code에서는 Fable 5.1을 가장 어려운 장기 작업을 위한 에스컬레이션 옵션으로 취급하세요.
| 의사결정 요소 | Claude Fable 5.1 | Claude Opus 5 |
|---|---|---|
| 작업 범위 | 리포지토리 전역 마이그레이션, 모듈 간 리팩터링, 모호한 조사 | 기능, 버그 수정, 리뷰, 범위가 명확한 리팩터링 |
| 추론 지평 | 반복적 도구 사용, 테스트, 수정, 복구를 동반한 장시간 자율 세션 | 더 짧고 범위가 명확하며 완료 경로가 분명한 코딩 세션 |
| 품질 vs 속도 | 가장 어려운 작업에서 검증된 완료 품질이 최우선일 때 사용 | 품질, 지연, 비용의 기본 균형이 더 좋음 |
| 에스컬레이션 기준 | 높은 effort의 Opus도 실패, 단계 간 일관성 상실, 반복적 복구가 필요한 경우 | 대부분의 Claude Code 작업의 첫 선택 |
| 지연과 비용 | 추가 지연·비용이 결과를 실질적으로 개선할 때만 가치 있음 | 일상적이거나 인터랙티브한 작업에 더 적합 |
| 최적 적합 | 어렵고 장기적인 에이전트형 코딩 | 기본적인 복잡 전문 코딩 |
실용적인 에스컬레이션 규칙
먼저 Opus 5를 high effort로 시작하세요. 다음 중 하나 이상이 참이면 Fable 5.1로 전환합니다:
- 범위: 작업이 서로 의존적인 많은 파일 또는 서비스를 가로지르며 반복적 도구 사용, 테스트, 수정, 복구가 필요함.
- 신뢰성: high effort의 Opus 5도 여전히 의존성을 놓치거나, 단계 간 일관성을 잃거나, 워크플로를 안정적으로 완료하지 못함.
- 실패 비용: 불완전/잘못된 변경의 비용이 Fable 5.1의 추가 지연과 API 비용보다 큼.
동일한 리포지토리 작업에서 검증된 완료를 실질적으로 개선할 때만 Fable 5.1을 사용하세요. 그렇지 않다면 Opus 5로 되돌리세요.
실무적으로 Fable 5.1은 리포지토리 전역 마이그레이션, 모듈 간 디버깅, 다중 서비스 기능 작업, 반복적인 조사·실행·테스트·복구가 필요한 어려운 근본 원인 분석에 더 강합니다. 고립된 수정, 일상적 기능 작업, 코드 리뷰, 문서화에는 Opus 5가 여전히 기본 선택입니다.
문제 해결
/model에 Claude Fable 5.1이 보이지 않음
Claude Code를 업데이트하고, 터미널과 세션을 재시작한 뒤, 계정 또는 조직의 접근 권한을 확인하세요. 관리형 설정이 모델 선택을 제한하는지도 확인하세요.
Claude Code가 잘못된 모델을 사용함
/status를 실행하고 모든 구성 레이어를 점검하세요. 공식 문서에 따르면 --model과 /model이 ANTHROPIC_MODEL을 오버라이드합니다. 사용자/프로젝트/프로젝트 로컬 설정도 확인하세요.
CometAPI가 401 또는 인증 오류를 반환함
API 키, base URL, 자격 변수들을 확인하세요. Claude Code는 ANTHROPIC_AUTH_TOKEN을 Authorization: Bearer로 전송하고, ANTHROPIC_API_KEY는 x-api-key로 매핑됩니다. 현재 CometAPI 엔드포인트가 허용하는 형식을 사용하세요.
세션이 너무 느리거나 비용이 큼
모든 작업에 max effort를 사용하지 마세요. 대표 평가 세트에서 medium과 high를 비교하고, 총 작업 비용과 완료 품질을 측정한 뒤, 추가 추론이 결과를 바꿀 때만 xhigh나 max를 사용하세요.
Fable 5.1이 필요 이상으로 코드를 많이 재작성함
프롬프트 또는 CLAUDE.md에 다음 범위 제약을 추가하세요.
Prefer targeted edits over whole-file rewrites unless a rewrite is required for correctness.
Anthropic은 이 동작을 문서화했으며, 작은 변경에는 정밀한 수정을 권장합니다.
자주 묻는 질문(FAQs)
Claude Fable 5.1은 Claude Code에서 실행할 수 있나요?
예. 계정 또는 프로바이더에서 모델을 사용할 수 있을 때 모델 선택기를 사용하거나 --model claude-fable-5-1로 Claude Code를 실행하세요.
Claude Fable 5.1의 모델 ID는 무엇인가요?
공식 Claude API 모델 ID는 claude-fable-5-1입니다.
세션 중에 모델을 어떻게 전환하나요?
/model을 실행해 Claude Fable 5.1을 선택하고, /status로 활성 모델과 라우트를 확인하세요.
어떤 effort 레벨을 사용해야 하나요?
진지한 코딩 작업은 high로 시작하세요. 일상적인 작업에서는 medium을 시험해 보고, 자체 평가에서 의미 있는 품질 향상이 확인될 때만 xhigh나 max를 사용하세요.
Claude Code에서 CometAPI를 사용할 수 있나요?
Claude Code는 호환 게이트웨이를 지원하며, CometAPI는 Fable 5.1에 대해 Anthropic 호환 Messages 엔드포인트를 제공합니다. 인증 형식과 의존하는 모든 Claude Code 기능을 검증하세요.
Fable 5.1이 항상 Opus 5보다 낫나요?
아니요. Anthropic은 대부분의 워크로드에 Opus 5를 권장하고, 더 높은 effort의 Opus 5가 충분하지 않을 때 Fable 5.1을 권장합니다.
Sonnet 5 대신 Fable 5.1을 사용하는 이유는?
장기적인 추론과 자율 완결이 속도와 가격보다 중요할 때 Fable 5.1을 사용하세요. 빠르고 일상적인 코딩 루프에는 Sonnet 5가 보통 더 경제적입니다.
결론
Claude Fable 5.1은 작업이 보통의 수정 범위를 넘을 때, 즉 리포지토리 단위의 기능, 어려운 조사, 다중 파일 마이그레이션, 장기적으로 계속 계획·실행·테스트·복구해야 하는 자율 세션에서 Claude Code와 가장 잘 맞습니다.
가장 빠른 네이티브 경로는 /model 또는 claude --model claude-fable-5-1입니다. 통합 API 레이어를 선호한다면, CometAPI는 Claude Fable 5.1을 Anthropic 호환 Messages 엔드포인트로 제공합니다. 어느 경로를 택하든 effort 수준, 범위 통제, 테스트, 최종 diff 리뷰를 모델 구성의 일부로 취급하세요.