빠른 시작

Codex 앱 다운로드 및 설치

Windows 또는 macOS용 Codex 앱을 다운로드하세요.

Codex를 열고 로그인

앱을 다운로드하고 설치한 뒤 Codex를 열고 ChatGPT 계정 또는 OpenAI API 키로 로그인하세요.

OpenAI API 키로 로그인하면 클라우드 스레드 같은 일부 기능은 사용할 수 없을 수 있습니다.

프로젝트 선택

Codex가 작업할 프로젝트 폴더를 선택하세요.

이전에 Codex 앱, CLI 또는 IDE 확장을 사용했다면 작업했던 이전 프로젝트가 표시됩니다.

첫 메시지 보내기

프로젝트를 고른 뒤 Local 이 선택되어 있는지 확인하고, Codex가 로컬 머신에서 작업하도록 한 다음 첫 메시지를 보내세요.

프로젝트나 컴퓨터 전반에 대해 무엇이든 물어볼 수 있습니다. 예시는 다음과 같습니다.

더 많은 아이디어가 필요하면 둘러보기 섹션을 확인하세요. Codex가 처음이라면 모범 사례 가이드를 읽어보세요.

Codex 확장 설치

사용 중인 에디터에 맞는 확장을 다운로드하세요.

• Visual Studio Code용 다운로드
• Cursor용 다운로드
• Windsurf용 다운로드
• Visual Studio Code Insiders용 다운로드

Codex 패널 열기

설치가 끝나면 Codex 확장이 다른 확장과 함께 사이드바에 나타납니다. 접힌 섹션 안에 숨겨져 있을 수 있으며, 원하면 에디터 오른쪽으로 이동할 수도 있습니다.

로그인하고 첫 작업 시작

ChatGPT 계정 또는 API 키로 로그인해 시작하세요.

Codex는 기본적으로 Agent 모드로 시작하며, 이 모드에서는 파일 읽기, 명령 실행, 프로젝트 디렉터리 내 변경 작성이 가능합니다.

Git 체크포인트 사용

Codex는 코드베이스를 수정할 수 있으므로, 필요할 때 쉽게 되돌릴 수 있도록 각 작업 전후에 Git 체크포인트를 만들어두는 것이 좋습니다. Codex가 처음이라면 모범 사례 가이드도 읽어보세요.

Codex CLI 설치

npm으로 설치:

npm install -g @openai/codex

Homebrew로 설치:

brew install codex

codex 실행 후 로그인

시작하려면 터미널에서 codex를 실행하세요. ChatGPT 계정 또는 API 키로 로그인하라는 안내가 표시됩니다.

현재 디렉터리에서 Codex 작업시키기

인증이 끝나면 현재 디렉터리에서 Codex가 작업하도록 요청할 수 있습니다.

Git 체크포인트 사용

Codex는 코드베이스를 수정할 수 있으므로, 필요할 때 쉽게 되돌릴 수 있도록 각 작업 전후에 Git 체크포인트를 만들어두는 것이 좋습니다. Codex가 처음이라면 모범 사례 가이드를 읽어보세요.

브라우저에서 Codex 열기

chatgpt.com/codex로 이동하세요. GitHub pull request 댓글에서 @codex를 태그해 Codex에 작업을 위임할 수도 있습니다. 이 기능은 ChatGPT 로그인이 필요합니다.

환경 설정

첫 작업을 시작하기 전에 Codex용 환경을 설정하세요. 환경 설정 페이지를 열어 GitHub 저장소를 연결하면 됩니다.

작업 실행 및 진행 상황 모니터링

환경 준비가 끝나면 Codex 인터페이스 에서 코딩 작업을 시작하세요. 로그를 보면서 실시간으로 진행 상황을 확인할 수도 있고, 백그라운드로 실행해둘 수도 있습니다.

변경 검토 및 pull request 생성

작업이 끝나면 diff 보기에서 제안된 변경 사항을 검토하세요. 결과를 다시 다듬거나 GitHub 저장소에 직접 pull request를 만들 수 있습니다.

Codex는 변경 사항의 미리보기 역시 제공합니다. 그대로 PR을 수락할 수도 있고, 아래처럼 브랜치를 로컬로 체크아웃해 테스트할 수도 있습니다.

git fetch
git checkout <branch-name>