# GPT-5.4/Codex 프롬프트 구조: 클로드코드 버릇 버리고 한 방에 일시키는 법

> 출처: https://retn.kr/blog/codex-prompting-guide-vs-claude-code/ · 수정 2026-09-05 · 리텐션 주식회사

클로드코드 스타일로 GPT-5.4를 쓰면 왜 "다음에 뭐 할까요?" 루프에 빠지는지, 그리고 완료 기준·질문 금지·출력 계약으로 한 방에 끝내는 프롬프트 구조를 정리합니다.

## TLDR

- GPT-5.4와 Codex는 클로드코드(Claude Code)와 프롬프트 구조가 다릅니다. 클로드코드 버릇 그대로 쓰면 "다음에 뭐 할까요?" 루프에 빠집니다.
- 핵심 차이는 **완료 기준, 질문 금지, 행동 강제, 출력 계약** 네 가지입니다.
- 이 글에서는 공식 가이드와 실전 경험을 바탕으로, Codex/GPT-5.4를 한 방에 일시키는 프롬프트 구조를 정리합니다.
- 프롬프트를 바꾸는 것만으로 체감 생산성이 2~3배 뜁니다.

## 클로드코드 버릇이 GPT-5.4에서 통하지 않는 이유

클로드코드와 GPT-5.4/Codex는 기본 동작 방식이 다릅니다. 클로드코드는 AGENTS.md나 CLAUDE.md에 규칙을 박아두면 비교적 자율적으로 끝까지 실행하는 경향이 있습니다. 반면 GPT-5.4는 **완료 기준이 명시되지 않으면 대화형 모드로 전환**됩니다.

쉽게 말하면, 클로드코드에게 "로그인 기능 만들어줘"라고 하면 알아서 끝까지 가는 경우가 많지만, Codex에게 같은 말을 하면 "프론트엔드와 백엔드 중 어떤 걸 먼저 할까요?"라고 묻습니다.

[OpenAI 공식 Codex 프롬프팅 가이드](https://developers.openai.com/codex/prompting?ref=retn.kr)에 따르면, Codex는 에이전트 모드에서도 명시적인 완료 조건과 단계 정의가 없으면 중간 결과를 보여주고 확인을 요청하는 구조로 설계되어 있습니다.

이 차이를 모르고 클로드코드 스타일로 프롬프트를 쓰면 다음과 같은 현상이 반복됩니다:

- "여기까지 했는데 다음 뭐 할까요?"
- 중간 설명만 길게 하고 실행은 안 함
- 같은 질문을 2~3번 반복

## GPT-5.4/Codex를 한 방에 일시키는 7가지 프롬프트 구조

### 1. 완료 정의를 반드시 넣으세요

GPT-5.4는 "Done"이 뭔지 모르면 절대 끝내지 않습니다.

```
<code><COMPLETION_CRITERIA>
- 모든 요구사항 구현 완료
- 코드 실행 가능 상태
- 테스트 통과
- 추가 질문 없이 종료
</COMPLETION_CRITERIA>
</code>
```

이 블록 하나가 없으면 100% "이 다음 뭐할까요?"가 나옵니다.

### 2. 질문 금지 + 가정 허용을 선언하세요

Codex가 질문하는 이유는 불확실성이 생기면 멈추고 사용자 확인을 받으려는 기본 동작 때문입니다. 이걸 끊으려면 명시적으로 차단해야 합니다.

```
<code><RULES>
- 질문하지 말 것
- 정보 부족 시 합리적 가정 후 진행
- 가정은 코드 상단에 주석으로 명시
</RULES>
</code>
```

이 규칙 하나로 체감 개선이 50% 이상입니다.

### 3. 행동과 보고를 분리하세요

GPT-5.4는 "설명"과 "실행"을 구분하지 않으면 설명만 하고 멈춥니다. [공식 Best Practices](https://developers.openai.com/codex/learn/best-practices?ref=retn.kr)에서도 "do the action vs report the action" 분리를 강조합니다.

```
<code>[STEP 1] 코드 수정 실행
[STEP 2] 테스트 실행
[STEP 3] 결과 요약 출력 (3줄 이내)
</code>
```

"분석해줘"와 "수정해줘"를 하나의 프롬프트에 섞으면 높은 확률로 분석 결과만 돌려주고 끝납니다.

### 4. 단계 순서를 강제하세요

Codex는 에이전트이기 때문에 step-by-step 흐름이 명확할수록 끝까지 갑니다.

```
<code><TASK>
1. 현재 코드 분석
2. 문제 원인 파악
3. 수정 코드 작성
4. 테스트 코드 작성
5. 최종 결과 출력
</TASK>
</code>
```

단계 없이 "고쳐줘"만 쓰면 1단계에서 멈추고 "다음은 뭐 할까요?"가 나옵니다.

### 5. 출력 계약(Output Contract)을 걸으세요

GPT-5.4의 특성상, 출력 포맷을 강제하면 행동도 같이 정렬됩니다. 이건 단순 포맷팅이 아니라 실행 범위를 결정하는 역할을 합니다.

```
<code><OUTPUT>
- 수정된 전체 파일
- 변경 diff
- 실행 방법 (3줄 이내)
</OUTPUT>
</code>
```

출력 계약이 없으면 일부만 하고 멈추거나, 질문으로 전환됩니다.

### 6. Initiative Nudge를 넣으세요

[공식 Codex Prompting Guide Cookbook](https://developers.openai.com/cookbook/examples/gpt-5/codex_prompting_guide?ref=retn.kr)에서 소개된 트릭입니다. 첫 답에서 멈추지 말고 끝까지 가라는 명시적 지시입니다.

```
<code><DIG_DEEPER>
- 첫 답에서 멈추지 말 것
- 필요한 경우 추가 수정까지 진행
- 완료될 때까지 반복
</DIG_DEEPER>
</code>
```

이걸 넣으면 중간에 멈추는 비율이 크게 줄어듭니다.

### 7. AGENTS.md를 활용하세요

프로젝트 루트에 AGENTS.md를 두면 매번 프롬프트에 규칙을 반복하지 않아도 됩니다.

```
<code class="language-markdown"># AGENTS.md
- Always finish tasks end-to-end
- Never ask user unless critical
- Run tests before completion
- Output full working code
</code>
```

클로드코드의 CLAUDE.md와 비슷한 개념이지만 ([공식 AGENTS.md 가이드](https://developers.openai.com/codex/guides/agents-md?ref=retn.kr) 참고), Codex에서는 이 파일이 없으면 규칙 자체가 리셋됩니다.

## 초보 프롬프트 vs 고수 프롬프트 비교

**초보 프롬프트:**

> 로그인 기능 만들어줘

결과: 100% 질문함

**고수 프롬프트:**

```
<code>Build a login system.

<RULES>
- Do not ask questions
- Assume missing details
</RULES>

<TASK>
1. Create backend API
2. Add JWT auth
3. Create frontend form
4. Connect API
5. Add validation
</TASK>

<COMPLETION>
- Fully working login system
- No TODO left
</COMPLETION>

<OUTPUT>
- Full code
- Setup steps
</OUTPUT>
</code>
```

결과: 한 번에 끝까지 실행

## 왜 이 차이가 생기는가

[Reddit](https://www.reddit.com/r/ChatGPTPro/?ref=retn.kr)과 실전 사용자 커뮤니티에서도 공통으로 지적하는 핵심은 동일합니다:

> "프롬프트 → 테스트 → 프롬프트 반복은 비효율적이다."

고수들의 공통 패턴은 단순합니다. **대화하지 않고, 작업 스펙 문서처럼 던집니다.**

Codex는 "AI"가 아니라 "첫 출근한 신입 개발자"와 비슷합니다. 스펙 문서 없이 일시키면 계속 물어봅니다. 클로드코드에 비해 자율 판단이 약한 게 아니라, 설계 철학이 "확인 후 실행" 쪽에 가까운 것입니다.

## 클로드코드 사용자가 특히 주의할 점

클로드코드에 익숙한 사용자가 Codex로 넘어올 때 가장 자주 겪는 함정 세 가지입니다:

1. **CLAUDE.md 규칙이 자동 적용될 거라는 기대** — Codex는 AGENTS.md를 별도로 설정해야 합니다.
1. **"알아서 해줘" 스타일** — 클로드코드에선 통하지만 Codex에선 거의 확실하게 질문 루프로 빠집니다.
1. **에러 시 자동 복구 기대** — 클로드코드는 실패하면 다시 시도하는 경향이 있지만, Codex는 에러를 보고하고 멈춥니다. 재시도 규칙도 프롬프트에 넣어야 합니다.

## 실행 가이드: 내 프롬프트를 5분 만에 바꾸는 법

1. 기존 프롬프트 맨 아래에 `<COMPLETION_CRITERIA>` 블록을 추가하세요.
1. `<RULES>` 블록에 "질문하지 말 것, 가정 허용"을 넣으세요.
1. 작업을 `<TASK>` 블록으로 번호 매기세요.
1. `<OUTPUT>` 블록으로 결과물 형태를 지정하세요.
1. 프로젝트에 `AGENTS.md`를 만들어 반복 규칙을 고정하세요.

이 다섯 단계만 적용해도 "다음에 뭐 할까요?" 현상이 거의 사라집니다.

## 자주 묻는 질문 (FAQ)

**Q: 클로드코드와 Codex 중 어떤 게 더 좋은가요?**

둘 다 강점이 다릅니다. 클로드코드는 자율 실행이 강하고, Codex는 명확한 스펙이 주어졌을 때 실행 정확도가 높습니다. 프롬프트 구조를 맞추면 둘 다 생산성이 크게 올라갑니다.

**Q: AGENTS.md는 꼭 필요한가요?**

프로젝트 단위로 반복되는 규칙이 있다면 필수입니다. 없으면 매 세션마다 같은 규칙을 프롬프트에 넣어야 합니다.

**Q: 이 구조가 GPT-5.4가 아닌 다른 모델에도 통하나요?**

대부분의 에이전트형 모델(Gemini, Codex, GPT-5.x)에서 효과가 있습니다. 완료 기준과 질문 금지는 모델에 관계없이 생산성을 올리는 범용 패턴입니다.

**Q: 비개발자도 이 프롬프트 구조를 쓸 수 있나요?**

충분히 가능합니다. 코드를 직접 쓰는 게 아니라 작업 스펙을 구조화하는 것이기 때문에, 마케터나 PM도 바로 적용할 수 있습니다.

## 다음 단계

**직접 시작하기:** - 지금 쓰고 있는 프롬프트에 `<COMPLETION_CRITERIA>`부터 추가해 보세요. - AGENTS.md를 프로젝트 루트에 만들어 보세요.

**전문가와 함께하기:** - AI 에이전트 도입이나 프롬프트 운영 체계를 실제 업무에 붙이고 싶다면: - 📅 [30분 무료 상담 예약](https://tidycal.com/simgyusup/60m?ref=retn.kr)

**관련 글:** - [비개발자를 위한 클로드코드 입문 가이드](/blog/claude-code-for-non-developers/) - [AI 코딩 에이전트, 한 번 세팅하면 복리로 쌓인다](/blog/ai-coding-agent-compound-effect/)

> **Claude Code·Codex를 내 일에 직접 써 보고 싶다면**
>
> GET SHIP DONE · 리텐션의 AI 실행 교육Codex 기본기 VoD로 바로 시작하거나, 1:1~4인 과외반에서 내 문제를 가져와 함께 만듭니다.
>
> [Get Ship Done 보기 →](https://retn.kr/getshipdone/?utm_source=blog&utm_medium=cta&utm_campaign=gsd&utm_content=codex-prompting-guide-vs-claude-code)