프롬프트가 잘 안 먹힐 때는 대개 "더 좋은 트릭"이 부족해서가 아니라, 흔한 실수 몇 가지를 반복하기 때문입니다. 이 글은 Anthropic 공식 프롬프트 엔지니어링 가이드의 원칙을 뒤집어, 자주 나오는 안티패턴(나쁜 습관)과 그 교정법을 before/after로 정리합니다. 결과를 바꾸는 7가지 원칙을 먼저 보고 싶다면 프롬프트 잘 쓰는 법을, 처음이라면 프롬프트 첫걸음을 참고하세요.
안티패턴 1 — 모호하게 말하고 알아서 해주길 기대
가장 흔한 실수입니다. 공식 가이드는 Claude를 "맥락이 전혀 없는, 똑똑하지만 새로 온 직원"에 비유합니다. 무엇을 원하는지 정확히 설명할수록 결과가 좋아집니다.
교정: 맥락(이 결과가 어디에 쓰이는지·대상이 누구인지·성공한 결과물이 어떤 모습인지)을 주고, 원하는 바를 구체적으로 말합니다. 공식 가이드의 "황금률"은 이렇습니다 — 작업에 대한 사전 정보가 거의 없는 동료에게 프롬프트를 보여주고 따라 해보라고 했을 때 그가 헷갈린다면, Claude도 헷갈립니다.
안티패턴 2 — 예시를 하나도 안 주거나, 너무 적게 줌
원하는 출력 형식을 말로만 설명하면 형식이 들쭉날쭉해지기 쉽습니다.
교정: 입력/출력 예시를 제시하세요. 공식 가이드는 최선의 결과를 위해 3~5개 예시를 포함할 것을 권장합니다. 예시는 실제 사용 사례와 관련 있고, 엣지 케이스를 덮을 만큼 다양해야 합니다. 좋은 예시가 없다면 Claude에게 예시의 관련성·다양성을 평가하게 하거나, 초안 예시를 바탕으로 더 만들어 달라고 할 수 있습니다.
안티패턴 3 — 지시·맥락·데이터를 한 덩어리로 섞음
긴 지시문과 참고 자료, 실제 입력을 구분 없이 한 문단에 몰아넣으면 Claude가 무엇이 지시이고 무엇이 데이터인지 헷갈립니다.
교정: XML 태그로 구조화하세요. 여러 문서를 다룰 때는 각 문서를 <document>로 감싸고 그 안에 <document_content>와 <source> 같은 하위 태그로 내용과 출처를 표시하면 명확해집니다.
안티패턴 4 — 역할을 안 줌
아무 맥락 없이 질문하면 일반적인 답이 나오기 쉽습니다.
교정: system 메시지로 역할을 부여하세요. 예를 들어 "당신은 파이썬을 전문으로 하는 유능한 코딩 어시스턴트입니다" 같은 한 줄이 답변의 톤과 깊이를 좌우합니다.
안티패턴 5 — 긴 문서에서 질문을 맨 앞에 둠
여러 문서를 붙여넣고 맨 앞에 질문을 두면, 정작 핵심 질문이 긴 본문에 묻힐 수 있습니다.
교정: 긴 문맥에서는 질문을 끝에 배치하세요. 공식 가이드에 따르면 이 방식이 특히 복잡한 다중 문서 입력에서 응답 품질을 테스트 기준 최대 30%까지 높일 수 있습니다. 또한 긴 문서 작업에서는 Claude에게 관련 부분을 먼저 인용하게 한 뒤 작업을 시키면, 나머지 내용의 노이즈를 걷어내는 데 도움이 됩니다.
안티패턴 6 — "트릭"으로 모델을 속이려 함
이상한 형식을 강요하거나 불필요한 역할극을 더해 품질을 끌어올리려는 시도는, 모델이 업데이트되면 더 이상 통하지 않을 수 있습니다.
교정: 원칙적이고 직접적인 기법을 쓰세요. "그냥 되나 보려고" 복잡한 지시를 덧붙이고 있다면, 더 명확한 방법이 있는지 먼저 점검하는 편이 시간을 아낍니다.
안티패턴 7 — 한 프롬프트에 모든 것을 욱여넣음
복잡한 작업을 한 번의 거대한 프롬프트로 끝내려 하면 중간 단계에서 길을 잃기 쉽습니다.
교정: 지시를 순차적 단계(번호 목록·불릿)로 분해하고, 정말 복잡하면 프롬프트 자체를 여러 단계로 체이닝하세요. 각 단계가 명확할수록 Claude가 의도한 방식대로 작업을 수행합니다.
요약
- 모호함 → 맥락·목표·형식을 구체적으로 (황금률: 동료가 헷갈리면 Claude도 헷갈림)
- 예시 부족 → 관련성·다양성 있는 3~5개 예시
- 뒤섞인 입력 → XML 태그로 지시·데이터 구분
- 역할 없음 → system으로 역할 부여
- 긴 문맥 → 질문을 끝에, 관련 부분 먼저 인용
- 트릭 의존 → 원칙적·직접적 기법
- 한 덩어리 → 순차 단계로 분해, 필요시 체이닝
이 글의 권장사항은 Anthropic 공식 프롬프트 엔지니어링 가이드(platform.claude.com/docs)의 원칙을 "흔한 실수 → 교정" 관점으로 재구성한 것입니다. 모델·기법은 변동될 수 있으니 최신 내용은 공식 문서를 확인하세요.