Claude Prompting Guide

Claude Fable 5.1 프롬프트 가이드: 쉽게 쓰는 AI 지시문 작성법

Anthropic의 공식 문서는 Claude Fable 5.1을 더 잘 쓰기 위한 프롬프트 작성법을 설명합니다. 개발자용 문서라 조금 어렵지만, 핵심은 간단합니다. AI에게 “무엇을, 어느 정도로, 어떤 방식으로 끝낼지”를 더 분명히 알려주라는 것입니다.

출처: Anthropic Claude Platform Docs

한눈에 보는 핵심

• 작업 난이도에 맞게 AI의 “생각하는 정도”를 조절한다.
• 긴 작업에서는 중간 진행 상황을 사용자에게 알려달라고 요청한다.
• 독립적인 도구 호출은 한 번에 묶어서 처리하게 한다.
• 대화 기록은 중간에 고치지 말고 계속 뒤에 붙이는 방식이 안전하다.
• 글이 너무 길거나 딱딱하면 쉬운 문장과 구조를 요청한다.
• 작업을 시켰다면 끝까지 완료하고 검증하게 한다.

1. “생각하는 정도”를 작업에 맞게 정하라

Claude Fable 5.1에는 작업에 얼마나 많은 추론을 쓸지 정하는 effort 개념이 있습니다. 쉽게 말하면 AI에게 “빨리 대답할지, 더 깊게 생각할지”를 조절하는 장치입니다.

낮은 effort간단한 요약, 분류, 짧은 답변처럼 빠른 처리가 중요한 작업

중간 effort품질과 비용의 균형이 필요한 일반 업무

높은 effort코딩, 분석, 복잡한 문서 작성처럼 실수가 비싼 작업

매우 높은 effort긴 산출물이나 중요한 의사결정 보조 작업

문서의 조언은 명확합니다. 무조건 가장 높은 설정을 쓰지 말고, 실제 업무에서 품질·속도·비용을 비교해보라는 것입니다. AX 컨설팅 관점에서는 이 부분이 중요합니다. AI도 직원처럼 업무 난이도에 맞는 투입 시간이 필요합니다.

2. 오래 걸리는 작업은 중간 보고를 시켜라

Claude Fable 5.1은 긴 도구 작업을 할 때 사용자에게 중간 상황을 덜 말하는 경향이 있다고 합니다. 사용자는 화면이 멈춘 것처럼 느낄 수 있습니다.

그래서 긴 작업을 맡길 때는 이렇게 말해두면 좋습니다.

작업을 시작하기 전에 무엇을 할지 한 줄로 알려줘. 작업 중간에도 중요한 진행 상황을 짧게 알려줘. 마지막에는 무엇을 했고, 무엇이 확인됐고, 남은 일이 무엇인지 요약해줘.

특히 발표자료 작성, 블로그 업로드, 코드 수정, 파일 변환처럼 시간이 걸리는 작업에서는 이런 중간 보고가 신뢰를 높입니다.

3. 여러 자료를 찾을 때는 한 번에 찾게 하라

AI 에이전트가 웹 검색, 파일 읽기, 코드 확인 같은 도구를 사용할 때가 있습니다. 이때 서로 의존하지 않는 작업은 하나씩 순서대로 하기보다 한 번에 묶어서 처리하는 것이 빠릅니다.

예를 들어 “README, package.json, 보안 문서를 확인해줘”라는 작업은 세 파일을 순서대로 하나씩 읽을 필요가 없습니다. 한 번에 읽고 비교하면 됩니다.

문서에서는 이런 식의 지시를 제안합니다.

먼저 필요한 자료를 조용히 정리한 뒤, 서로 의존하지 않는 자료는 이번 응답에서 한 번에 요청해줘.

4. 대화 기록은 중간에 고치지 말고 뒤에 붙여라

AI 서비스를 만들 때는 이전 대화 기록을 어떻게 저장하느냐도 중요합니다. Claude Fable 5.1은 이전 응답의 생각 블록이나 도구 호출 기록이 정확히 이어져야 안정적으로 동작합니다.

쉽게 말하면, 이미 지나간 대화를 중간에서 고치거나 지우지 말고 새 내용은 뒤에 계속 붙이는 방식이 안전하다는 뜻입니다. 개발자에게는 기술적인 내용이지만, 서비스 운영자에게는 “기록을 함부로 편집하면 AI의 문맥이 깨질 수 있다” 정도로 이해하면 됩니다.

5. 글이 너무 어렵거나 길면 문체를 지정하라

공식 문서는 Claude Fable 5.1의 글이 좋아졌지만, 경우에 따라 문장이 길고 밀도가 높아질 수 있다고 설명합니다. 이럴 때는 “쉽게, 짧게, 구조적으로” 쓰라고 명시해야 합니다.

전문 용어를 줄이고 쉬운 한국어로 써줘. 한 문단은 너무 길지 않게 나눠줘. 목록과 소제목을 사용해서 모바일에서도 읽기 쉽게 정리해줘.

이건 블로그 글, 교육자료, 시니어 대상 강의안에서 특히 중요합니다. 좋은 프롬프트는 멋진 말을 요구하는 것이 아니라, 독자가 이해하기 쉬운 형식을 요구하는 것입니다.

6. 자료를 요약할 때는 베껴 쓰지 않게 하라

공식 문서는 Claude Fable 5.1이 검색한 자료를 요약할 때 원문 표현을 그대로 가져오는 경우가 있을 수 있다고 설명합니다. 블로그나 보고서에서는 이 점을 조심해야 합니다.

안전한 방식은 이렇습니다.

• 자료의 핵심은 내 말로 풀어쓴다.
• 원문 표현을 그대로 쓰는 경우에는 따옴표로 표시한다.
• 출처 링크를 남긴다.
• 단순 번역이 아니라 독자에게 필요한 해설을 붙인다.

7. 일을 시켰으면 끝까지 하게 하라

AI 에이전트에게 작업을 맡겼는데 중간에 “다음에 하겠습니다”라고 멈추면 곤란합니다. 공식 문서는 이런 경우 프롬프트에서 작업 완료 기준을 분명히 하라고 조언합니다.

사용자가 이미 요청한 일은 다시 허락을 묻지 말고 진행해줘. 다만 삭제, 결제, 외부 발송처럼 위험한 일은 멈추고 확인을 받아줘. 마지막에는 실제로 무엇을 실행했고, 어떤 결과를 확인했는지 알려줘.

이 원칙은 AI 업무자동화에서 매우 중요합니다. AI는 계획만 세우는 도구가 아니라, 요청받은 범위 안에서 실제 결과물을 만들어야 합니다.

8. 작은 수정은 전체를 갈아엎지 말게 하라

코드나 문서를 고칠 때 작은 오타 하나 때문에 전체 파일을 다시 쓰면 시간과 비용이 낭비됩니다. 문서에서는 필요한 경우 “수술하듯 작은 부분만 수정하라”고 지시하라고 합니다.

결과가 같다면 전체 파일을 다시 쓰지 말고, 필요한 부분만 정확히 수정해줘.

이 지시는 코딩 에이전트뿐 아니라 문서 편집에도 유용합니다. 보고서 한 문단만 바꾸면 되는데 전체 구조가 바뀌면 검토 부담이 커지기 때문입니다.

9. 긴 결과물은 답변 공간을 남겨라

매우 높은 effort에서 긴 보고서나 긴 코드를 만들 때는 AI가 생각하는 데 많은 공간을 쓰고, 정작 최종 답변이 잘릴 수 있습니다. 그래서 긴 산출물을 요청할 때는 “생각은 구조 잡기에 쓰고, 최종 답변을 완성하는 데 공간을 남겨라”라고 요청하는 것이 좋습니다.

실무적으로는 한 번에 너무 큰 결과물을 요구하기보다, 목차 → 초안 → 검토 → 최종본 순서로 나누는 것도 좋은 방법입니다.

10. 쉬운 프롬프트 공식

Claude Fable 5.1 문서를 실무용으로 바꾸면 다음 공식으로 정리할 수 있습니다.

1. 역할: 너는 무엇을 돕는 AI인가? 2. 목표: 무엇을 완성해야 하는가? 3. 자료: 어떤 출처와 파일을 봐야 하는가? 4. 방식: 짧게 쓸지, 표로 쓸지, HTML로 만들지 정한다. 5. 진행: 오래 걸리면 중간 보고를 한다. 6. 검증: 완료 후 무엇을 확인해야 하는지 정한다. 7. 제한: 하지 말아야 할 일과 사람 승인이 필요한 일을 정한다.

AX 컨설팅에서의 활용 포인트

이 문서는 개발자용이지만, 실제 메시지는 컨설팅 현장에도 그대로 적용됩니다. AI를 잘 쓰려면 “좋은 질문”보다 “좋은 업무 지시서”가 필요합니다. 사람 직원에게 업무를 맡길 때처럼 목표, 자료, 형식, 완료 기준, 승인 기준을 분명히 해야 합니다.

한 줄 결론

Claude Fable 5.1을 잘 쓰는 방법은 어렵지 않습니다. 작업 난이도에 맞게 생각의 깊이를 정하고, 필요한 자료를 확인하게 하고, 중간 진행을 알려달라고 하고, 최종 결과를 검증하게 하면 됩니다. AI에게 막연히 “잘해줘”라고 말하지 말고, “어떤 결과를 언제까지 어떤 형식으로 끝낼지” 알려주는 것이 핵심입니다.