출처: https://docs.anthropic.com/en/docs/build-with-claude/prompt-engineering/claude-4-best-practices
이 가이드는 Claude 4 모델(Opus 4, Sonnet 4)에서 최적의 결과를 얻기 위한 구체적인 프롬프트 엔지니어링 기법을 제공합니다. 이 모델들은 이전 세대 Claude 모델보다 더 정밀한 지시 따르기 능력을 갖추고 있습니다.
일반 원칙
지시를 명확하게 작성하세요
Claude 4 모델은 명확하고 구체적인 지시에 잘 반응합니다. 원하는 출력에 대해 구체적으로 설명하면 결과가 향상됩니다. 이전 Claude 모델의 "기대 이상의" 행동을 원한다면, Claude 4에서는 이를 더 명시적으로 요청해야 할 수 있습니다.
예시: 분석 대시보드 생성
- 덜 효과적:
Create an analytics dashboard- 더 효과적:
Create an analytics dashboard. Include as many relevant features and interactions as possible. Go beyond the basics to create a fully-featured implementation.맥락을 추가해 성능을 높이세요
지시의 맥락이나 동기를 설명하면 Claude 4가 목표를 더 잘 이해하고, 더 적합한 답변을 제공합니다.
예시: 포맷팅 선호도
- 덜 효과적:
NEVER use ellipses- 더 효과적:
Your response will be read aloud by a text-to-speech engine, so never use ellipses since the text-to-speech engine will not know how to pronounce them.Claude는 이러한 설명에서 일반화할 수 있을 만큼 충분히 똑똑합니다.
예시와 세부사항에 신경 쓰세요
Claude 4 모델은 지시를 따를 때 예시와 세부사항을 꼼꼼히 살핍니다. 원하는 행동을 유도하는 예시만 포함하고, 피하고 싶은 행동은 최소화하세요.
상황별 가이드
응답 형식 제어하기
Claude 4에서 출력 형식을 효과적으로 제어하는 방법은 다음과 같습니다:
- 하지 말라는 것보다 하라는 것을 명확히 지시
- 예: "Do not use markdown in your response" 대신
- "Your response should be composed of smoothly flowing prose paragraphs."
- XML 형식 태그 사용
- 예: "Write the prose sections of your response in
tags."
- 예: "Write the prose sections of your response in
- 프롬프트 스타일을 원하는 출력 스타일과 맞추기
- 프롬프트에서 사용한 포맷팅 스타일이 Claude의 응답 스타일에 영향을 줄 수 있습니다. 출력에 마크다운이 너무 많다면 프롬프트에서 마크다운을 제거해보세요.
사고(Thinking) 및 중간 사고(Interleaved Thinking) 활용
Claude 4는 도구 사용 후 반영(reflection)이나 복잡한 다단계 추론이 필요한 작업에서 사고 기능을 제공합니다. 초기 또는 중간 사고를 유도하면 더 나은 결과를 얻을 수 있습니다.
예시 프롬프트
After receiving tool results, carefully reflect on their quality and determine optimal next steps before proceeding. Use your thinking to plan and iterate based on this new information, and then take the best next action.자세한 사고 기능 안내는 Extended thinking 문서를 참고하세요.
병렬 도구 호출 최적화
Claude 4는 병렬 도구 실행에 매우 능숙합니다. 별도의 프롬프트 없이도 병렬 호출을 잘 수행하지만, 약간의 프롬프트 추가로 성공률을 거의 100%까지 높일 수 있습니다.
에이전트용 샘플 프롬프트
For maximum efficiency, whenever you need to perform multiple independent operations, invoke all relevant tools simultaneously rather than sequentially.에이전트 코딩에서 파일 생성 최소화
Claude 4는 코드 작업 시 테스트 및 반복을 위해 임시 파일을 생성할 수 있습니다. 특히 파이썬 스크립트 등은 최종 결과를 저장하기 전 임시 작업 공간으로 활용됩니다. 임시 파일 사용은 에이전트 코딩에서 결과를 개선할 수 있습니다.
임시 파일 생성을 최소화하고 싶다면 다음과 같이 지시하세요:
샘플 프롬프트
If you create any temporary new files, scripts, or helper files for iteration, clean up these files by removing them at the end of the task.시각적/프론트엔드 코드 생성 강화
프론트엔드 코드 생성 시, 명확한 격려 문구를 추가하면 Claude 4가 더 복잡하고 세련된 인터랙티브 디자인을 생성할 수 있습니다.
샘플 프롬프트
Don't hold back. Give it your all.아래와 같은 추가 지시로 프론트엔드 성능을 더욱 높일 수 있습니다:
- "Include as many relevant features and interactions as possible"
- "Add thoughtful details like hover states, transitions, and micro-interactions"
- "Create an impressive demonstration showcasing web development capabilities"
- "Apply design principles: hierarchy, contrast, balance, and movement"
마이그레이션 시 고려사항
Sonnet 3.7에서 Claude 4로 이전할 때:
- 원하는 행동을 구체적으로 명시: 출력에서 보고 싶은 내용을 정확히 설명하세요.
- 지시문에 수식어 추가: 결과의 품질과 세부사항을 높이도록 Claude에 요청하는 수식어를 추가하세요. 예) "Create an analytics dashboard" 대신 "Create an analytics dashboard. Include as many relevant features and interactions as possible. Go beyond the basics to create a fully-featured implementation."
- 특정 기능은 명확히 요청: 애니메이션, 인터랙티브 요소 등은 반드시 명시적으로 요청하세요.
