DEV Community

Cover image for 클로드 페이블 5와 클로드 코드 사용법
Rihpig
Rihpig

Posted on • Originally published at apidog.com

클로드 페이블 5와 클로드 코드 사용법

Anthropic은 2026년 6월 9일 Claude Fable 5를 출시했습니다. 이 모델의 핵심 사용 사례는 Claude Code에서 개발자들이 기대하는 긴 자율 코딩 세션과 잘 맞습니다. 즉, 대규모 코드베이스 전반에서 맥락을 유지하며 리팩토링, 마이그레이션, 테스트 보강 같은 작업을 오래 실행하는 것입니다. 이미 Claude Code CLI를 사용 중이라면 Fable 5로 전환하는 작업은 간단하지만, 비용과 실행 범위를 함께 관리해야 합니다.

오늘 Apidog를 사용해 보세요

모델 자체를 먼저 이해하고 싶다면 Claude Fable 5란 무엇인가를 참고하십시오. 이 글은 Claude Code에서 Fable 5를 설정하고 검증하는 실무 흐름에 집중합니다.

요약

Claude Code v2.1.170 이상을 설치하고 인증한 뒤, 세션 안에서 다음 명령을 실행하면 됩니다.

/model fable
Enter fullscreen mode Exit fullscreen mode

또는 정확한 모델 ID를 사용할 수 있습니다.

/model claude-fable-5
Enter fullscreen mode Exit fullscreen mode

세션 시작 시점에 지정하려면 다음처럼 실행합니다.

claude --model fable
Enter fullscreen mode Exit fullscreen mode

환경 변수 또는 설정 파일로도 고정할 수 있습니다.

export ANTHROPIC_MODEL=claude-fable-5
claude
Enter fullscreen mode Exit fullscreen mode 
{
  "model": "fable"
}
Enter fullscreen mode Exit fullscreen mode

설정 후에는 반드시 Claude Code 안에서 /status를 실행해 활성 모델을 확인하십시오. Fable 5는 입력 토큰 100만 개당 $10, 출력 토큰 100만 개당 $50로 Opus 4.8의 2배 비용이므로, 긴 자율 실행 전에 작업 범위와 검증 계획을 정해두는 것이 좋습니다.

Claude Code 모델 선택기에서 Fable 5가 강조 표시된 스크린샷

Claude Code를 Fable 5에서 실행해야 하는 경우

Claude Code는 Anthropic의 공식 명령줄 코딩 에이전트입니다. 저장소 파일을 읽고 수정하며, 명령을 실행하고, 터미널에서 여러 단계의 개발 작업을 이어갑니다. 여기서 사용하는 모델은 에이전트가 얼마나 오래 맥락을 유지하며 작업할 수 있는지를 크게 좌우합니다.

Claude Fable 5와 Claude Code의 워크플로우를 보여주는 다이어그램

Anthropic은 Fable 5를 장기 자율 코딩에 맞춰 설계했다고 설명합니다. 발표 내용에 따르면, Fable 5는 장기 실행 작업에서 수백만 개의 토큰에 걸쳐 집중력을 유지하고 자체 노트를 사용해 출력을 개선합니다.

대표 사례로 Anthropic은 Stripe의 테스트를 언급했습니다. Fable 5는 5천만 라인의 Ruby 코드베이스에 대한 마이그레이션을 하루 만에 완료했으며, Stripe는 사람이 수작업으로 진행했다면 팀이 두 달 이상 걸렸을 작업이라고 설명했습니다. 자세한 내용은 Claude Fable 5 발표에서 확인할 수 있습니다.

다만 모든 작업에 Fable 5를 기본값으로 쓰는 것은 권장되지 않습니다. 비용이 높기 때문입니다.

  • Fable 5: 입력 $10/M 토큰, 출력 $50/M 토큰
  • Opus 4.8: 입력 $5/M 토큰, 출력 $25/M 토큰

따라서 Fable 5는 다음과 같은 작업에 적합합니다.

  • 대규모 코드베이스 마이그레이션
  • 여러 모듈에 걸친 API 변경
  • 긴 리팩토링 세션
  • 테스트, 문서, 타입 정의까지 함께 업데이트해야 하는 작업
  • 사람이 직접 처리할 경우 비용이 토큰 비용보다 훨씬 큰 작업

반대로 일상적인 버그 수정, 짧은 함수 수정, 단일 파일 편집에는 Opus 4.8 또는 Sonnet이 더 합리적인 기본값일 수 있습니다. 두 모델을 비교하고 있다면 Claude Fable 5 대 Opus 4.8을 참고하십시오.

Claude Code에서 모델을 바꿔본 적이 있다면 설정 방식은 익숙할 것입니다. Claude Code와 함께 GLM-5.1 실행하기에서 다룬 흐름과 동일하며, 모델 ID만 Fable 5로 바꾸면 됩니다.

선행 조건

Fable 5를 설정하기 전에 다음을 확인하십시오.

1. Claude Code v2.1.170 이상 설치

Fable 5는 Claude Code v2.1.170 이상에서 사용할 수 있습니다. 먼저 버전을 확인합니다.

claude --version
Enter fullscreen mode Exit fullscreen mode

버전이 낮다면 업데이트합니다.

claude update
claude --version
Enter fullscreen mode Exit fullscreen mode

이전 버전에서는 Fable 5가 모델 선택기에 표시되지 않거나 선택할 수 없습니다.

2. Fable 5 접근 권한이 있는 Anthropic 계정

Fable 5는 Anthropic API 및 Max, Team Premium, Enterprise 종량제, 유사 요금제에서 사용할 수 있습니다. 어떤 계정 유형에서도 기본 모델은 아니므로 직접 선택해야 합니다.

3. API 결제 또는 자격 있는 구독

Fable 5는 유료 모델입니다. 계정에 활성 API 결제 또는 해당 모델을 포함하는 요금제가 필요합니다. 최신 모델 및 요금 정보는 Anthropic 모델 개요를 확인하십시오.

4. 작업할 저장소

Claude Code는 프로젝트 디렉토리 안에서 실행됩니다. 작업할 저장소로 이동한 뒤 Claude Code를 시작하십시오.

cd your-repo
claude
Enter fullscreen mode Exit fullscreen mode

5. ZDR 환경 여부 확인

Fable 5는 제로 데이터 보존(ZDR) 환경에서는 사용할 수 없습니다. 조직에서 ZDR을 활성화한 상태로 Claude Code를 실행한다면 Fable 5가 모델 선택기에 표시되지 않거나 비활성화될 수 있습니다. 이는 버그가 아니라 정책 제약입니다.

Claude Code에서 Claude Fable 5 설정하기

Claude Code에서 모델을 선택하는 방법은 네 가지입니다.

우선순위는 다음과 같습니다.

  1. 세션 내 /model
  2. 시작 시 --model 플래그
  3. ANTHROPIC_MODEL 환경 변수
  4. 설정 파일의 model 필드

모델 값은 두 가지 방식으로 지정할 수 있습니다.

fable
Enter fullscreen mode Exit fullscreen mode

또는 정확한 모델 ID를 사용할 수 있습니다.

claude-fable-5
Enter fullscreen mode Exit fullscreen mode

fable 별칭은 공급자가 권장하는 Fable 버전으로 해석되며 시간이 지나면서 업데이트될 수 있습니다. claude-fable-5는 정확히 해당 모델에 고정됩니다. 전체 참조는 Claude Code 모델 구성 문서를 확인하십시오.

옵션 1: /model로 현재 세션에서 전환

가장 빠른 방법입니다. Claude Code 세션 안에서 다음을 입력합니다.

/model fable
Enter fullscreen mode Exit fullscreen mode

정확한 모델 ID로 고정하려면 다음을 사용합니다.

/model claude-fable-5
Enter fullscreen mode Exit fullscreen mode

인수 없이 /model만 입력하면 모델 선택기가 열립니다.

/model
Enter fullscreen mode Exit fullscreen mode

선택기에서 Fable 5를 선택할 수 있습니다. 최신 Claude Code에서는 /model로 모델을 선택하면 사용자 설정에 model 필드가 기록되어 새 세션의 기본값으로 저장됩니다.

동작 방식은 다음과 같습니다.

  • Enter: 현재 세션에서 전환하고 기본값으로 저장
  • s: 현재 세션에서만 전환
  • /model fable: Enter와 동일하게 동작

이미 대화에 출력이 있는 상태에서 모델을 전환하면 Claude Code가 확인을 요청할 수 있습니다. 다음 응답에서 캐시된 컨텍스트 없이 전체 기록을 다시 읽어야 하기 때문입니다. 이는 정상 동작이며, 대화 도중 모델을 바꾸면 한 번의 재읽기 비용이 발생할 수 있습니다.

옵션 2: --model 플래그로 단일 세션 실행

저장된 기본값은 바꾸지 않고 특정 세션만 Fable 5로 실행하려면 시작 시 플래그를 전달합니다.

claude --model fable
Enter fullscreen mode Exit fullscreen mode

또는 전체 모델 ID를 사용합니다.

claude --model claude-fable-5
Enter fullscreen mode Exit fullscreen mode

이 방식은 여러 터미널에서 서로 다른 모델을 동시에 실행할 때 유용합니다.

예를 들어 한 터미널에서는 일반 작업을 Opus로 실행하고, 다른 터미널에서는 대규모 마이그레이션만 Fable 5로 실행할 수 있습니다.

# 터미널 A
claude --model opus

# 터미널 B
claude --model fable
Enter fullscreen mode Exit fullscreen mode

--model 플래그는 해당 명령으로 시작한 세션에만 적용됩니다.

옵션 3: ANTHROPIC_MODEL 환경 변수 사용

쉘 단위로 Fable 5를 사용하려면 환경 변수를 설정한 뒤 Claude Code를 실행합니다.

export ANTHROPIC_MODEL=claude-fable-5
claude
Enter fullscreen mode Exit fullscreen mode

현재 터미널 세션에서만 적용하고 싶다면 한 줄로 실행할 수도 있습니다.

ANTHROPIC_MODEL=claude-fable-5 claude
Enter fullscreen mode Exit fullscreen mode

ANTHROPIC_MODEL은 해당 변수 아래에서 시작된 세션에 적용됩니다.

주의할 점은 우선순위입니다. ANTHROPIC_MODEL을 쉘에서 export하고 settings.json의 env 블록에도 설정했다면, 쉘 export가 우선합니다. 설정 파일의 env 객체는 시작 시 적용되지만 기존 쉘 변수를 덮어쓰지 않습니다.

옵션 4: 설정 파일에 Fable 5 고정

Fable 5를 기본 모델로 계속 사용하려면 설정 파일의 model 필드를 지정합니다.

사용자 설정 파일:

~/.claude/settings.json
Enter fullscreen mode Exit fullscreen mode

프로젝트 설정 파일:

.claude/settings.json
Enter fullscreen mode Exit fullscreen mode

개인 로컬 프로젝트 설정 파일:

.claude/settings.local.json
Enter fullscreen mode Exit fullscreen mode

최소 설정은 다음과 같습니다.

{
  "model": "claude-fable-5"
}
Enter fullscreen mode Exit fullscreen mode

별칭도 사용할 수 있습니다.

{
  "model": "fable"
}
Enter fullscreen mode Exit fullscreen mode

프로젝트 및 관리 설정은 다음 시작 시 다시 적용될 수 있습니다. 따라서 사용자가 /model로 다른 모델을 선택했더라도 프로젝트 설정이 더 높은 우선순위를 가진다면 재시작 후 프로젝트 기본값이 다시 적용됩니다.

팀 단위로 모델을 표준화해야 하는 경우 이 방식이 적합합니다.

Fable 5를 사용 중인지 확인하기

긴 작업을 시작하기 전에 반드시 활성 모델을 확인하십시오. 비용이 높은 모델이므로 추측으로 진행하면 안 됩니다.

방법 1: /status 실행

Claude Code 세션 안에서 다음을 실행합니다.

/status
Enter fullscreen mode Exit fullscreen mode

/status는 계정 정보와 함께 현재 활성 모델을 표시합니다. Fable 5가 실제로 적용됐는지 확인하는 가장 확실한 방법입니다.

방법 2: 상태 줄 확인

상태 줄을 구성해두었다면 활성 모델을 계속 표시할 수 있습니다. 긴 세션을 자주 실행한다면 상태 줄에 모델명을 표시해두는 것이 좋습니다.

Fable 5가 적용되지 않을 때 확인할 것

Fable을 선택했는데 /status에서 Opus 4.8이 보인다면 다음을 확인하십시오.

1. 프로젝트 또는 관리 설정이 덮어쓰는지 확인

시작 시 활성 모델이 프로젝트 또는 관리 설정에서 지정된 경우, Claude Code 시작 헤더에 어떤 설정 파일이 모델을 설정했는지 표시됩니다.

현재 세션에서만 바꾸려면 다시 실행합니다.

/model fable
Enter fullscreen mode Exit fullscreen mode

다만 프로젝트 설정이 유지되는 한 다음 시작 시 다시 프로젝트 기본값이 적용될 수 있습니다.

2. 안전 분류기 폴백 여부 확인

Fable 5는 사이버 보안 및 생물학 콘텐츠에 대해 안전 분류기를 실행합니다. 요청이 분류기에 의해 플래그되면 Claude Code는 자동으로 기본 Opus 모델, Anthropic API 기준 Opus 4.8에서 요청을 다시 실행하고 알림을 표시합니다.

즉, Fable 5를 선택했더라도 일부 개별 요청은 Opus 4.8에서 실행될 수 있습니다.

Anthropic은 Fable 세션의 95% 이상에서 폴백이 발생하지 않는다고 보고하므로 일반적인 애플리케이션 코드에서는 드문 편입니다. 하지만 가끔 “Opus로 전환됨” 알림이 보일 수 있습니다.

폴백 이후 Fable 5로 되돌리려면 다시 실행합니다.

/model fable
Enter fullscreen mode Exit fullscreen mode

긴 Fable 5 세션을 실행하기 전 체크리스트

Fable 5는 짧은 프롬프트보다 긴 실행에서 가치가 큽니다. 하지만 긴 실행일수록 작업 범위를 명확히 해야 합니다.

실행 전 Claude Code에 다음 정보를 제공하십시오.

목표:
- 기존 /v1/orders API를 /v2/orders 구조로 마이그레이션
- 기존 테스트는 유지
- OpenAPI 문서도 함께 업데이트

제약:
- 공개 응답 필드명은 변경하지 말 것
- DB 마이그레이션은 생성하지 말 것
- 변경 전후 테스트 결과를 요약할 것

검증:
- npm test 실행
- npm run lint 실행
- 변경된 엔드포인트 목록 작성
Enter fullscreen mode Exit fullscreen mode

긴 자율 실행에서는 다음을 권장합니다.

  • 작업 범위를 파일 또는 모듈 단위로 제한
  • “먼저 계획을 출력하고 승인 후 수정”하도록 요청
  • 테스트 명령을 명시
  • OpenAPI 또는 API 문서 업데이트를 명시
  • 마지막에 변경 요약과 검증 결과를 요구

예시 프롬프트:

이 저장소에서 billing 모듈의 API 응답 타입을 정리해줘.

진행 방식:
1. 먼저 변경 계획을 작성해줘.
2. 내가 승인하기 전에는 파일을 수정하지 마.
3. 승인 후 구현, 테스트, OpenAPI 문서 업데이트를 진행해줘.
4. 마지막에 변경 파일, 실행한 명령, 실패/성공한 테스트를 요약해줘.
Enter fullscreen mode Exit fullscreen mode

비용 관리 팁

Fable 5는 Opus 4.8보다 2배 비쌉니다. 따라서 다음 기준으로 사용 여부를 결정하십시오.

Fable 5를 사용할 만한 경우:

  • 작업이 여러 시간 또는 여러 단계에 걸침
  • 대규모 코드베이스 맥락 유지가 중요함
  • 사람이 수동으로 처리할 비용이 큼
  • 리팩토링, 테스트, 문서 업데이트를 한 번에 처리해야 함

다른 모델이 더 나은 경우:

  • 단일 함수 수정
  • 짧은 코드 리뷰
  • 간단한 테스트 추가
  • 소규모 버그 수정
  • 빠른 질문 또는 설명 요청

실무에서는 다음처럼 모델을 나누는 방식이 효율적입니다.

# 일반 작업
claude --model opus

# 장기 마이그레이션 또는 대규모 리팩토링
claude --model fable
Enter fullscreen mode Exit fullscreen mode

Claude Code와 Apidog 연결

Claude Code가 API 코드를 작성하거나 수정했다면 다음 단계는 실제 엔드포인트 검증입니다. 긴 자율 실행은 여러 라우트, 스키마, 테스트 파일을 동시에 변경할 수 있습니다. diff를 읽는 것만으로는 API가 실제로 올바른 응답을 반환하는지 확인하기 어렵습니다.

이때 Apidog를 함께 사용하면 Claude Code의 코드 변경을 실제 API 요청으로 검증할 수 있습니다.

Claude Code가 코드를 생성하고 Apidog가 API 유효성 검사를 수행하는 워크플로우 다이어그램

권장 워크플로우는 다음과 같습니다.

1. Claude Code에 OpenAPI 사양 업데이트 요청

프로젝트에 OpenAPI 문서가 있다면 구현 변경과 함께 사양도 업데이트하도록 요청합니다.

예시:

변경한 API에 맞춰 OpenAPI 문서도 업데이트해줘.
새로 추가되거나 변경된 경로, 요청 파라미터, 응답 스키마를 모두 반영해줘.
Enter fullscreen mode Exit fullscreen mode

OpenAPI 문서가 없다면 변경된 경로에 대한 사양을 생성하도록 요청할 수 있습니다.

이번에 변경한 엔드포인트에 대한 OpenAPI 3.0 사양을 생성해줘.
요청 파라미터, 요청 본문, 응답 예시, 오류 응답을 포함해줘.
Enter fullscreen mode Exit fullscreen mode

2. Apidog로 OpenAPI 사양 가져오기

Apidog에서 프로젝트를 생성하거나 기존 프로젝트를 연 뒤 OpenAPI 파일을 가져옵니다.

Apidog는 다음 정보를 읽어 실행 가능한 API 요청으로 변환합니다.

  • 경로
  • HTTP 메서드
  • 요청 파라미터
  • 요청 본문
  • 응답 스키마

이렇게 하면 URL과 요청 구조를 수동으로 다시 입력할 필요가 없습니다.

3. 변경된 요청 실행

로컬 또는 스테이징 서버를 대상으로 변경된 엔드포인트를 실행합니다.

확인할 항목은 다음과 같습니다.

  • HTTP 상태 코드
  • 응답 헤더
  • 응답 본문
  • 오류 응답 형식
  • 인증 필요 여부
  • 기존 클라이언트와의 호환성

4. 스키마 기준으로 응답 검증

Apidog에서 응답이 OpenAPI 스키마를 따르는지 확인합니다. 이는 코드가 실제로 반환하는 값과 API 계약이 약속한 값 사이의 차이를 찾는 데 유용합니다.

특히 Claude Code가 빠르게 여러 파일을 수정한 경우 다음 문제가 생길 수 있습니다.

  • 구현은 바뀌었지만 OpenAPI 문서가 누락됨
  • 응답 필드 타입이 문서와 다름
  • 필수 필드가 실제 응답에서 빠짐
  • 오류 응답 구조가 기존 계약과 달라짐

5. 요청을 테스트 케이스로 저장

엔드포인트 검증이 끝나면 요청을 회귀 테스트 케이스로 저장합니다. 다음에 Claude Code 또는 다른 개발자가 같은 API를 수정할 때 테스트 스위트를 다시 실행해 문제를 빠르게 확인할 수 있습니다.

Fable 5처럼 장기 자율 실행에 강한 모델을 사용할수록 검증 범위도 커집니다. Apidog의 실행 가능한 테스트 스위트는 “에이전트가 완료했다고 말한 상태”를 “엔드포인트가 실제로 동작하는 것이 확인된 상태”로 바꾸는 데 도움이 됩니다.

Apidog를 다운로드하고 기존 OpenAPI 사양을 가져와 바로 검증을 시작할 수 있습니다.

Top comments (0)