Codex 사용법, 첫 요청부터 결과 확인까지
목차 보기
Codex(코덱스)는 프로젝트 파일을 읽고 말로 받은 요청에 따라 코드를 수정하는 AI 도구입니다. 앱에서 작업할 폴더를 열고, 작은 수정 하나를 요청한 뒤, 바뀐 파일·검사 결과·실제 화면을 확인하면 첫 작업을 끝낼 수 있습니다.
이미 홈페이지 같은 프로젝트 폴더가 있는 독자를 위한 데스크톱 앱 안내입니다. 아래 요청은 설명용 예시이며, 앱의 시작·검토 절차는 2026년 10월 9일 공식 문서로 확인했습니다.
시작 전에 확인할 것
- 사용할 계정: 내 플랜에서 Codex를 제공하는지 확인합니다. 구독과 API 결제의 차이는 Codex 요금제에서 볼 수 있습니다.
- 작업할 폴더: 이번에 고칠 홈페이지 파일이 있는 폴더를 준비합니다.
- 기존 수정: 직접 고친 파일을 따로 보관하거나 Git에 기록합니다. Git은 파일의 변경 이력을 관리하는 도구입니다.
현재 공식 데스크톱 앱은 macOS·Windows·Linux에서 제공합니다. 앱을 설치하고 계정으로 로그인한 뒤 Codex를 선택해 시작합니다. 터미널에서 명령어로 쓰는 CLI와 편집기 안에서 쓰는 확장도 있습니다. 공식 빠른 시작
1. 작업할 폴더부터 확인하기
앱에서 프로젝트를 만들거나 선택하고 이번에 고칠 폴더를 연결합니다. 기존 프로젝트의 폴더를 바꾸려면 프로젝트 메뉴의 Edit project → Add folder에서 설정할 수 있습니다. 여러 폴더가 있다면 기본 작업 위치인 primary 폴더도 확인합니다. 공식 프로젝트 안내
처음에는 프로젝트 하나의 폴더로 시작하면 대상이 분명합니다. 홈페이지를 고치려는데 자료 보관 폴더를 열었다면 요청 내용이 좋아도 원하는 파일을 찾을 수 없습니다.
New chat에서 다음처럼 먼저 물어봅니다.
이 폴더의 홈페이지 구조를 쉽게 설명해줘. 화면에 보이는 제목이 어느 파일에 있는지 알려주고, 아직 수정하지는 마.
답변의 파일이 내가 고치려던 페이지와 같은지 확인합니다. 파일 이름을 모르더라도 “이 파일은 화면의 어느 부분을 담당해?”라고 이어서 물어볼 수 있습니다.
2. 작은 수정 하나를 요청하기
첫 요청은 수정 전후를 눈으로 비교할 수 있는 일이 좋습니다.
홈페이지 제목을 ‘Simply AI’로 바꿔줘. 제목 문구만 수정하고 글꼴, 배치, 다른 문장과 내가 미리 수정한 내용은 유지해줘. 바꾼 파일과 확인 결과를 알려줘.
이 요청에는 바꿀 것·유지할 것·확인할 결과가 들어 있습니다. “홈페이지를 개선해줘”보다 결과를 판단하기 쉽습니다.
설명용 파일에서 제목을 바꾼 결과는 다음처럼 비교할 수 있습니다.
-<h1>AI guide</h1>
+<h1>Simply AI</h1>
-는 이전 내용, +는 새 내용입니다. minml의 별도 예제에서는 제목 한 줄만 바뀌고 미리 수정한 footer, 즉 페이지 아래쪽 문구가 유지되는 것을 확인했습니다. 실제 프로젝트에서는 제목 외의 파일도 바뀌었는지 함께 봅니다.
3. 권한 요청의 대상 읽기
권한은 Codex가 파일을 고치거나 명령을 실행할 수 있는 범위입니다. 현재 채팅의 권한 모드를 확인하고, 승인 요청이 나오면 무엇을 위해 어떤 파일·명령을 다루는지 읽습니다. 공식 권한 안내
검사 명령이 낯설다면 다음처럼 설명을 요청합니다.
이 명령이 무엇을 확인하고 어떤 파일에 영향을 주는지 쉽게 설명해줘.
제목 수정 중에 파일 삭제나 실제 사이트 업로드가 등장했다면 이번 요청에 필요한 작업인지 먼저 확인합니다. 파일 수정과 사이트 공개는 서로 다른 행동입니다.
4. 변경 검토 화면의 범위 구분하기
수정 전후를 비교하는 화면을 diff라고 합니다. 앱의 검토 화면은 Git 저장소가 있는 프로젝트에서 사용할 수 있습니다. 이 화면에는 Codex가 고친 내용과 내가 직접 고친 내용이 함께 표시될 수 있습니다. 공식 변경 검토
범위 선택은 무엇을 확인할지에 따라 고릅니다.
| 검토 범위 | 보여주는 것 |
|---|---|
| Last turn | 가장 최근 AI 응답 차례의 변경 |
| Unstaged | 아직 커밋할 목록에 올리지 않은 변경 |
| Staged | 커밋할 목록에 올린 변경 |
커밋은 파일의 변경 기록을 남기는 일이고, 스테이징은 그 기록에 넣을 변경을 골라 두는 일입니다. 같은 파일이 두 목록에 보일 수도 있습니다. 공식 검토 범위
먼저 최근 작업의 변경을 보고, 기존 수정과 함께 현재 파일이 어떤 상태인지 확인합니다. 표시된 변경 전체를 곧바로 “이번에 Codex가 만든 결과”라고 판단하지 않습니다.
예를 들어 제목을 바꾸기 전에 내가 footer를 고쳤다면 두 변경이 같은 파일에 나타날 수 있습니다. 원치 않는 변경을 취소할 때도 내 수정까지 함께 되돌리지 않도록 구분해야 합니다. 상태별 방법은 내 수정은 남기고 되돌리기에 정리했습니다.
5. 파일·검사·화면으로 끝내기
‘완료했습니다’라는 답을 받으면 세 가지를 확인합니다.
- 파일: 제목이 요청한 문구로 바뀌었고 기존 수정은 유지됐는가.
- 검사: 프로젝트에 있는 확인 명령이 통과했는가. 실행하지 못한 검사가 있다면 무엇인가.
- 화면: 미리보기에서 제목이 보이고 휴대폰 너비에서도 잘리지 않는가.
빌드는 프로젝트 파일을 실제 사이트로 만드는 과정입니다. 빌드 성공과 원하는 화면은 따로 확인합니다. 명령을 모른다면 “이 프로젝트에 있는 검사와 미리보기 방법을 찾아 확인하고 결과를 알려줘”라고 요청할 수 있습니다.
모바일에서 마지막 글자가 잘렸다면 그 증상을 그대로 전달합니다. 한 요청의 결과를 확인한 뒤 다음 수정으로 넘어가면 어떤 변경에서 문제가 생겼는지 찾기 쉽습니다.
검토를 마친 파일을 실제 사이트에 올리는 일은 배포입니다. minml의 발행 흐름처럼 프로젝트마다 절차가 다르므로 공개할 때 별도로 결정합니다. AI에게 맡길 범위와 직접 판단할 기준은 작업 분담 안내로 이어 볼 수 있습니다.
PC에서 진행 중인 일을 자리를 비운 뒤 확인하고 싶다면 휴대폰에서 PC 작업 이어가기로 연결을 설정할 수 있습니다.