Claude Fable 5.1 완벽 가이드: 진화, 토큰 절약 및 스킬 구축

진화, 토큰 절약, 프롬프트, 하네스, 스킬 구축

2026년 9월 1일, Anthropic은 "Claude Fable 5.1"을 출시했습니다. 제가 이 글을 쓰고 있는 2026년 9월 2일 기준으로 출시된 지 불과 하루밖에 지나지 않았습니다. 따라서 소셜 미디어의 주관적인 리뷰보다는 Anthropic의 공식 문서, API 문서, 최신 Claude Code 사양을 바탕으로 정보를 정리하겠습니다.

결론부터 말씀드리자면, Fable 5.1은 단순히 "일반 질문에 조금 더 똑똑하게 답하는 모델"이 아닙니다.

그 본질은 목표를 놓치지 않고 몇 시간에서 며칠에 걸친 작업을 처리하고, 표면적인 문제가 아닌 근본 원인까지 파고들며, 최종까지 자체 출력을 검증하는 능력에 있습니다.

하지만 가격은 Opus 5의 2배, Sonnet 5의 5배입니다. 게다가 내부 사고(Thinking)를 끌 수 없습니다. Fable 5.1에 모든 것을 던져버리면, 그 능력을 제대로 활용하기도 전에 사용 한도와 예산을 소진하게 됩니다.

Fable 5.1을 마스터하는 핵심은 훌륭한 프롬프트를 작성하는 것만이 아닙니다.

바로 Fable에 어떤 특정 작업을 할당하고, 어떤 정보를 로드하며, 어떤 프로세스를 더 저렴한 모델이나 스크립트에 오프로드할지 설계하는 것입니다.

파트 1: Claude Fable 5.1 완벽 설명

1. Claude Fable 5.1이란?

Claude Fable 5.1은 Anthropic이 대중에게 공개한 모델 중 최고 성능 모델로 자리매김했습니다.

Fable 5.1과 초대 전용인 Claude Mythos 5.1은 본질적으로 동일한 모델입니다. 차이는 주로 안전 조치에 있습니다. 공개용 Fable에는 사이버 보안, 생명 과학, 화학과 같은 고위험 영역을 탐지하는 강력한 분류기가 포함되어 있습니다. 반면 Mythos는 검증된 조직에서 방어 연구 등의 목적으로 사용됩니다. (Anthropic

주요 사양은 다음과 같습니다.

개인 Claude 사용자의 경우 Pro, Max, Team, Enterprise 사용자가 사용할 수 있습니다. API에서는 특별 심사 없이 일반 고객이 사용할 수 있습니다. (Claude Platform

100만 토큰 컨텍스트는 간단히 계산하면 한 번에 수 권에서 수십 권의 책, 대규모 코드베이스 또는 장기 대화 기록을 처리할 수 있습니다.

하지만 "100만 토큰을 담을 수 있다"는 것과 "100만 토큰을 넣어야 한다"는 것은 다릅니다.

관련 없는 파일, 오래된 대화, 긴 로그를 많이 집어넣을수록 중요한 정보가 묻힙니다. Fable 5.1이 대규모 컨텍스트를 처리할 수 있지만, 관련 없는 컨텍스트를 자동으로 중립화해주지는 않습니다.

2. Fable 5.1의 진화는 "더 오래 일하는 것"

Fable 5.1의 가장 중요한 진화는 단발성 정확도가 아니라, 장기 에이전트 작업 중 일관성을 유지하는 능력입니다.

일반 AI 에이전트는 작업이 길어질수록 다음과 같은 문제를 일으키는 경향이 있습니다.

• 초기 목표를 망각함.
• 원인을 조사하지 않고 증상만 해결함.
• 동일한 파일이나 웹 페이지를 반복해서 읽음.
• 작업 도중 임의로 규모를 축소함.
• "다음에 테스트하겠습니다"라고 말하고 그냥 끝냄.
• 대규모 변경을 했지만 최종 작동 점검을 수행하지 않음.

Fable 5.1은 장시간 작업 중 이러한 고장을 개선하는 데 중점을 둡니다. 공식 설명에서는 코딩, 브라우저 조작, 리서치, 몇 시간에서 며칠에 걸친 문서/스프레드시트/슬라이드 생성을 주요 사용 사례로 언급합니다. 실패한 단계에서 복구하고, 우선순위를 재조정하며, 자체 작업 로그를 유지하면서 진행하도록 설계되었습니다. (Anthropic

초기 도입 기업들은 다음과 같은 사례를 보고했습니다.

MongoDB에서는 서비스 코드와 문서를 조사하여 새로운 디자인을 만들고, 몇 시간의 자율 실행을 통해 약 3일 만에 복잡한 프로토타입을 완성했다고 합니다. Ramp에서는 머신러닝 문제에 대해 38시간 연속으로 운영되면서 과거 결과의 레이블링 문제를 발견하고, 이를 수정한 후 6개의 실험을 병렬로 실행했습니다. (Anthropic

또한 Millennium의 사례에서는 백만 번에 한 번만 발생하는 크래시에 대해 모델이 외부 라이브러리를 분해하고 코어 덤프와 교차 참조하여 수년간 발견되지 않았던 원인에 도달했다고 보고되었습니다. 이는 공식 페이지의 고객 사례로, 독립 기관이 재현한 결과는 아니지만 Fable 5.1이 지향하는 방향을 분명히 보여줍니다. (Anthropic

요컨대, Fable 5.1은 "코드를 많이 작성하는 AI"라기보다는 다음과 같은 존재에 가깝습니다.

어려운 문제를 분리하고, 필요한 정보를 수집하며, 여러 방법을 시도하고, 증거를 확인한 후 최종적으로 결과를 정리하는 책임감 있는 리드 개발자.

3. 벤치마크에서 무엇이 개선되었는가?

Anthropic이 공개한 주요 점수에 따르면, Fable 5.1은 장기 에이전트, 과학 연구, 비즈니스 자동화에서 상당한 성장을 보였습니다.

과학적 터미널 작업을 측정하는 Terminal-Bench-Science 0.1에서는 Fable 5의 24.7%에서 52.6%로 상승했습니다. 일반 에이전트 코딩을 측정하는 Terminal-Bench 4.0에서는 Fable 5의 42.0%에 비해 55.8%를 기록했습니다. 안전 제한이 다른 Mythos 5.1은 60.9%를 기록했습니다.

비즈니스 자동화를 측정하는 AutomationBench에서는 Fable 5의 17.1%에서 31.4%로 상승했습니다. CursorBench 3.2에서 Fable 5.1은 73.4%를 기록했으며, Fable 5는 70.5%, Opus 5는 70.0%를 기록했습니다.

또한 여러 분야의 고급 추론을 측정하는 Humanity's Last Exam에서는 도구 없이 60.9%, 도구 사용 시 65.0%를 기록했습니다. (Anthropic

하지만 이러한 수치를 읽을 때는 주의가 필요합니다.

이는 Anthropic이 발표한 평가 결과입니다. 게다가 Fable은 프로덕션 안전 분류기가 활성화되어 있어, 분류기가 개입한 문제에서는 점수가 0이 되거나 프로세스가 다른 모델로 전환될 수 있습니다. 따라서 Fable과 Mythos의 차이에는 순수한 모델 성능 차이뿐만 아니라 안전 설정 차이도 포함될 수 있습니다. (Anthropic

또한 출시 다음 날 시점에서는 벤치마크 1위보다 실제 업무에서의 "작업 완료율"이 더 중요합니다.

예를 들어, 기사 제작에서는 텍스트 평가만으로는 충분하지 않습니다.

• 1차 출처를 바탕으로 사실을 확인했는가?
• 지정된 글자 수를 준수했는가?
• 중복과 모순을 제거했는가?
• 인용과 요약을 구분했는가?
• 제목부터 결론까지 일관성이 있는가?

이러한 실용적인 평가를 준비하지 않으면, 비싼 Fable을 사용해도 오래 생각만 하고 더 나은 결과를 내지 못할 수 있습니다.

4. Adaptive Thinking이 이제 항상 켜져 있습니다

Fable 5.1에서는 Adaptive Thinking이 항상 켜져 있습니다.

이전 모델과 달리 Thinking을 완전히 비활성화할 수 없습니다. API에서 thinking: {type: "disabled"}를 지정하면 오류가 발생합니다. 인간이 고정된 Thinking 토큰 수를 지정하는 방식도 사용할 수 없으며, 모델 자체가 문제에 따라 Thinking 양을 조정합니다. (Claude Platform

사용자가 조정하는 것은 "노력(Effort)"입니다.

5가지 수준을 사용할 수 있습니다.

• low
• medium
• high
• xhigh
• max

기본값은 high입니다.

공식 권장 사항은 high로 시작한 후 실제 평가 결과에 따라 낮추거나 높이는 것입니다. 일상적인 처리에는 medium 또는 low를 사용하고, 매우 어려운 설계, 디버깅, 리서치 또는 장기 에이전트 작업에만 xhigh 또는 max를 사용하십시오.

Fable 5.1은 medium에서도 기존 Fable 5에 가까운 성능을 내며, low에서는 특정 작업에 대해 소형 모델을 high 노력으로 실행하는 것보다 작업당 비용 효율이 더 높을 수 있다고 합니다. (Claude Platform

여기서 중요한 점은 내부 Thinking도 출력 토큰으로 청구되며 max_tokens을 소비한다는 것입니다.

예를 들어, 화면에 표시되는 최종 원고가 10,000 토큰이더라도, 그 전에 10,000 토큰에 해당하는 Thinking을 사용했다면 총 20,000 토큰이 출력 측면에서 청구됩니다. Fable의 출력 단가는 100만 토큰당 $50이므로, max를 불필요하게 사용하면 소비가 급격히 증가합니다. (Claude Platform

Fable 5.1은 "노력이 높을수록 항상 이익"인 모델이 아닙니다.

텍스트 서식 지정이나 요약에 max를 사용하면 모델이 내부적으로 초안을 작성한 후 응답 필드에 다시 작성하는 경우가 늘어날 수 있습니다. Anthropic은 또한 긴 결과물의 경우 원칙적으로 high를 사용하고, 품질 향상을 측정할 수 있는 경우에만 xhigh 이상으로 업그레이드하라고 조언합니다. (Claude Platform

5. 높은 가격, 그러나 매우 저렴한 캐싱

Fable 5.1의 표준 요금은 입력 100만 토큰당 $10, 출력 100만 토큰당 $50입니다.

Opus 5가 $5/$25, Sonnet 5가 $2/$10이므로, 단순 토큰 가격 기준으로 Fable은 Opus의 2배, Sonnet의 5배 가격입니다. (Claude Platform Docs

반면, Fable 5.1의 주요 변경 사항은 캐시 읽기 가격입니다.

Fable 5에서는 100만 토큰당 $1이었지만, Fable 5.1에서는 $0.25가 되었습니다. 이는 일반 입력 가격의 2.5%입니다. Anthropic은 일반적인 처리에서 기존 Fable 대비 약 25%, 캐시를 반복해서 읽는 에이전트 처리에서는 최대 약 45%의 비용 절감 효과가 있을 것으로 추정합니다. (Anthropic

예를 들어, 매번 100,000 토큰의 고정 컨텍스트를 읽는 경우, 일반 입력 요금으로는 한 번에 $0.10이 들지만 캐시 히트 시에는 $0.0025에 불과합니다.

즉, 동일한 프로젝트 설명, 도구 정의, 코드베이스 전제 조건, 대화 기록을 안정적인 형태로 반복해서 읽는 작업이 더 유리합니다.

반대로, 시스템 프롬프트를 매번 다시 작성하거나, 도구 목록을 재정렬하거나, 오래된 대화를 삭제하고 재구성하는 사용 방식은 캐시를 깨뜨립니다.

Fable 5.1에서는 깨지지 않는 프롬프트 구조가 훌륭한 프롬프트보다 비용에 더 직접적인 영향을 미칩니다.

6. Fable 5.1은 기존 API 하네스를 깨뜨릴 수 있습니다

Fable 5 또는 Opus에서 모델 이름만 변경할 때 특히 주의해야 할 세 가지 사항이 있습니다.

강제 도구 호출 불가

tool_choice에서 any 또는 특정 도구 이름을 강제로 지정하면 400 오류가 발생합니다.

그 이유는 도구 호출을 강제하면 모델이 정상적인 사고 프로세스를 건너뛰고 도구 인수 내에서 사고를 시작하여 인수 품질이 저하되기 때문입니다.

대신 tool_choice: auto를 사용하고 프롬프트 내에서 "이 프로세스에는 XX 도구를 사용하십시오"라고 명시적으로 명시하십시오. JSON 형식을 보장하려면 strict: true 또는 Structured Outputs를 사용하십시오. (Claude Platform

대화 기록을 중간에 다시 작성해서는 안 됩니다

Fable 5.1의 Thinking 블록은 해당 Thinking이 생성될 당시의 시스템 프롬프트, 도구 및 과거 메시지에 연결됩니다.

이전 메시지를 삭제하거나, 시스템 프롬프트를 재생성하거나, 과거 도구 정의를 중간에 다시 작성하면 이후 Thinking 블록이 무효화됩니다. 신규 계정의 경우 이 조건 위반을 오류로 처리하는 메커니즘이 이미 적용되어 있습니다. (Claude Platform

기본 원칙은 기록을 편집하지 말고, 끝에만 추가하는 것입니다.

임시 지침은 턴 범위 시스템 메시지로 추가하고, 긴 컨텍스트는 서버 측 압축 또는 컨텍스트 편집을 사용하여 정리하십시오.

저렴한 모델로 되돌릴 때 내부 Thinking을 이월할 수 없음

Fable 5.1은 Opus 5, Fable 5 또는 Sonnet과 같은 이전 모델이 생성한 Thinking 블록을 읽을 수 있습니다.

그러나 역방향은 불가능합니다. Fable 5.1이 생성한 Thinking 블록을 Opus 또는 Sonnet에 전달하면 해당 모델이 이를 읽을 수 없습니다. (Claude Platform Docs

따라서 동일한 대화 내에서 모델을 전환하는 경우 일반적으로 다음 순서가 안전합니다.

저렴한 모델로 탐색 → Fable로 승격

Fable에서 저렴한 모델로 돌아가려면 Thinking 블록에 의존하지 않고 결정 사항, 미해결 문제, 필요한 파일 및 검증 결과를 명시적인 인계 문서로 남겨야 합니다.

7. 안전 제한 및 데이터 보존

Fable 5.1에서는 사이버 보안 또는 생명 과학에 관한 일부 요청이 안전 분류기에 의해 제한됩니다.

표준 Claude 앱에서는 해당 프로세스가 Opus 4.8 또는 Opus 5로 자동 라우팅될 수 있습니다. API에서는 폴백 설정을 지정해야 합니다. 다른 모델로 전환된 프로세스에 대해서는 Fable 요금이 청구되지 않습니다. (Anthropic

또한 Fable 5.1은 일반적으로 30일 데이터 보존이 필요합니다. Anthropic의 명시적 허가를 받지 않는 한 표준 Zero Data Retention 환경에서는 사용할 수 없습니다.

기업 기밀 코드, 고객 정보 또는 미공개 연구 자료를 처리할 때는 "성능이 높으니까"라는 이유만으로 도입하지 말고, 계약 및 보존 조건을 확인한 후에 도입해야 합니다. (Claude Platform

8. 결국 누가 Fable 5.1을 필요로 하는가?

Fable 5.1은 단일 모델 응답이 아니라 전체 작업의 완료율이 가치인 사람들을 위한 것입니다.

• 대규모 코드베이스 조사 및 수정.
• 재현하기 어려운 버그의 근본 원인 분석.
• 수십 개의 문서에 걸친 리서치.
• 리서치에서 스프레드시트, 문서, 슬라이드 생성까지 이어지는 작업.
• 장시간 브라우저 조작 또는 백로그 처리.
• 여러 실험을 자율적으로 계획하고 실행하는 리서치.

반대로, 이메일 작성, 짧은 요약, 간단한 코드 생성, 일상적인 문서 정리, 소셜 미디어 게시물 초안 작성에는 Fable을 사용할 필요가 거의 없습니다.

Anthropic 자체적으로도 일반적인 처리는 Opus 5로 시작하고, Opus를 high 노력으로 실행해도 품질이 충분하지 않을 때만 Fable로 업그레이드할 것을 권장합니다. (Claude Platform Docs

Fable 5.1은 "모든 사람이 처음부터 사용하는 표준 모델"이 아니라, 어려운 지점을 돌파하기 위한 하이엔드 모델입니다.

파트 2: 토큰 절약, 프롬프트, 하네스, 스킬 구축

1. Fable 5.1을 위한 토큰 절약 기술

절약 팁 1: 탐색부터 Fable이 모든 것을 하게 하지 마십시오

가장 효과적인 절약 방법은 짧은 문장을 작성하는 것이 아닙니다.

바로 Fable 자체를 호출하는 횟수를 줄이는 것입니다.

파일 목록 가져오기, 로그 필터링, 자료 분류, 간단한 요약, 형식 변환은 Sonnet, Haiku 또는 일반 스크립트에 맡기십시오.

다음과 같은 단계에 Fable을 사용하십시오.

• 리서치 정책 결정
• 여러 가설 중 가장 유망한 가설 선택
• 모순된 정보 통합
• 근본 원인 식별
• 최종 결과물 감사
• 다른 모델이 실패한 문제 재검토

공식 문서에서도 여러 모델을 사용하는 구성을 안내하며, 저렴한 모델을 실행기로, 고성능 모델을 조언자 또는 감독자로 사용하도록 안내합니다. (Claude Platform Docs

절약 팁 2: 단계별로 Effort를 변경하십시오

전체 세션을 max로 설정할 필요는 없습니다.

다음과 같은 할당을 권장합니다.

Fable 5.1은 대화 중에 Effort를 변경하는 메커니즘도 제공합니다. 최상위 설정을 다시 작성하는 대신 중간에 시스템 메시지로 Effort 변경 사항을 추가하면 프롬프트 캐시를 유지할 수 있습니다. (Claude Platform

올바른 접근 방식은 "항상 최대 성능"이 아니라, "어려운 움직임에만 최대 성능" 입니다.

절약 팁 3: 기록을 추가 전용으로 유지하여 캐시를 보호하십시오

Fable 5.1에서는 다음 내용을 고정된 상태로 유지하십시오.

• 시스템 프롬프트
• 도구 정의 및 순서
• 프로젝트 공통 규칙
• 과거 메시지
• Thinking 블록

모든 변경 사항은 끝에 추가하십시오.

자체 API를 구축하는 경우 매번 시스템 프롬프트를 재조립하는 것보다 동일한 바이트 단위 접두사를 유지하는 것이 더 안전합니다.

Claude Code에서는 캐시 처리가 기본적으로 자동화되어 있지만, API에서는 cache_control을 사용할 수 있습니다. 다중 턴 대화의 경우 자동 캐싱을 사용하고, 긴 고정 자료를 분리하려면 명시적 캐시 경계를 사용하십시오. (Claude

절약 팁 4: 도구 출력을 그대로 전달하지 마십시오

10,000줄의 로그를 Claude에 넘기고 "오류를 찾아라"고 요청하는 것은 낭비입니다.

먼저 스크립트나 훅으로 필터링하십시오.

Claude Code의 공식 비용 가이드에서는 긴 로그를 훅으로 전처리하고 필요한 수백 줄만 모델에 전달할 것을 권장합니다. 또한 대량의 MCP 서버를 연결하는 것보다 gh, aws, gcloud와 같은 CLI를 사용할 수 있을 때 사용하는 것이 도구 정의로 인한 컨텍스트 소비를 억제하는 데 더 쉽다고 설명합니다. (Claude

AI가 읽기 전에 기계로 자를 수 있는 것은 잘라내십시오.

절약 팁 5: 독립적인 도구 호출을 그룹화하십시오

5개의 파일을 읽을 때 각각 하나의 파일로 5턴으로 나누면 매번 대화 기록이 전송됩니다.

Fable 5.1에 다음 지침을 포함시키는 것이 효과적입니다.

"필요한 정보를 내부적으로 정리하고, 서로의 결과에 의존하지 않는 읽기, 검색, 검증은 동일한 턴 내에서 병렬로 실행하십시오."

Anthropic은 또한 단일 응답에서 독립적인 도구 호출을 그룹화하도록 장려하면 왕복 시간, 토큰 및 대기 시간을 줄일 수 있다고 설명합니다. (Claude Platform

절약 팁 6: 작은 수정에 전체 파일을 다시 작성하지 않도록 하십시오

Fable 5.1은 작은 변경에도 전체 파일을 다시 작성할 수 있습니다.

공통 규칙에 다음 문장을 포함시키십시오.

"최종 결과가 변경되지 않으면 전체 파일을 다시 작성하지 말고, 필요한 부분만 최소한의 diff로 편집하십시오."

이는 긴 Markdown, JSON, 설정 파일, LP, 대규모 소스 코드에 특히 효과적입니다. 전체 재생성을 방지하여 출력 토큰과 diff 검증 부담을 억제할 수 있습니다. (Claude Platform

절약 팁 7: 관련 없는 작업을 동일한 세션에서 계속하지 마십시오

Claude Code에서 관련 없는 작업으로 이동할 때는 /clear를 사용하십시오.

긴 대화에서는 짧은 질문 하나를 추가해도 과거 대화, 읽은 파일, 도구 결과를 다시 처리해야 합니다. 캐시가 작동하더라도 무료는 아닙니다.

임시 질문으로 기록을 오염시키고 싶지 않으면 /btw를 사용하고, 필요한 내용만 유지하려면 /compact를 사용하십시오. 코드베이스 탐색은 하위 에이전트에 오프로드하고 요약만 기본 대화로 반환하십시오. (Claude

2. Fable 5.1을 위한 실용적인 프롬프트

Fable 5.1의 경우 수십 개의 세부적인 사고 단계를 지정하기보다 목표, 범위, 완료 조건 및 검증 방법을 명확하게 전달하는 것이 더 효과적입니다.

다음은 코딩, 리서치, 기사 제작, 문서 생성에 적용할 수 있는 기본 템플릿입니다.

역할

귀하는 이 요청을 완료까지 실행할 책임자입니다.

귀하는 단순히 답변하는 것뿐만 아니라 필요한 리서치, 작업, 검증 및 수정을 담당합니다.

목표

[생성할 최종 제품 또는 해결할 문제를 작성하십시오]

입력

[파일, URL, 자료 및 전제 조건을 작성하십시오]

범위

구현할 사항:

• [필수 작업]
• [필수 작업]

구현하지 않을 사항:

• [범위 외]
• [임의로 변경되길 원하지 않는 내용]

완료 조건

다음 모든 조건이 충족되면 작업이 완료됩니다.

1. [기능/내용 조건]
2. [형식/글자 수/품질 조건]
3. [검증 방법]
4. [오류가 없음을 보여주는 증거]

실행 규칙

• 먼저 필요한 정보와 종속성을 정리하십시오.
• 서로의 결과에 의존하지 않는 검색, 읽기 및 검증은 병렬로 실행하십시오.
• 중간에 허가를 구하지 않고 요청 범위 내에서 되돌릴 수 있는 작업을 진행하십시오.
• 문제의 증상만 고치지 말고 수정하기 전에 원인을 확인하십시오.
• 요청되지 않은 기능 추가, 최적화 또는 주변 수정을 수행하지 말고 제안 사항으로 끝에 분리하십시오.
• 가능하면 최소한의 diff로 파일을 편집하십시오.
• 작업 후 초기 완료 조건에 따라 검증하십시오.
• 검증에 실패하면 원인을 조사하고 수정한 후 다시 검증하십시오.
• "다음에 할 일"을 작성하는 것으로 끝내지 말고 해당 작업을 실행하십시오.
• 파괴적인 작업이나 주요 사양 변경에 대해서만 실행 전에 확인하십시오.

최종 보고서

마지막으로 다음 순서로 간략히 보고하십시오.

1. 완료된 사항
2. 변경 사항
3. 검증 결과 및 증거
4. 남은 문제
5. 발견되었지만 범위 외인 개선 후보

Fable 5.1은 오랫동안 작업을 계속할 수 있지만, 완료가 무엇인지 모호하면 필요 이상으로 계속 탐색합니다.

따라서 "깊이 생각하라"고 말하는 것보다 완료 및 중지 조건을 작성하는 것이 더 중요합니다.

3. Fable 5.1을 활용하기 위한 하네스 설계

하네스는 모델을 둘러싼 작업 메커니즘입니다.

모델의 능력에만 의존하는 것이 아니라, 어떤 정보를 전달하고, 어떤 도구를 사용하며, 어떤 순서로 진행하고, 어디서 검증하며, 실패 시 몇 번 재시도할지를 외부에서 결정합니다.

다음 6계층 구조를 권장합니다.

계층 1: 공통 규칙

CLAUDE.md에는 매번 필요한 프로젝트 사실만 배치하십시오.

프로젝트

• 이 저장소는 XX 서비스용입니다.
• 프로덕션 환경은 XX입니다.
• 패키지 관리는 pnpm을 사용합니다.

필수 확인 사항

• 변경 후 pnpm lint
• 변경 후 pnpm test
• API 변경 시 타입 확인

제약 사항

• 기존 API와의 호환성을 깨뜨리지 마십시오.
• 로그에 비밀 정보를 출력하지 마십시오.
• 요청 범위 밖의 리팩터링을 수행하지 마십시오.

CLAUDE.md는 모든 세션에서 읽히기 때문에, 내용이 너무 길면 매번 컨텍스트를 소모하게 됩니다. 공식 문서에서는 하나의 파일을 200줄 미만으로 유지하고, 긴 절차는 Skills로 옮길 것을 권장합니다. (Claude

레이어 2: 라우터 (Router)

요청이 수신되면, 즉시 Fable을 시작하는 대신 작업을 분류하세요.

• 단순 추출/포맷팅 -> Haiku 또는 스크립트
• 일반적인 구현/연구 -> Sonnet
• 복잡한 설계/분석 -> Opus
• 장기 작업/어려운 문제 -> Fable
• 실패한 어려운 부분만 -> Fable xhigh

자동 라우터를 만들 때는 가격보다 "잘못 판단했을 때의 손실", "필요한 자율 작업 시간", "검증의 난이도"를 기준으로 판단하세요.

레이어 3: 탐색 리드 (Exploration Lead)

코드 탐색, 자료 수집, 경쟁사 조사를 서브 에이전트로 분리하세요.

각 서브 에이전트는 독립적인 컨텍스트에서 작업하고, 결론과 증거만 메인 에이전트에 반환합니다. 이렇게 하면 수십 개 파일의 읽기 결과가 메인 히스토리를 비대하게 만드는 것을 방지합니다. (Claude

레이어 4: Fable 감독자 (Fable Supervisor)

Fable은 탐색 리드가 반환한 결과를 사용하여 판단을 내립니다.

• 어떤 가설을 채택할지
• 추가 연구가 필요한지
• 어떤 변경을 할지
• 결과에 모순이 있는지
• 완료 조건이 충족되었는지

Fable이 원시 데이터 수집까지 모든 것을 담당하게 하는 대신, 정리된 증거를 전달하고 판단에 집중하게 하세요.

레이어 5: 결정론적 검증 (Deterministic Verification)

검증을 프롬프트에만 맡기지 마세요.

• 코드: 테스트, Lint, 타입 검사.
• 아티클: 글자 수, 중복 표현, URL, 인용.
• 스프레드시트: 수식 오류, 누락된 값, 합계.
• 랜딩 페이지: 링크, 레이아웃 깨짐, 스크린샷 비교.

훅을 사용하면 도구 실행 전후에 검사를 실행할 수 있습니다. LLM이 검증을 기억할 것이라고 기대하지 말고, 고정된 조건에서 자동으로 실행하세요. (Claude Platform Docs

레이어 6: 수리 루프 (Repair Loop)

검증에 실패한 경우에만 Fable로 돌아가세요.

생성 -> 기계적 검증 -> 성공 (완료) / 실패 -> 원인 분석 -> 최소 수정 -> 재검증

중요한 것은 무한 루프에 빠지지 않는 것입니다.

예를 들어, "동일한 실패에 대해 최대 2회" 또는 "총 3회 실패 후 증거와 함께 중단"과 같이 결정하세요. 오래 작업할 수 있는 모델의 경우, 중단 조건 없이는 비용과 작업 범위가 기하급수적으로 늘어납니다.

수십에서 수백 개의 서브 에이전트를 사용하는 프로세스의 경우, Claude가 순차적으로 관리하도록 두지 말고 동적 워크플로우 (Dynamic Workflow)로 전환하세요. 워크플로우에서는 중간 결과를 스크립트 변수에 보관하고 최종 결과만 메인 컨텍스트에 반환할 수 있으므로, 대규모 연구나 방대한 파일 처리에 적합합니다. (Claude

4. Skills는 "긴 프롬프트 저장소"가 아닙니다

Skills는 반복적으로 사용되는 작업 절차를 SKILL.md로 저장하는 메커니즘입니다.

CLAUDE.md와의 차이점은 본문이 필요할 때만 읽힌다는 점입니다.

• 항상 따라야 할 프로젝트 정보 및 짧은 규칙: CLAUDE.md.
• 아티클 제작, 배포, 연구, 리뷰 등의 절차: Skills.
• 대량의 예시 또는 사양: Skills의 참조 파일.

이러한 분리는 토큰 절약으로 직접 이어집니다. (Claude Platform Docs

다음 구조를 권장합니다:

1.claude/
2├── CLAUDE.md
3├── skills/
4│   └── deep-article/
5│       ├── SKILL.md
6│       ├── research-rules.md
7│       ├── writing-rules.md
8│       ├── examples.md
9│       └── scripts/
10│           ├── count_chars.py
11│           └── check_repetition.py
12├── agents/
13│   ├── researcher.md
14│   └── critic.md
15└── settings.json

SKILL.md에는 개요, 실행 조건, 절차, 완료 조건만 배치하세요.

방대한 설명, API 사양, 성공 사례는 별도 파일로 분리하고 Claude가 필요할 때만 읽도록 하세요. 공식 문서에서는 SKILL.md를 500줄 미만으로 유지하고 상세 자료는 지원 파일로 분리할 것을 권장합니다. (Claude Platform Docs

5. 실용적인 SKILL.md 템플릿

다음은 연구 아티클을 생성하기 위한 Skill의 예시입니다.

name: deep-article

description: 1차 정보를 조사하고 증거와 함께 장문의 아티클을 생성합니다. 최신 AI, 기업, 시스템 또는 제품에 대한 철저한 설명이 요청될 때 사용하세요.

argument-hint: "[주제] [목표 글자 수]"

effort: high

목표

$ARGUMENTS에 대한 사실 확인된 장문 아티클을 생성합니다.

기본 규칙

• 최신 정보가 관련된 경우 항상 검색
• 1차 정보 우선
• 사실, 기업 발표, 제3자 평가, 추측을 구분
• 숫자에는 대상 기간과 정의를 첨부
• 동일한 결론이나 예시를 반복하지 않음
• 기술 용어는 첫 언급 시 설명
• 지정된 글자 수의 90% 미만으로 끝내지 않음
• 마지막에 글자 수와 미확인 항목 보고

워크플로우

1. 주제를 3-7개의 연구 포인트로 분할
2. 독립적인 포인트를 병렬로 연구
3. 1차 정보 수집
4. 반증 또는 불리한 정보 조사
5. 사실 목록 생성
6. 구조 결정
7. 초안 작성
8. 중복, 비약, 인용, 날짜, 숫자 감사
9. 수정
10. 글자 수 검사

완료 조건

• 서두에 결론이 명확함
• 독자가 무엇을 해야 할지 결정할 수 있음
• 중요한 사실에 출처가 있음
• 사실과 추측이 혼용되지 않음
• 지정된 글자 수 충족
• 중복된 단락 없음

필요할 때만 읽을 자료

• 연구 기준: research-rules.md
• 스타일 기준: writing-rules.md
• 우수 완성 예시: examples.md

최종 검사

다음 항목을 실행하세요:

• python ${CLAUDE_SKILL_DIR}/scripts/count_chars.py <output-file>
• python ${CLAUDE_SKILL_DIR}/scripts/check_repetition.py <output-file>

Skill의 설명은 단순한 설명이 아니라 라우터 역할을 합니다.

"고품질 아티클을 작성하세요"와 같은 모호한 문장보다는 "최신 AI, 기업, 시스템에 대한 1차 정보를 조사하는 장문 요청에 사용"이라고 작성해야 필요한 상황에서 호출되기 쉽습니다.

Claude Code는 Skill 설명 목록을 컨텍스트에 넣기 때문에, 방대한 설명을 작성하면 지속적인 비용이 증가합니다. 중요한 용도를 앞에 배치하고 간결하게 유지하세요. (Claude Platform Docs

6. Skills 고급 사용법

자동 실행되어서는 안 되는 Skills

배포, 전송, 삭제, 게시, 결제는 Claude가 임의로 시작해서는 안 됩니다.

disable-model-invocation: true로 설정하고 사용자가 명시적으로 /deploy 등을 입력할 때만 실행하세요.

대화를 오염시켜서는 안 되는 Skills

대규모 연구나 코드 탐색을 수행하는 Skill의 경우 context: fork로 설정하세요.

이렇게 하면 별도의 서브 에이전트 컨텍스트에서 실행됩니다. 방대한 파일 내용과 검색 기록은 메인 대화에 들어가지 않고 최종 결과만 반환됩니다. (Claude Platform Docs

현재 상태를 자동 주입하는 Skills

Skill 내에서 명령 결과를 미리 삽입할 수 있습니다.

현재 상태

!git status --short

!git diff --stat

Claude는 명령 문자열이 아닌 실행 결과를 받습니다.

그러나 매번 전체 git diff나 방대한 로그를 주입하는 것은 역효과를 낳습니다. 먼저 --stat 또는 오류 줄만 넣고, 필요해질 때만 세부 내용을 읽도록 하세요. (Claude Platform Docs

Skill에 effort 설정하기

단순한 Skill은 medium, 디자인 리뷰와 심층 연구는 high, 매우 어려운 감사는 xhigh로 설정하세요.

각 Skill에 고유한 effort를 부여하면 사용자가 매번 전환할 필요가 없습니다.

7. 항상 비교 평가하세요

Skill을 만드는 것만으로는 품질이 향상되었는지 알 수 없습니다.

공식 문서에서는 두 가지를 별도로 평가하도록 안내합니다.

1. Skill이 필요한 요청에 대해 올바르게 시작되는가?
2. Skill 시작 결과로 결과물이 실제로 더 좋아지는가?

"Skill 사용"과 "Skill 미사용" 상태로 새 세션에서 동일한 요청을 실행하세요.

아티클 Skill의 경우 글자 수, 누락된 출처, 중복, 사실 오류, 수정 횟수를 비교하세요. 코드 Skill의 경우 테스트 성공률, 변경된 파일 수, 불필요한 변경, 재작업 횟수를 비교하세요.

Skill을 만든 대화의 연속선상에서 테스트하면 대화의 추가 정보로 인해 결함이 가려집니다. 항상 새 세션에서 평가하세요. Claude Code는 이 비교를 지원하는 공식 skill-creator 플러그인도 제공합니다. (Claude Platform Docs

최종 결론

Claude Fable 5.1은 단순히 Claude 시리즈의 속도를 높이는 모델이 아닙니다.

그것의 가장 큰 가치는 어려운 작업을 오랫동안 지속하고, 중간에 실패해도 복구하며, 근본 원인을 찾고, 자신의 결과를 검증하면서 작업을 완료까지 이끄는 능력에 있습니다.

반면, 입력 및 출력 단가는 Opus 5의 두 배입니다. 내부 사고를 끌 수 없고, 오래된 대화를 다시 쓰는 하네스와 호환되지 않으며, 강제 도구 호출을 사용할 수 없습니다.

따라서 가장 강력한 사용법은 다음과 같습니다:

**Sonnet 또는 스크립트로 정보를 좁히세요.

서브 에이전트로 탐색을 분리하세요.

어려운 판단과 통합은 Fable에 할당하세요.

훅과 테스트로 기계적으로 검증하세요.

실패한 어려운 부분에만 effort를 높이세요.

반복되는 절차는 Skills에 저장하세요.

대화 기록은 append-only로 유지하여 캐시를 보호하세요.**

Fable 5.1을 "무엇이든 답하는 고급 채팅"으로 사용한다면, 가격만 높아질 것입니다.

Fable 5.1을 저렴한 모델, Skills, 서브 에이전트, 훅, 검증 루프를 묶는 감독자로 포지셔닝할 때 비로소 이전 세대와의 진정한 차이가 드러납니다.