oh-my-fable

Claude Fable 5.1을 Claude Code에서 가장 좋은 품질로 쓰는 법. 설치만 하면 알아서: 터미널이든 헤드리스든 서브에이전트든, 세션마다 맞는 규칙이 들어갑니다.

Opus 5, Sonnet 5에서도 결과 품질이 올라갑니다.

한국어 · English · 中文

대충 한 줄로 시켜도, 제대로 된 요청으로 바뀌어 실행됩니다.

👤 당신이 치는 것

/fable-prompt 로그인 버튼 눌러도 아무 반응 없어 고쳐줘

🤖 Claude가 실제로 받는 요청 (대화 맥락에서 자동으로 채워짐)

목표: 로그인 버튼을 누르면 /api/login 이 호출되고, 성공하면 /dashboard 로 이동하게 한다
맥락: src/components/LoginButton.tsx, 콘솔 오류 "TypeError: onSubmit is not a function", 어제 인증 방식을 바꾼 커밋 이후 발생
범위: 이 버튼과 그 핸들러만. 옆의 회원가입 폼이나 다른 오류는 고치지 말고 후속 과제로 보고
완료 기준: 실제 클릭을 재현해 /dashboard 이동 확인, 콘솔 오류 0, 변경 파일 목록 첨부

설치만 하면, 나머지는 자동입니다.

• 사용 형태를 세션마다 알아서 판정 · 터미널·IDE면 대화형, claude -p·Agent SDK·에이전트 하네스면 무인으로 감지해 "사용자가 지켜보고 있지 않다" 문단을 그때만 넣습니다. 섞어 써도 바꿀 것이 없습니다.
• 서브에이전트까지 자동 · Agent 도구로 띄운 서브에이전트(규칙 파일을 안 읽는 Explore·Plan 포함)에 짧은 판을 따로 넣습니다.
• 파일을 만들지 않습니다 · CLAUDE.md도 규칙 파일도 건드리지 않고, 훅이 세션마다 넣습니다. 그래서 갱신은 플러그인만 올리면 되고 제거하면 흔적이 없습니다.
• 질문 없음 · 설정은 선택 사항입니다. 확인할 것은 설치 승인 하나뿐입니다.

Anthropic 공식 문서 Prompting Claude Fable 5.1의 처방을 스킬 두 개에 담았습니다. 문구는 원문 그대로 씁니다.

Fable에서만 쓸 수 있나요? 아닙니다. Opus 5, Sonnet 5에서도 결과 품질이 올라갑니다. 네 칸 요청 틀(목표·맥락·범위·완료 기준)은 모델이 무엇이든 되묻기와 빗나간 결과를 줄이고, 범위 제한·부분 편집·진행 보고·끝까지 하기 규칙은 어떤 모델에서도 그대로 작업 품질을 끌어올립니다. Fable 5.1 전용인 것은 그 모델의 버릇을 되돌리는 문구 몇 개(서식 규칙, 자율 진행 블록, effort 권고값)뿐이고, 다른 모델에 있어도 해가 되지 않습니다.

목차

• 무엇을 하나
• 설치: 한마디
• 사용법: 평소처럼
• 초보자 흐름
• 작동 원리: 세 층
• 1층 · 매번 요청에
• 2층 · 상시 규칙
• 3층 · 설정값
• 증상별 처방
• FAQ
• 구성
• 기여와 라이선스

무엇을 하나

Fable 5.1은 긴 작업을 혼자 끝까지 해내는 능력이 커진 대신 버릇이 바뀌었습니다. 작업 중 말수가 줄고, 한 번에 도구 하나씩만 부르고, 작은 수정에도 파일을 통째로 다시 쓰고, low effort에서는 검색 대신 기억으로 답합니다. 공식 가이드는 이 변화에 대한 증상별 처방이고, 이 플러그인은 그 처방을 자동으로 적용합니다.

설치: 한마디

Claude Code에 이렇게만 말하세요.

https://github.com/Junhan2/oh-my-fable 설치해줘

Claude가 설치하면 끝입니다. 질문도, 설정 파일도 없습니다. 다음에 Claude Code를 열면 자동으로 적용됩니다. 지금 이 세션에서 바로 쓰고 싶으면 /reload-plugins(방금 설치한 플러그인 로드) 다음 /clear(규칙 주입) 를 한 줄씩.

claude plugin marketplace add Junhan2/oh-my-fable
claude plugin install oh-my-fable@oh-my-fable

새 세션을 열거나 /reload-plugins 후 /clear. 설정할 것은 없습니다. 기본값을 바꾸고 싶을 때만 /fable-setup.

요구 사항 Claude Code 2.1.258 이상. Windows는 Git for Windows(Git Bash) 필수: 훅이 bash로 실행됩니다. 설치 뒤 훅 오류가 뜨면 이 문제입니다.

자동 갱신 서드파티 마켓플레이스는 Claude Code가 자동 갱신을 기본으로 꺼 둡니다. 새 버전을 자동으로 받으려면 한 번만: /plugin → Marketplaces → oh-my-fable → Enable auto-update. 아니면 가끔 claude plugin update oh-my-fable@oh-my-fable.

60초 경로: 내 환경에서는?

사용법: 평소처럼

그냥 평소처럼 요청하면 됩니다. 상시 규칙은 이미 켜져 있습니다. 요청이 짧거나 막연하면 앞에 /fable-prompt를 붙이세요.

/fable-prompt 이거 좀 고쳐줘

목표·맥락·범위·완료 기준·effort를 채운 요청을 보여 주고 바로 실행합니다. 보기만 하려면 뒤에 프롬프트만.

초보자 흐름

규칙 위치 세 가지 (첫 질문)

셋 중 하나만 활성화됩니다. CLAUDE.md에 구간이 있거나 사용자가 직접 만든 규칙 파일이 있으면 훅은 스스로 조용해집니다(이중 주입 없음). 서브에이전트는 1.7부터 훅이 직접 챙깁니다: Claude Code의 SubagentStart 이벤트에 짧은 판(hooks/subagent.md, 범위 제한·부분 편집·일괄 호출·끝까지 하기·"묻지 말고 막힌 점을 보고")을 넣습니다. Explore·Plan 서브에이전트는 CLAUDE.md도 규칙 파일도 읽지 않으므로 어떤 방식에서든 이 짧은 판을 받습니다.

• 사용 방식은 기본이 자동 감지입니다. 터미널이나 IDE에서 열면 대화형, 헤드리스(claude -p)·Agent SDK·에이전트 하네스에서 열면 무인으로 세션마다 알아서 정합니다(Claude Code가 넣어 주는 CLAUDE_CODE_ENTRYPOINT 값 기준). 대화형과 무인을 섞어 써도 따로 바꿀 것이 없습니다. 항상 한쪽으로 고정하려면 질문에서 "대화형" 또는 "무인"을 고르세요. 무인은 "사용자가 지켜보고 있지 않다" 문단을 추가하며, 글로벌 설정에서만 켜지고 저장소 안의 설정 파일로는 켤 수 없습니다(클론한 저장소가 에이전트를 무인으로 바꾸는 것을 막기 위해). 자동 감지는 훅이 관여하는 두 방식에서 되고, CLAUDE.md 구간만 고정 텍스트라 한쪽을 골라야 합니다.
• effort는 medium 추천(Fable 5 수준 품질을 더 싸게, 어려운 작업만 그 세션에서 /effort high). Anthropic 가이드의 기본값은 high이니 품질을 우선하면 그것을 고르세요. settings.json의 effortLevel에 쓰며 승인 프롬프트가 뜰 수 있습니다.

1. claude plugin marketplace add Junhan2/oh-my-fable
2. claude plugin install oh-my-fable@oh-my-fable
3. ~/.claude/plugins/installed_plugins.json 에서 oh-my-fable@oh-my-fable 의 installPath 를 읽는다
4. 설치가 확인되면 사용자에게 이렇게만 안내한다: "설치가 끝났습니다. 다음 세션부터 자동 적용됩니다. 지금 바로 쓰려면 /reload-plugins 를 입력하고 Enter, 그다음 /clear 를 입력하고 Enter 하세요(한 줄에 하나씩). 막연한 요청은 /fable-prompt <요청> 으로 보내세요."
5. 그 밖의 설명은 하지 않고 /fable-setup 도 실행하지 않는다(선택 사항이며 기본값은 설정 없이 동작). 둘 다 필요한 이유: /reload-plugins 는 방금 설치한 플러그인(훅·스킬)을 이 세션에 로드하고, 규칙 주입은 세션 시작·/clear·압축 때만 일어난다

작동 원리: 세 층

가이드의 처방은 적용 방법이 다른 세 층으로 나뉩니다.

1층 · 매번 요청에

좋은 요청은 네 칸입니다.

요청에 따라 덧붙이는 것:

• 문제를 설명만 할 때 · "진단만 하고 고치지 마". 가이드의 명시적 예외.
• 최신 정보가 필요할 때 · effort를 high 이상으로 두거나 "사용자가 쓴 이름 그대로 한 번은 검색해" (블록 H).
• effort · 추천 medium(가이드 기본은 high). 어려운 작업만 /effort high. low는 검색을 건너뛸 수 있음. xhigh/max로 긴 문서를 시키면 초안을 두 번 써서 느려지니 장문 안내문(블록 G)을 붙이고 max_tokens를 넉넉히.
• 글이 빽빽할 때 · Please remove all mannered prose.
• 자료 요약 · 올바른 답 예시 1건(블록 J)을 같이 줌.

2층 · 상시 규칙

플러그인의 SessionStart 훅이 세션마다 아래 블록을 영어 원문 그대로 불러옵니다(파일 hooks/always-on.md). CLAUDE.md는 수정하지 않으며, 사용자 언어와 무관하게 영어입니다. 블록 A의 첫 문단("사용자가 지켜보고 있지 않다")은 헤드리스·SDK 세션에서만 자동으로 들어가고 터미널·IDE에서는 빠집니다. 항상 넣으려면 /fable-setup unattended.

3층 · 설정값

• 모드 · ~/.claude/oh-my-fable.json 의 {"enabled": true, "mode": "interactive" | "unattended"}. 프로젝트의 .claude/oh-my-fable.json 이 있으면 그것이 우선. /fable-setup 이 대신 써 줍니다.
• effort · 설정 파일 effortLevel(전역) 또는 modelSettings.<model>.effortLevel(모델별). 환경 변수 CLAUDE_CODE_EFFORT_LEVEL이 있으면 그것이 이기니 모델별 값을 쓰려면 환경 변수를 비울 것. 추천 medium, 가이드 기본 high. 모델마다 단계의 실제 사고량이 달라 Fable 5 값을 그대로 옮기지 말 것.
• API 직접 연동 · thinking.display: "updates"를 켜야 진행 메모가 화면에 옴. 대화 이력은 덧붙이기만(thinking 블록 포함), 턴마다 넣는 알림은 turn-scoped system message로. 압축은 서버 압축 또는 블록 K.
• 서브에이전트 · 시작 도구는 즉시 반환, 결과는 나중 메시지로.
• 비전 · 차트·표는 crop-and-zoom 도구를 붙이면 대부분의 이득.
• 거절(stop_reason: "refusal") 처리 · "컴파일 되나요?" 대신 "버그 있나요?"로 묻기.

증상별 처방