Anthropic은 2026년 6월 9일 Claude Fable 5를 출시했으며, 핵심 사용 사례는 대부분의 개발자들이 Claude Code를 통해 얻고자 하는 작업과 정확히 일치합니다. 즉, 전체 코드베이스에 걸쳐 형태를 유지하는 길고 자율적인 코딩 세션입니다. 일상적인 엔지니어링을 위해 이미 Claude Code CLI를 사용하고 있다면, 새 모델로 전환하는 것은 작은 구성 변경으로도 큰 행동적 차이를 가져옵니다. 이 가이드는 Claude Fable 5를 Claude Code와 함께 처음부터 끝까지 실행하는 과정을 안내하며, 모델 선택부터 사용 확인, 긴 자율 실행 튜닝, 그리고 비용 관리까지 다룹니다. 이 가이드가 끝날 때쯤이면 모델을 설정하는 모든 지원 방식과 이를 확인하는 방법, 그리고 Opus 4.8에 비해 2배 높은 비용을 지불할 가치가 있는 경우를 알게 될 것입니다.
무언가를 구성하기 전에 모델 자체에 대한 더 깊은 이해를 원한다면, Claude Fable 5란 무엇인가를 참조하십시오. 이 문서는 Claude Code 워크플로우에 초점을 맞춥니다.
요약
Claude Code (v2.1.170 이상)를 설치하고 인증한 다음, 세션 내 명령 /model fable 또는 /model claude-fable-5를 사용하여 모델을 Fable 5로 설정하십시오. claude --model fable로 시작하거나, ANTHROPIC_MODEL=claude-fable-5를 내보내거나, 설정 파일에 "model": "fable"을 고정할 수도 있습니다. /status로 확인하십시오. Fable 5는 입력 토큰당 $10/M, 출력 토큰당 $50/M로 Opus 4.8의 2배이므로, 긴 세션은 신중하게 계획하십시오.
Claude Code를 Fable 5에서 실행해야 하는 이유
Claude Code는 Anthropic의 공식 명령줄 코딩 에이전트입니다. Anthropic 모델에서 실행되며, 저장소의 파일을 편집하고, 명령을 실행하며, 터미널에서 여러 단계의 작업을 구동합니다. 그 뒤에 있는 모델은 스레드를 잃기 전까지 얼마나 멀리 실행될 수 있는지에 대한 상한선을 설정하며, 바로 이 지점에서 Fable 5가 계산을 바꿉니다.
Anthropic은 장기 자율 코딩을 위해 Fable 5를 구축했습니다. Anthropic의 설명에 따르면, 이 모델은 "장기 실행 작업에서 수백만 개의 토큰에 걸쳐 집중력을 유지하며 자체 노트를 사용하여 출력을 개선합니다." 이는 빠른 리팩토링과는 다른 형태의 작업입니다. Anthropic이 발표한 증명은 Stripe가 테스트 중에 실행한 마이그레이션입니다. Fable 5는 5천만 라인의 Ruby 코드베이스 전체 변경을 단 하루 만에 완료했으며, 이는 회사가 수작업으로 하면 팀이 두 달 이상 걸렸을 작업이라고 말했습니다. 전체 내용은 Claude Fable 5 발표에서 읽을 수 있습니다.
절충점은 가격입니다. Fable 5는 입력 토큰당 1백만 개당 $10, 출력 토큰당 1백만 개당 $50로 책정되어 있으며, 이는 Opus 4.8의 $5 및 $25의 두 배입니다. 따라서 "Claude Code를 항상 Fable 5에서 실행해야 하는가"에 대한 솔직한 답변은 '아니오'입니다. 작업이 진정으로 장기적이고 인간이 동일한 작업을 수행하는 비용이 토큰 비용보다 훨씬 클 때만 실행하십시오. 일상적인 편집의 경우, Opus 4.8 또는 Sonnet이 더 나은 기본값입니다. 둘을 직접 비교하고 있다면, Claude Fable 5 대 Opus 4.8에서 각각의 장점을 분석합니다.
이는 이전에 Claude Code에서 모델을 교체해 본 경험이 있다면 익숙한 과정일 것입니다. 여기의 메커니즘은 Claude Code와 함께 GLM-5.1 실행하기에서 다룬 것과 동일하며, 모델 ID만 변경됩니다.
선행 조건
모델을 설정하기 전에 다음 사항을 갖추고 있는지 확인하십시오:
- Claude Code가 설치 및 업데이트되었습니다. Fable 5는 Claude Code v2.1.170 이상을 요구합니다. 이전 버전에서는 Fable 5가 모델 선택기에 표시되지 않으며 선택할 수 없습니다.
claude update를 실행하여 업그레이드한 다음,claude --version으로 확인하십시오. - Fable 5 접근 권한이 있는 Anthropic 계정. Anthropic API 및 Max, Team Premium, Enterprise 종량제, 유사 요금제에서는 Fable 5를 선택하는 즉시 사용할 수 있습니다. 어떤 계정 유형에서도 기본값이 아니므로 항상 선택해야 합니다.
- API 결제 또는 자격 있는 구독. Fable 5는 1백만 토큰당 $10/$50의 유료 모델이므로, 계정에 활성 API 결제 또는 이를 포함하는 요금제가 필요합니다. 현재 등급은 Anthropic 모델 개요에서 확인하십시오.
- 작업할 저장소. Claude Code는 프로젝트 디렉토리 내에서 작동합니다. 에이전트가 작업할 저장소에서 터미널을 여십시오.
미리 알아두면 좋은 한 가지 주의사항: Fable 5는 제로 데이터 보존(ZDR) 환경에서는 사용할 수 없습니다. 조직에서 ZDR이 활성화된 상태로 Claude Code를 실행하는 경우, 모델 선택기에서 Fable 5가 아예 없거나 비활성화된 상태로 표시됩니다. 이는 정책 제약이지 버그가 아닙니다.
Claude Code가 Claude Fable 5를 사용하도록 설정
Claude Code는 모델을 선택하는 네 가지 방법을 제공하며, 이들은 세션 시작 시 특정 우선순위에 따라 적용됩니다. 세션 내 /model 선택, --model 시작 플래그, ANTHROPIC_MODEL 환경 변수, 그리고 설정 파일의 model 필드 순으로 우선순위가 높습니다. 다음은 Fable 5 값과 함께 각 방법입니다.
모델이 허용되는 모든 곳에서 fable 별칭 또는 전체 모델 이름 claude-fable-5를 사용할 수 있습니다. 별칭은 공급자에 권장되는 Fable 버전으로 확인되며 시간이 지남에 따라 업데이트됩니다. 전체 ID는 해당 정확한 모델에 고정됩니다. 전체 Claude Code 참조는 Claude Code 모델 구성 문서에 있습니다.
옵션 1: /model로 세션 내 전환
이것이 가장 빠른 경로이며 대부분의 사람들이 사용하는 방법입니다. 실행 중인 Claude Code 세션 내에서 다음을 입력하십시오:
/model fable
또는 별칭 대신 정확한 모델 ID를 고정하려면:
/model claude-fable-5
인수 없이 /model을 실행하면 선택기가 열리고, 거기서 목록에서 Fable 5를 선택할 수 있습니다. 최신 버전부터는 /model로 모델을 선택하면 사용자 설정에 model 필드를 작성하여 새 세션의 기본값으로 저장됩니다. 선택기에서 Enter를 누르면 전환되고 기본값으로 저장되며, s를 누르면 현재 세션에서만 전환됩니다. /model fable을 직접 입력하는 것은 Enter와 동일하게 작동하므로, 모델을 변경할 때까지 다음 세션은 Fable 5로 시작됩니다.
대화에 이미 출력이 있는 경우, 다음 응답이 캐시된 컨텍스트 없이 전체 기록을 다시 읽기 때문에 선택기는 전환하기 전에 확인을 요청합니다. 이는 예상된 동작입니다. 대화 도중 모델을 전환하면 한 번의 재읽기 비용이 발생합니다.
옵션 2: --model 플래그로 시작
저장된 기본값을 변경하지 않고 Fable 5에서 단일 세션을 시작하려면, 시작할 때 플래그를 전달하십시오:
claude --model fable
또는 전체 ID를 사용하여:
claude --model claude-fable-5
--model 플래그는 해당 플래그로 시작된 세션에만 적용됩니다. 이는 여러 터미널에서 동시에 다른 모델을 실행하는 가장 깔끔한 방법입니다. 공유 기본값을 작성할 /model로 전환하는 대신 각 창에 자체 --model 플래그를 지정하십시오.
옵션 3: ANTHROPIC_MODEL 환경 변수 설정
쉘에서 Fable 5로 세션을 시작하려면, 시작하기 전에 변수를 내보내십시오:
export ANTHROPIC_MODEL=claude-fable-5
claude
플래그와 마찬가지로 ANTHROPIC_MODEL은 해당 변수 아래에서 시작된 세션에만 적용됩니다. 한 가지 우선순위 세부 사항을 명확히 해야 합니다. ANTHROPIC_MODEL을 쉘 내보내기와 settings.json의 env 블록 내부에 모두 설정하는 경우, 쉘 내보내기가 우선합니다. 설정 env 객체는 시작 시 적용되지만, 기존 쉘 변수를 덮어쓰지 않기 때문입니다.
옵션 4: 설정 파일에 고정
Fable 5를 세션 전체에 걸쳐 영구적인 기본값으로 만들려면, 설정 파일의 model 필드를 설정하십시오. 사용자 설정은 ~/.claude/settings.json에 있으며, 프로젝트 범위 설정은 .claude/settings.json(또는 우선순위가 더 높지만 자신에게만 적용되는 .claude/settings.local.json)에 있습니다. 최소한의 설정 파일은 다음과 같습니다:
{
"model": "claude-fable-5"
}
여기서도 별칭이 작동합니다:
{
"model": "fable"
}
프로젝트 및 관리 설정은 우선하며 다음 시작 시 다시 적용됩니다. 따라서 팀원의 /model 선택이 프로젝트 기본값과 다를 경우, 재시작 시 프로젝트 설정이 우선합니다. 이것이 기업이 한 팀을 하나의 모델로 표준화하는 메커니즘입니다.
Fable 5를 사용 중인지 확인
전환이 성공했다고 가정하지 마십시오. 비용이 많이 드는 긴 실행을 시작하기 전에 활성 모델을 확인하십시오. 두 가지 신뢰할 수 있는 방법이 있습니다:
/status실행. Claude Code 세션 내에서/status는 계정 정보와 함께 활성 모델을 표시합니다. 이것이 결정적인 확인 방법입니다.- 상태 줄 읽기. 상태 줄이 구성되어 있다면, 활성 모델이 지속적으로 표시되므로 메뉴를 열지 않고도 한눈에 확인할 수 있습니다.
Fable을 선택한 직후 /status가 Fable 5 대신 Opus 4.8을 표시한다면, 가장 흔한 원인은 프로젝트 또는 관리 설정이 시작 시 사용자의 선택을 무시했기 때문입니다. 시작 시 활성 모델이 프로젝트 또는 관리 설정에서 오는 경우, 시작 헤더는 어떤 설정 파일이 이를 설정했는지 알려줍니다. /model을 실행하여 세션에 대해 재정의하십시오. 프로젝트 설정은 다음 시작 시 다시 적용됩니다.
두 번째로 주의해야 할 점: Fable 5는 사이버 보안 및 생물학 콘텐츠에 대한 안전 분류기를 실행합니다. 분류기가 요청에 플래그를 지정하면, Claude Code는 자동으로 기본 Opus 모델(Anthropic API의 Opus 4.8)에서 다시 실행하고 스크립트에 알림을 표시합니다. 따라서 Fable 5를 선택한 후에도 개별 요청은 조용히 Opus 4.8에서 실행될 수 있습니다. Anthropic은 Fable 세션의 95% 이상에서 폴백이 발생하지 않는다고 보고하므로, 일반적인 애플리케이션 코드에서는 드물지만, 이따금 "Opus로 전환됨" 알림이 표시되는 이유를 설명합니다. 폴백 후 Fable 5로 돌아가려면, /model fable을 다시 실행하십시오.
Claude Code와 Apidog 연결
Claude Code가 API 작성을 마치거나 편집을 완료하면, 다음 질문은 엔드포인트가 실제로 작동하는지 여부입니다. 긴 자율 실행은 수십 개의 경로를 건드릴 수 있으며, diff를 읽는 것만으로는 API가 반환해야 할 것을 반환하는지 확인하는 것과 다릅니다. 이 지점에서 Apidog가 루프에 깔끔하게 들어맞습니다. Claude Code는 코드를 작성하고, Apidog는 라이브 동작을 검증합니다.
다음은 API를 변경한 Claude Code 세션 이후의 구체적인 워크플로우입니다:
- Claude Code가 OpenAPI 사양을 발행하거나 업데이트하도록 합니다. 프로젝트에 OpenAPI 문서가 있는 경우, 에이전트에게 구현과 함께 업데이트하도록 요청하십시오. 없는 경우, 변경된 경로에 대한 사양을 생성하도록 요청하십시오. 사양은 코드와 테스트 도구 간의 가장 깔끔한 핸드오프입니다.
- Apidog로 사양을 가져옵니다. Apidog에서 프로젝트를 생성하거나 열고 OpenAPI 파일을 가져옵니다. Apidog는 경로, 메서드, 매개변수 및 스키마를 읽고 각 엔드포인트를 실행 가능한 요청으로 변환하므로, URL을 수동으로 입력할 필요가 없습니다.
- 요청을 실행합니다. 변경된 엔드포인트를 로컬 또는 스테이징 서버에 대해 실행합니다. 실제 요청을 보내고, 상태 코드, 헤더 및 본문을 검사하고, 응답이 코드가 반환해야 할 것과 일치하는지 확인합니다.
- 스키마에 대해 응답을 검증합니다. Apidog는 각 응답이 사양의 스키마를 준수하는지 확인할 수 있습니다. 이는 코드가 반환하는 것과 계약이 약속하는 것 사이의 격차를 포착하며, 이는 빠르고 자동화된 변경이 초래할 수 있는 종류의 불일치입니다.
- 요청을 테스트 케이스로 저장합니다. 엔드포인트가 통과되면, 요청을 회귀 테스트 스위트로 유지합니다. 다음에 Claude Code 또는 다른 누군가가 이 경로들을 건드릴 때, 스위트를 다시 실행하여 문제가 발생했는지 즉시 확인할 수 있습니다.
이러한 페어링은 장기 모델에서 더욱 중요합니다. 자율 변경이 클수록 검증해야 할 표면적이 넓어지며, Apidog의 실행 가능한 테스트 스위트는 "에이전트가 완료했다고 함"을 "엔드포인트가 작동하는 것이 확인됨"으로 바꿉니다. Apidog를 다운로드하고 기존 사양을 몇 분 안에 가져올 수 있습니다.