Codex 입문: 가장 먼저 해야 할 3가지 작업 (복사/붙여넣기 가능한 프롬프트 포함)

5분 만에 읽을 수 있음 · AI 시스템 아키텍트가 집필

주력 분야: Codex 입문 · AI 코딩 도구

ChatGPT는 채팅으로 질문에 답하는 것만 합니다. 하지만 Codex는 사용자의 프로젝트 내에서 실제로 작업합니다. 파일을 읽고, 코드를 수정하고, 명령을 실행하며, 무엇이 변경되었는지 diff로 보여줍니다.

초보자가 가장 흔하게 하는 실수: '프로젝트 전체를 리팩토링해 줘'라며 한 번에 큰 작업을 요청하는 것입니다.

올바른 순서:

프로젝트 읽기 → 계획 수립 → 작은 변경 → diff 확인 → 테스트 → 반복

진입점	추천 대상
Codex App ⭐	초보자용
IDE 확장	VS Code / Cursor 사용자
CLI	터미널 조작에 익숙한 사람
Web / Cloud	GitHub 자동화

Codex App을 다운로드하고 ChatGPT 계정으로 로그인하세요. 작은 프로젝트를 골라 연습해 보세요.

다음 내용을 복사/붙여넣기 하세요:

아직 파일을 변경하지 마세요. 이 프로젝트에 대해 설명해 주세요:
1. 이 프로젝트는 무엇을 하는 것인가요?
2. 메인 디렉터리의 역할은 무엇인가요?
...

프롬프트는 다음 4가지 요소로 구성합니다:

요소	내용
Goal (목표)	무엇을 달성하고 싶은지
Context (문맥)	관련 파일, 에러 정보
Constraints (제약)	금지 사항 (새로운 의존성 추가 금지 등)
Done when (완료 조건)	성공 확인 방법

나쁜 예: '체크아웃 처리를 최적화해 줘'

좋은 예:

Goal:
src/checkout/
의 중복 유효성 검사(validation)를 줄이기
Context:src/checkout/와 src/orders/validation.ts
Constraints: 공개 API 변경 금지, 새로운 의존성 추가 금지
Done when:pnpm test --filter checkout가 모두 통과하고, diff는 src/checkout/만

README.md만 변경해 주세요. '서론' 섹션을 추가해 주세요.
다른 파일은 건드리지 마세요. 새로운 의존성도 추가하지 마세요.
변경 후, 무엇을 바꿨는지 알려주세요.

git status # 변경 파일을 확인
git diff # 변경 내용을 확인

• ✅ 허가되지 않은 파일을 변경하지 않았는가?
• ✅ 모르는 의존성이 추가되지 않았는가?
• ✅ 중요한 설정이 삭제되지 않았는가?
• ✅ 내용이 요구사항을 충족하는가?

모드	초보자 규칙
Chat / 읽기 전용	✅ 일단 여기서부터
Agent / 자동	✅ diff를 확인한 후에
완전 접근	❌ 처음부터 사용하지 않기

❌ API 키, 데이터베이스 비밀번호, 운영(production) 토큰

❌ 고객 데이터, 개인정보

❌ 운영 DB 연결 문자열

git add .
git commit -m