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 프롬프팅 가이드에 따르면, Codex는 에이전트 모드에서도 명시적인 완료 조건과 단계 정의가 없으면 중간 결과를 보여주고 확인을 요청하는 구조로 설계되어 있습니다.
이 차이를 모르고 클로드코드 스타일로 프롬프트를 쓰면 다음과 같은 현상이 반복됩니다:
- "여기까지 했는데 다음 뭐 할까요?"
- 중간 설명만 길게 하고 실행은 안 함
- 같은 질문을 2~3번 반복
GPT-5.4/Codex를 한 방에 일시키는 7가지 프롬프트 구조
1. 완료 정의를 반드시 넣으세요
GPT-5.4는 "Done"이 뭔지 모르면 절대 끝내지 않습니다.
<COMPLETION_CRITERIA>
- 모든 요구사항 구현 완료
- 코드 실행 가능 상태
- 테스트 통과
- 추가 질문 없이 종료
</COMPLETION_CRITERIA>
이 블록 하나가 없으면 100% "이 다음 뭐할까요?"가 나옵니다.
2. 질문 금지 + 가정 허용을 선언하세요
Codex가 질문하는 이유는 불확실성이 생기면 멈추고 사용자 확인을 받으려는 기본 동작 때문입니다. 이걸 끊으려면 명시적으로 차단해야 합니다.
<RULES>
- 질문하지 말 것
- 정보 부족 시 합리적 가정 후 진행
- 가정은 코드 상단에 주석으로 명시
</RULES>
이 규칙 하나로 체감 개선이 50% 이상입니다.
3. 행동과 보고를 분리하세요
GPT-5.4는 "설명"과 "실행"을 구분하지 않으면 설명만 하고 멈춥니다. 공식 Best Practices에서도 "do the action vs report the action" 분리를 강조합니다.
[STEP 1] 코드 수정 실행
[STEP 2] 테스트 실행
[STEP 3] 결과 요약 출력 (3줄 이내)
"분석해줘"와 "수정해줘"를 하나의 프롬프트에 섞으면 높은 확률로 분석 결과만 돌려주고 끝납니다.
4. 단계 순서를 강제하세요
Codex는 에이전트이기 때문에 step-by-step 흐름이 명확할수록 끝까지 갑니다.
<TASK>
1. 현재 코드 분석
2. 문제 원인 파악
3. 수정 코드 작성
4. 테스트 코드 작성
5. 최종 결과 출력
</TASK>
단계 없이 "고쳐줘"만 쓰면 1단계에서 멈추고 "다음은 뭐 할까요?"가 나옵니다.
5. 출력 계약(Output Contract)을 걸으세요
GPT-5.4의 특성상, 출력 포맷을 강제하면 행동도 같이 정렬됩니다. 이건 단순 포맷팅이 아니라 실행 범위를 결정하는 역할을 합니다.
<OUTPUT>
- 수정된 전체 파일
- 변경 diff
- 실행 방법 (3줄 이내)
</OUTPUT>
출력 계약이 없으면 일부만 하고 멈추거나, 질문으로 전환됩니다.
6. Initiative Nudge를 넣으세요
공식 Codex Prompting Guide Cookbook에서 소개된 트릭입니다. 첫 답에서 멈추지 말고 끝까지 가라는 명시적 지시입니다.
<DIG_DEEPER>
- 첫 답에서 멈추지 말 것
- 필요한 경우 추가 수정까지 진행
- 완료될 때까지 반복
</DIG_DEEPER>
이걸 넣으면 중간에 멈추는 비율이 크게 줄어듭니다.
7. AGENTS.md를 활용하세요
프로젝트 루트에 AGENTS.md를 두면 매번 프롬프트에 규칙을 반복하지 않아도 됩니다.
# AGENTS.md
- Always finish tasks end-to-end
- Never ask user unless critical
- Run tests before completion
- Output full working code
클로드코드의 CLAUDE.md와 비슷한 개념이지만 (공식 AGENTS.md 가이드 참고), Codex에서는 이 파일이 없으면 규칙 자체가 리셋됩니다.
초보 프롬프트 vs 고수 프롬프트 비교
초보 프롬프트:
로그인 기능 만들어줘
결과: 100% 질문함
고수 프롬프트:
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>
결과: 한 번에 끝까지 실행
왜 이 차이가 생기는가
Reddit과 실전 사용자 커뮤니티에서도 공통으로 지적하는 핵심은 동일합니다:
"프롬프트 → 테스트 → 프롬프트 반복은 비효율적이다."
고수들의 공통 패턴은 단순합니다. 대화하지 않고, 작업 스펙 문서처럼 던집니다.
Codex는 "AI"가 아니라 "첫 출근한 신입 개발자"와 비슷합니다. 스펙 문서 없이 일시키면 계속 물어봅니다. 클로드코드에 비해 자율 판단이 약한 게 아니라, 설계 철학이 "확인 후 실행" 쪽에 가까운 것입니다.
클로드코드 사용자가 특히 주의할 점
클로드코드에 익숙한 사용자가 Codex로 넘어올 때 가장 자주 겪는 함정 세 가지입니다:
- CLAUDE.md 규칙이 자동 적용될 거라는 기대 — Codex는 AGENTS.md를 별도로 설정해야 합니다.
- "알아서 해줘" 스타일 — 클로드코드에선 통하지만 Codex에선 거의 확실하게 질문 루프로 빠집니다.
- 에러 시 자동 복구 기대 — 클로드코드는 실패하면 다시 시도하는 경향이 있지만, Codex는 에러를 보고하고 멈춥니다. 재시도 규칙도 프롬프트에 넣어야 합니다.
실행 가이드: 내 프롬프트를 5분 만에 바꾸는 법
- 기존 프롬프트 맨 아래에
<COMPLETION_CRITERIA>블록을 추가하세요. <RULES>블록에 "질문하지 말 것, 가정 허용"을 넣으세요.- 작업을
<TASK>블록으로 번호 매기세요. <OUTPUT>블록으로 결과물 형태를 지정하세요.- 프로젝트에
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분 무료 상담 예약
관련 글: - 비개발자를 위한 클로드코드 입문 가이드 - AI 코딩 에이전트, 한 번 세팅하면 복리로 쌓인다