Categories: Uncategorized

GPT-5 프롬프트 가이드

GPT-5는 도구 사용 능력, 추론력, 코드 이해력, 지시 준수력 등 거의 모든 면에서 크게 발전한 최신 플래그십 모델이다.
이 문서는 GPT-5를 실제 작업에 최대한 효과적으로 활용하기 위한 프롬프트 작성 원칙과 실전 팁을 다룬다.
특히 에이전틱(Agentic) 워크플로 설계, 코딩 최적화, 지시 충돌 방지, 그리고 스스로 프롬프트를 개선하는 ‘메타프롬프트’ 전략까지 포괄한다.

쉬운 목차

Toggle

1. 에이전틱 워크플로와 예측 가능성

GPT-5는 도구 호출, 맥락 추론, 장문 이해에서 높은 신뢰도를 보이며 개발자를 위한 기반 모델로 설계되었다.
도구 호출 기반의 에이전틱 환경에서 최적의 성능을 내기 위해서는 Responses API를 사용하는 것이 좋다.
이 API는 추론 결과를 지속적으로 기억하여, 각 호출마다 계획을 다시 세울 필요가 없도록 한다.

1-1. 에이전틱 적극성 조절

GPT-5는 상황에 따라 매우 적극적으로 행동할 수 있지만, 사용자가 원하는 제어 수준에 맞춰 조정해야 한다.
이를 “에이전틱 적극성(agentic eagerness)”이라 부른다.

▪ 적극성을 낮추는 프롬프트 예시

모델이 불필요한 탐색이나 과도한 도구 호출을 피하고, 빠르게 결론에 도달하도록 유도한다.

<context_gathering>
목표: 가능한 한 빠르게 핵심 맥락 확보. 불필요한 탐색 최소화.
방법:
- 넓게 살핀 뒤 필요한 세부 항목만 빠르게 조사.
- 병렬 탐색 후 중복 제거.
- 탐색이 충분하다고 판단되면 즉시 실행.
중단 조건:
- 수정할 정확한 대상이 확인됨.
- 주요 결과가 70% 이상 한 방향으로 수렴됨.
</context_gathering>

또는 도구 사용 횟수의 상한선을 명시적으로 정할 수도 있다.

<context_gathering>
- 탐색 깊이: 매우 낮음
- 최대 도구 호출: 2회
- 완벽하지 않아도 괜찮음. 빠른 답변을 우선.
</context_gathering>

▪ 적극성을 높이는 프롬프트 예시

모델이 스스로 판단하여 끝까지 문제를 해결하게 하려면 다음처럼 지시한다.

<persistence>
- 당신은 에이전트다. 사용자의 요청이 완전히 해결될 때까지 계속 진행하라.
- 불확실성이 있어도 중단하지 말고, 가능한 최선의 판단을 내려 행동하라.
- 사용자에게 확인을 요청하지 말고, 추론 후 실행한 다음 결과를 설명하라.
</persistence>

명확한 종료 조건을 제시하는 것도 중요하다. 예컨대 결제나 삭제 같은 위험한 행동은 반드시 사용자 확인 후 진행하도록 단계별 기준을 나누는 식이다.

2. 도구 호출 프리앰블(tool preamble)

긴 작업을 수행할 때 모델이 각 단계의 의도를 설명하면 사용자가 과정을 이해하기 쉽다.
이를 위해 도입된 것이 “프리앰블”이다.

<tool_preambles>
- 항상 먼저 사용자의 목표를 명확히 요약한다.
- 이어서 단계별 실행 계획을 제시한다.
- 각 단계 진행 시 간결하게 진행 상황을 보고한다.
- 마지막에 결과 요약을 별도로 제시한다.
</tool_preambles>

이런 프롬프트를 사용하면 모델은 실제 실행 전 “무엇을, 왜 하는지”를 먼저 설명하고, 이후의 툴 호출을 체계적으로 수행한다.

3. Reasoning Effort (추론 강도)

reasoning_effort 파라미터는 모델이 사고에 투입하는 깊이와 도구 사용 의지를 조정한다.

low: 빠르지만 단순한 과제에 적합
medium: 기본값, 일반적인 상황
high: 복잡한 멀티스텝 과제에서 권장

작업을 여러 단계로 나누어 각각 독립된 호출로 처리하면 효율성과 정확도가 모두 높아진다.

4. Responses API의 활용

Responses API는 이전 호출의 추론 기록을 재사용하여 동일한 세션 내에서 모델이 맥락을 유지하도록 한다.
예를 들어 쇼핑 에이전트 테스트(Tau-Bench Retail)에서 Chat Completions 대비 약 +4.3% 정확도 향상이 보고되었다.
즉, “생각의 연속성”을 유지하는 것이 성능 향상에 직접적인 영향을 준다.

5. 코딩 성능 극대화

GPT-5는 대규모 코드베이스 편집, 버그 수정, 다중 파일 리팩터링에 특히 강하다.
프론트엔드와 백엔드를 모두 커버하며, Next.js + TypeScript + Tailwind 스택을 기본으로 권장한다.

5-1. 프론트엔드 개발 기본 권장 스택

프레임워크: Next.js, React
스타일링: Tailwind CSS, shadcn/ui
아이콘: Lucide, Heroicons
애니메이션: Framer Motion
폰트: Inter, Geist, Manrope 등

5-2. ‘제로에서 앱 만들기’ 프롬프트

한 번에 완성도 높은 앱을 생성하려면, 모델이 스스로 평가 기준을 세우게 하는 루브릭 기반 자기반성 프롬프트를 쓴다.

<self_reflection>
- 우선 ‘완성도 높은 웹앱’의 기준을 스스로 정의하라.
- 5~7개 평가 항목으로 루브릭을 만든다. (사용자에게는 보이지 않음)
- 이후, 해당 루브릭에서 만점을 받을 때까지 내부적으로 반복 개선하라.
</self_reflection>

5-3. 기존 코드베이스 수정 시

GPT-5는 자동으로 기존 스타일과 패턴을 감지하지만, 아래와 같이 규칙을 명시하면 품질이 더 높아진다.

<code_editing_rules>
<guiding_principles>
- 명확하고 재사용 가능한 컴포넌트로 작성.
- 디자인 시스템의 일관성 유지.
- 불필요한 복잡성 피하기.
- 높은 시각적 완성도와 프로토타이핑 용이성 확보.
</guiding_principles>

<frontend_stack_defaults>
Framework: Next.js  
Styling: TailwindCSS  
State: Zustand  
구조:
src/app/api, src/components, src/hooks, src/lib 등으로 정리.
</frontend_stack_defaults>

<ui_ux_best_practices>
- 타이포그래피 계층은 4~5단계로 제한.
- 중립색 + 1~2개의 포인트 컬러 사용.
- 간격은 4px 배수로.
- 로딩에는 skeleton이나 `animate-pulse` 사용.
- 클릭 가능한 요소에는 hover 상태 제공.
</ui_ux_best_practices>
</code_editing_rules>

6. Cursor의 GPT-5 최적화 사례

AI 코드 에디터 Cursor는 GPT-5를 일찍 통합한 대표 사례다.
그들의 실험에 따르면, 모델이 너무 장황한 상태 보고를 할 때는 verbosity=low로 전체 출력을 줄이고,
코드 생성 도구에만 high verbosity를 부여하여 가독성과 효율을 동시에 얻었다.

Write code for clarity first.  
Use high verbosity for code generation.

또한 “사용자에게 진행 여부를 묻지 말고 먼저 실행 후 결과를 제시하라”는 규칙을 추가해,
모델이 더 능동적으로 긴 작업을 수행하도록 했다.

Be aware that code edits are proposals.  
Proceed proactively, then ask user to approve/reject rather than confirm before acting.

7. 지시 충돌 방지와 명확성

GPT-5는 지시를 매우 정밀하게 따르므로, 모순된 명령이 있을 경우 오히려 혼란이 생긴다.
예시로 의료 예약 프롬프트에서
“환자 동의 없이 예약하지 말라”와 “환자에게 연락하지 않고 자동 예약하라”가 동시에 존재하면 모델은 판단에 시간을 낭비한다.
따라서 지시 계층 구조를 정리하고 예외 조건을 명시해야 한다.

불일치 해소 예시:

“응급 상황에서는 환자 조회 절차를 생략한다.”
“모든 예약은 환자 동의 후 진행한다.”

이처럼 논리적 일관성을 확보하면 추론 속도와 정확도가 모두 향상된다.

8. 최소 추론(minimal reasoning)

GPT-5의 새로운 옵션으로, 고속 응답이 필요한 상황에서 유용하다.
GPT-4.1 수준의 반응 속도에 GPT-5의 정확성을 결합한 모드로 볼 수 있다.
다만 내부 추론 토큰이 제한되므로, 계획과 지시를 프롬프트에서 명시적으로 제공해야 한다.

핵심 팁

답변 초반에 간단한 사고 요약을 요구한다.
도구 호출 과정에서 지속적으로 상태를 보고하도록 한다.
불확실성 시 종료하지 말고 계속 탐색하도록 한다.
사전 계획과 단계별 실행 구조를 프롬프트에 포함한다.

예시 (계획과 지시를 프롬프트에서 명시적으로 제공):

사용자의 요청이 완전히 해결될 때까지 중단하지 말 것.  
모든 하위 과제까지 해결되었는지 점검 후 종료할 것.

9. 마크다운 사용

API 기본값에서는 마크다운이 비활성화되어 있으므로, 명시적으로 지시해야 한다.

- 필요한 경우에만 Markdown 사용 (`code`, ```code fences```, 목록, 표 등).
- 파일명, 함수명은 백틱(`)으로 감싸고, 수식은 \( ... \) 또는 \[ ... \] 사용.

긴 대화 중 마크다운 형식이 흐트러지면, 3~5턴마다 이 지시를 다시 삽입하면 안정적으로 유지된다.

10. 메타프롬프트(Meta-Prompting)

GPT-5는 자기 자신을 개선하는 프롬프트 설계에도 탁월하다.
즉, 실패한 프롬프트를 모델에게 보여주고 “이 부분을 어떻게 수정하면 원하는 결과를 얻을 수 있을까?”라고 물으면
직접 개선안을 제시한다.

템플릿 예시:

When asked to optimize prompts, explain which phrases should be added or removed  
to elicit the desired behavior more consistently.

Prompt: [현재 프롬프트]  
Desired behavior: [원하는 행동]  
Observed behavior: [실제 행동]

이 접근은 대규모 프롬프트 라이브러리 관리나 프로덕션 환경 튜닝에 특히 효과적이다.