OpenAI Codex 앱 사용법｜기존 프로젝트 수정·테스트·배포 확인 순서

AI·개발자 도구 · 기존 프로젝트 실전 가이드

OpenAI Codex 앱 사용법은 작업 위치를 정하고, 한 가지 변경을 요청한 다음, diff·테스트·실제 화면·운영 응답을 따로 확인하는 순서로 익히면 됩니다. 2026년 9월 10일 OpenAI 공식 문서를 다시 확인하고, 2026년 8월 7일 Sinabro Digital의 WordPress /topics/ 개편 기록에 이 순서를 대입했어요.

Codex를 처음 열면 기능 목록보다 “무엇을 맡겨야 기존 프로젝트가 안전하게 바뀌는가”가 먼저 궁금해져요. “이 페이지를 좋게 고쳐줘”처럼 결과 기준이 빠진 요청은 동작하는 변경을 만들더라도 파일·URL·운영 설정까지 보존했는지 판단하기 어렵습니다. 첫 작업은 작고 결과가 눈에 보이는 수정으로 시작하는 편이 좋아요.

OpenAI Codex 앱 사용법: 프로젝트를 열고 첫 작업을 정하세요

현재 OpenAI 데스크톱 앱 문서는 앱을 설치하고 로그인한 뒤 작업할 위치를 고르고, Codex에서 New chat을 시작해 원하는 결과와 필요한 맥락을 적는 흐름을 안내해요. CLI는 프로젝트 디렉터리에서 codex를 실행해 코드를 검사하고 수정하고 명령을 실행하는 방식으로 설명됩니다. 두 경로 모두 첫 요청의 대상과 완료 기준을 좁혀 적는 편이 검토하기 쉬워요.

1. 작업할 저장소 또는 폴더를 열고 예상한 프로젝트인지 확인해요.
2. Codex 새 대화에 바꾸려는 결과와 관련 파일을 적어요.
3. 읽기·계획·변경의 순서를 나눠 요청하고 생성된 diff를 먼저 봐요.
4. 관련 테스트와 실제 화면을 확인한 뒤 운영 반영 여부를 판단해요.

앱과 CLI의 버전, 모델, 사용량과 기능 제공 범위는 계정·운영체제·설정에 따라 달라질 수 있어요. 아래 표의 버전은 현재 버전이라고 주장하는 값이 아니라 이 사례를 직접 확인한 날짜의 기록입니다.

기존 프로젝트 요청문은 네 가지로 쪼개세요

작업을 맡기기 전에 결과를 판단할 문장을 먼저 적어요. 목표와 맥락만 있으면 Codex가 범위를 넓혀 해석할 수 있고, 제약과 완료 조건만 있으면 바꿀 대상이 분명하지 않을 수 있습니다.

1. 목표: 무엇이 달라져야 하는지 한 문장으로 적어요.
2. 맥락: 관련 파일, 현재 동작, 이미 확인한 증거만 전달해요.
3. 제약: 유지할 URL·API·데이터·권한과 수정 금지 범위를 적어요.
4. 완료 조건: 테스트, 화면 크기, 링크 수와 운영 응답처럼 다시 확인할 값을 적어요.

실제 작업을 공개 가능한 형태로 줄이면 다음과 같아요. 이 예시는 당시 요구를 요약한 것이며 새로운 성과나 수치를 만든 것이 아닙니다.

• 목표: /topics/를 긴 표에서 주제 카드형 허브로 바꾼다.
• 맥락: WordPress 자식 테마와 페이지 생성 코드, 공개 글 목록과 기존 테스트가 있다.
• 제약: 기존 글 URL·공개 상태·광고 조건은 유지하고 인증정보와 비밀값은 출력하지 않는다.
• 완료 조건: 데스크톱 2열·모바일 1열, 공개 글 링크 보존, 테스트 통과, 실제 HTTP·canonical·사이트맵 확인.

여러 작업에서 반복할 테스트 명령과 수정 금지 범위는 프로젝트의 AGENTS.md에 둘 수 있어요. OpenAI 공식 문서에 따르면 Codex는 작업 전에 지침 파일을 읽고, 전역 지침과 프로젝트 루트에서 현재 폴더까지의 파일을 계층적으로 결합합니다. 더 가까운 폴더의 지침이 뒤에 적용되므로 저장소별 규칙을 분리해 둘 수 있어요. 실제 작성 항목은 Codex AGENTS.md 작성법에서 이어서 확인할 수 있습니다.

기존 프로젝트 수정은 이 5단계로 진행하세요

Codex에게 코드를 바로 고치게 하기보다 현재 상태를 조사하고, 검토 가능한 단위로 나눠 진행했어요.

1. 현재 상태 읽기: 테마 구조, 페이지 생성 코드, 관련 테스트와 공개 글 목록을 확인해요.
2. 범위 고정하기: 보존할 URL·메타·광고 조건과 변경할 화면을 기록해요.
3. 계획과 diff 보기: 예상 파일과 변경 이유를 읽고, 범위를 벗어난 diff는 멈춰서 확인해요.
4. 자동·실제 검증: 관련 테스트를 실행하고 데스크톱·모바일에서 화면과 링크를 봐요.
5. 운영 응답 확인: 공개 반영 뒤 HTTP 상태, canonical, 검색 허용, 사이트맵과 RSS를 다시 확인해요.

주제 허브 작업은 공개 글 97개와 카테고리 구조를 읽는 것으로 시작했어요. URL·SEO 메타·광고 조건을 고정한 뒤 데스크톱과 모바일 와이어프레임을 정하고, 로컬에서 테마와 페이지 생성 코드를 확인했습니다. 프로젝트에 반복 규칙을 두고 싶다면 Codex Skill 설치 방법에서 전역과 프로젝트 범위를 나누는 기준도 이어서 볼 수 있어요.

완료 여부는 설명보다 네 가지 증거로 확인하세요

테스트 하나가 통과했다는 사실만으로 배포가 끝나지는 않아요. 코드 구조, 자동 테스트, 실제 화면, 운영 응답을 나눠 확인해야 변경이 원래 기능을 보존했는지 판단할 수 있습니다.

변경 후 데스크톱 1280px

원본 크기로 보기

변경 후 모바일 390px

원본 크기로 보기

테스트와 권한은 별도로 점검하세요

이번 사례에서는 호스트 PHP CLI를 사용할 수 없어 WordPress Playground의 PHP 8.3 파싱과 실제 페이지 응답으로 검증을 대체했어요. 설정 저장 성공과 렌더링된 화면이 항상 동시에 바뀌지는 않으므로, 배포 뒤 브라우저에서 다시 보는 단계가 필요합니다.

현재 공식 Codex 문서는 샌드박스와 승인 정책을 별도 제어로 설명해요. 샌드박스는 명령이 파일과 네트워크에 접근할 수 있는 기술적 경계를 정하고, 승인은 그 경계를 넘어설 때 멈춰 확인할 시점을 정합니다. 기본 네트워크 접근은 꺼져 있으며, 테스트 러너·패키지 관리자·git 같은 하위 명령도 같은 샌드박스 경계를 물려받아요. 계정 이메일, API 키, 앱 비밀번호, 인증 헤더와 미공개 대화를 프롬프트와 로그에 넣지 마세요.

• 삭제·데이터 변경·공개 배포는 별도의 완료 조건으로 구분해요.
• 예상하지 못한 파일이 바뀌면 diff를 저장하기 전에 이유를 확인해요.
• 테스트 성공 뒤에도 화면·HTTP·검색 메타·사이트맵과 RSS를 확인해요.
• 운영 반영 전 백업 위치와 되돌리는 방법을 기록해요.

첫 작업 체크리스트

요청 전

• 문제를 한 문장으로 적기
• 관련 파일과 현재 증거 고르기
• 유지할 URL·데이터·권한 정하기
• 테스트와 화면 기준을 완료 조건으로 적기

작업 중

• 계획과 예상 파일 읽기
• 변경 diff와 실행 명령 기록하기
• 범위를 벗어난 제안은 이유 확인하기
• 자동 테스트와 실제 화면을 나눠 보기

완료 전

• 데스크톱·모바일 레이아웃과 이미지 확인하기
• HTTP 200·canonical·index,follow 확인하기
• 내부 링크·외부 출처·사이트맵·RSS 확인하기
• 민감정보와 복구 방법 다시 확인하기

공식 출처와 확인 범위

제품 기능과 메뉴는 업데이트될 수 있어요. 아래 OpenAI 공식 문서를 2026년 9월 10일에 확인했으며, 표의 앱·CLI 버전은 2026년 8월 7일 직접 작업한 당시 환경으로 따로 표시했습니다. 공식 문서의 현재 안내와 이 프로젝트에서 직접 확인한 사례 수치를 섞지 않았어요.

• ChatGPT 데스크톱 앱: 프로젝트·폴더를 선택하고 Codex에서 작업을 시작하는 현재 흐름
• Codex CLI: 프로젝트 디렉터리에서 코드 검사·수정·명령 실행과 검토를 이어가는 방법
• AGENTS.md: 작업 전 프로젝트 지침을 읽고 범위별 규칙을 적용하는 방법
• Sandboxing: 로컬 작업의 접근 경계를 정하는 방식
• Agent approvals & security: 샌드박스와 승인 설정의 역할
• ChatGPT 플랜에서 Codex 사용하기: 클라이언트·계정·데이터 제어 관련 안내

자주 묻는 질문

코딩을 잘 몰라도 Codex 앱을 쓸 수 있나요?

문서 수정, 테스트 실행, 오류 재현처럼 결과를 직접 비교할 수 있는 작업부터 시작할 수 있어요. 변경 diff와 테스트 결과를 읽을 수 없다면 운영 배포까지 한 번에 맡기지 말고 범위를 줄이세요.

AGENTS.md는 꼭 필요한가요?

작은 일회성 작업에는 필수가 아니에요. 여러 작업에서 같은 테스트 명령·수정 금지 범위·완료 기준을 반복한다면 프로젝트 지침 파일에 남겨 누락을 줄일 수 있습니다.

테스트가 모두 통과하면 바로 공개해도 되나요?

테스트는 작성된 조건만 확인해요. 화면, 이미지, HTTP 상태, canonical, 검색 허용, 사이트맵과 외부 서비스 반영은 실제 환경에서 별도로 확인한 뒤 공개하세요.