Codex 빠른 시작

Codex는 로컬 프로젝트나 GitHub 저장소를 읽고, 코드를 수정하고, 필요한 명령을 실행하면서 개발 작업을 도와주는 코딩 에이전트입니다. 처음 사용할 때는 작업 방식에 맞는 실행 환경을 먼저 고르는 것이 좋습니다.

설치와 표면별 첫 실행 절차는 각 문서에서 다룹니다.

원하는 작업 방식	시작 문서
별도 데스크톱 앱에서 프로젝트, diff, Git 작업, 자동화를 함께 다루기	Codex 앱 시작하기
VS Code, Cursor, Windsurf, JetBrains IDE 안에서 현재 파일과 선택 영역을 컨텍스트로 사용하기	IDE 확장 설정
터미널에서 현재 디렉터리를 기준으로 Codex를 실행하고 셸 워크플로와 결합하기	CLI 설정
브라우저에서 GitHub 저장소를 연결하고 백그라운드 작업이나 pull request 흐름으로 사용하기	Codex 웹 설정

처음에는 IDE 확장이나 Codex 앱으로 시작하는 편이 쉽습니다. 터미널 작업에 익숙하다면 CLI도 좋은 선택입니다.

시작하기 전에

Codex를 사용하려면 ChatGPT 계정이나 OpenAI API 키로 로그인해야 합니다. 계정 유형이나 플랜에 따라 사용할 수 있는 기능, 사용량, 클라우드 작업 가능 여부가 달라질 수 있습니다.

또한 Codex는 프로젝트 파일을 읽고 수정할 수 있습니다. 처음에는 실험용 저장소나 Git으로 관리되는 프로젝트에서 사용하는 것이 좋습니다. 작업 전후로 커밋을 만들어 두면 결과가 마음에 들지 않을 때 되돌리기 쉽습니다.

Codex를 설치하거나 연결한 뒤에는 바로 큰 작업을 맡기기보다 현재 컨텍스트가 맞는지 먼저 확인하는 편이 안전합니다.

처음부터 큰 기능을 맡기기보다 프로젝트를 이해하는 요청으로 시작하는 것이 좋습니다. Codex가 어떤 파일을 읽고 어떤 방식으로 답하는지 확인할 수 있기 때문입니다.

이 프로젝트의 구조를 간단히 설명해 줘.
주요 디렉터리의 역할과 애플리케이션이 실행되는 흐름을 중심으로 정리해 줘.
아직 코드는 수정하지 마.

작은 기능을 맡길 때는 목표와 제약을 함께 적는 것이 좋습니다.

이 프로젝트에 간단한 검색 필터 기능을 추가해 줘.

조건:
- 기존 UI 스타일을 유지해 줘.
- 새 의존성은 추가하지 마.
- 관련 테스트가 있으면 함께 업데이트해 줘.
- 작업 후 변경한 파일과 확인한 명령을 요약해 줘.

버그 수정을 맡길 때는 재현과 검증을 명시하는 것이 좋습니다.

현재 실패하는 테스트를 재현하고 원인을 찾아 고쳐 줘.

진행 방식:
1. 먼저 테스트를 실행해 실패를 확인해 줘.
2. 실패 원인을 관련 파일과 함께 설명해 줘.
3. 최소한의 변경으로 수정해 줘.
4. 같은 테스트를 다시 실행해 통과 여부를 확인해 줘.

Codex가 만든 결과는 항상 검토해야 합니다. 특히 파일 삭제, 데이터베이스 마이그레이션, 배포 설정, 인증과 권한, 외부 API 호출처럼 영향 범위가 큰 작업은 더 신중하게 확인해야 합니다.

실무적으로는 다음 순서가 안정적입니다.