Claude 4 프롬프트 엔지니어링 모범 사례

https://docs.anthropic.com/en/docs/build-with-claude/prompt-engineering/claude-4-best-practices

일반 원칙

명시적인 지시사항 제공

Claude 4 모델은 명확하고 명시적인 지시사항에 잘 반응합니다. 원하는 출력에 대해 구체적으로 명시하면 결과를 향상시킬 수 있습니다. 이전 Claude 모델의 "그 이상의" 행동을 원하는 고객들은 Claude 4에서 이러한 행동을 더 명시적으로 요청해야 할 수 있습니다.

예시: 분석 대시보드 만들기

덜 효과적인 방법:

분석 대시보드를 만들어 주세요

더 효과적인 방법:

분석 대시보드를 만들어 주세요. 가능한 한 많은 관련 기능과 상호작용을 포함해 주세요. 기본적인 것을 넘어서 완전한 기능을 갖춘 구현을 만들어 주세요.

성능 향상을 위한 맥락 추가

지시사항 뒤의 맥락이나 동기를 제공하는 것, 예를 들어 Claude에게 그러한 행동이 왜 중요한지 설명하는 것은 Claude 4가 당신의 목표를 더 잘 이해하고 더 표적화된 응답을 제공하는 데 도움이 될 수 있습니다.

예시: 형식 선호도

덜 효과적인 방법:

절대 줄임표를 사용하지 마세요

더 효과적인 방법:

당신의 응답은 텍스트 음성 변환 엔진에 의해 소리내어 읽혀질 것이므로, 텍스트 음성 변환 엔진이 어떻게 발음해야 할지 모르기 때문에 절대 줄임표를 사용하지 마세요.

Claude는 설명으로부터 일반화할 만큼 똑똑합니다.

예시와 세부사항에 주의 깊게

Claude 4 모델은 지시사항 준수의 일환으로 세부사항과 예시에 주의를 기울입니다. 당신의 예시가 장려하고 싶은 행동과 일치하고 피하고 싶은 행동을 최소화하도록 확인하세요.

특정 상황에 대한 지침

응답 형식 제어

Claude 4 모델에서 출력 형식을 조절하는 데 특히 효과적임을 발견한 몇 가지 방법이 있습니다:

하지 말라고 하는 것이 아니라 무엇을 해야 하는지 Claude에게 알려주세요
- 대신에: "응답에 마크다운을 사용하지 마세요"
- 시도해보세요: "당신의 응답은 부드럽게 흐르는 산문 단락으로 구성되어야 합니다."
XML 형식 지시자 사용
- 시도해보세요: "응답의 산문 섹션을 <smoothly_flowing_prose_paragraphs> 태그 안에 작성하세요."
프롬프트 스타일을 원하는 출력에 맞추세요

프롬프트에서 사용된 형식 스타일이 Claude의 응답 스타일에 영향을 줄 수 있습니다. 출력 형식에 대한 조절 가능성 문제가 여전히 발생한다면, 가능한 한 프롬프트 스타일을 원하는 출력 스타일에 맞추는 것을 권장합니다. 예를 들어, 프롬프트에서 마크다운을 제거하면 출력에서 마크다운의 양을 줄일 수 있습니다.

사고 및 중간 사고 기능 활용

Claude 4는 도구 사용 후 반성이나 복잡한 다단계 추론을 포함하는 작업에 특히 도움이 될 수 있는 사고 기능을 제공합니다. 더 나은 결과를 위해 초기 또는 중간 사고를 안내할 수 있습니다.

예시 프롬프트

도구 결과를 받은 후, 그 품질을 신중히 반성하고 진행하기 전에 최적의 다음 단계를 결정하세요. 이 새로운 정보를 바탕으로 계획하고 반복하기 위해 당신의 사고를 사용하고, 그 다음 최선의 행동을 취하세요.

병렬 도구 호출 최적화

Claude 4 모델은 병렬 도구 실행에 뛰어납니다. 별다른 프롬프트 없이도 병렬 도구 호출을 사용하는 데 높은 성공률을 보이지만, 약간의 프롬프트를 통해 이 행동을 ~100% 병렬 도구 사용 성공률로 높일 수 있습니다. 다음 프롬프트가 가장 효과적임을 발견했습니다:

에이전트용 샘플 프롬프트

최대 효율성을 위해, 여러 독립적인 작업을 수행해야 할 때마다 순차적이 아닌 동시에 모든 관련 도구를 호출하세요.

에이전틱 코딩에서 파일 생성 줄이기

Claude 4 모델은 특히 코드 작업 시 테스트 및 반복 목적으로 새 파일을 생성하는 경우가 있습니다. 이 접근법은 Claude가 최종 출력을 저장하기 전에 파일, 특히 파이썬 스크립트를 '임시 메모장'으로 사용할 수 있게 해줍니다. 임시 파일 사용은 특히 에이전틱 코딩 사용 사례에서 결과를 향상시킬 수 있습니다.

새 파일 생성을 최소화하고 싶다면, Claude에게 정리하도록 지시할 수 있습니다:

샘플 프롬프트

반복을 위한 임시 새 파일, 스크립트, 또는 헬퍼 파일을 생성하면, 작업 종료 시 이러한 파일들을 제거하여 정리하세요.

시각적 및 프런트엔드 코드 생성 향상

프런트엔드 코드 생성의 경우, 명시적인 격려를 제공하여 Claude 4 모델이 복잡하고 상세하며 상호작용적인 디자인을 만들도록 유도할 수 있습니다:

주저하지 마세요. 최선을 다해주세요.

또한 집중해야 할 것에 대한 추가 수정자와 세부사항을 제공하여 특정 영역에서 Claude의 프런트엔드 성능을 향상시킬 수 있습니다:

"가능한 한 많은 관련 기능과 상호작용을 포함하세요"
"호버 상태, 전환, 마이크로 상호작용과 같은 사려 깊은 세부사항을 추가하세요"
"웹 개발 역량을 보여주는 인상적인 데모를 만드세요"
"디자인 원칙을 적용하세요: 계층, 대비, 균형, 움직임"

마이그레이션 고려사항

Sonnet 3.7에서 Claude 4로 마이그레이션할 때:

원하는 행동에 대해 구체적으로 설명하세요: 출력에서 보고 싶은 것을 정확히 설명하는 것을 고려하세요.
수정자로 지시사항을 구성하세요: Claude가 출력의 품질과 세부사항을 높이도록 격려하는 수정자를 추가하면 Claude의 성능을 더 잘 형성하는 데 도움이 될 수 있습니다. 예를 들어, "분석 대시보드를 만들어 주세요" 대신 "분석 대시보드를 만들어 주세요. 가능한 한 많은 관련 기능과 상호작용을 포함해 주세요. 기본적인 것을 넘어서 완전한 기능을 갖춘 구현을 만들어 주세요."를 사용하세요.
특정 기능을 명시적으로 요청하세요: 애니메이션과 상호작용 요소는 원할 때 명시적으로 요청해야 합니다.