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 연결 문자열