Codex 설치
Codex는 한 번 설치하는 도구라기보다 작업 폴더, 로그인 방식, 프로젝트 지시문, 검증 습관을 함께 세팅해야 실무에 붙는다.
Codex 설치의 핵심은 프로그램을 까는 일이 아니라 작업 환경을 분리하는 일이다.
Codex는 프로젝트 폴더를 읽고, 파일을 고치고, 명령을 실행할 수 있다. 그래서 처음 세팅할 때는 “어떻게 설치하나”보다 “어떤 폴더에서 어떤 권한으로 쓰나”를 먼저 정해야 한다.
이 글은 세부 설치 명령을 외우게 하려는 글이 아니다. 명령은 공식 문서에서 바뀔 수 있다. 대신 영화 제작 작업에 붙일 때 필요한 설치 전후 기준을 정리한다.
1. 사용할 표면을 정한다
Codex는 터미널 중심의 CLI, IDE 확장, 앱, 클라우드 같은 여러 표면으로 쓸 수 있다.
처음에는 CLI가 좋다. 작업 폴더 안에서 바로 대화하고, 어떤 파일을 읽고 고치는지 확인하기 쉽기 때문이다.
영화 제작 블로그 작업에서는 이렇게 쓴다.
- 블로그 저장소 폴더에서 Codex를 연다.
- 오늘 할 목표를 짧게 말한다.
- 수정한 파일과 검증 결과를 확인한다.
- 다음 작업을 인수인계 문서에 남긴다.
2. 로그인 방식을 정한다
Codex는 ChatGPT 로그인이나 API 키 방식으로 사용할 수 있다. 일반적인 로컬 작업은 ChatGPT 로그인 흐름이 기본이고, 자동화나 CI 같은 프로그램형 작업은 API 키가 더 적합할 수 있다.
중요한 것은 키와 로그인 정보를 다른 작업장으로 복사하지 않는 것이다. 작업 폴더와 인증 흐름은 분리해 두는 편이 안전하다.
3. 프로젝트 폴더를 먼저 만든다
Codex에게 모든 파일을 보여줄 필요는 없다. 작업하려는 프로젝트 폴더를 먼저 만들고, 그 폴더 안에서 시작한다.
예를 들어 블로그라면 다음처럼 분리한다.
blog/
jinong/
CONTENT-STYLE.md
DESIGN.md
src/
이렇게 하면 Codex가 봐야 할 파일과 보지 않아도 될 파일이 분명해진다.
4. AGENTS.md 또는 인수인계 문서를 둔다
Codex는 프로젝트 지시문을 읽고 작업 방식을 맞춘다. 그래서 매번 같은 설명을 반복하지 않으려면 프로젝트 안에 작업 규칙을 남겨야 한다.
블로그 작업이라면 최소한 다음을 적는다.
- 이 블로그가 다루는 주제
- 공개하지 않을 정보
- 글쓰기 규칙
- 디자인 기준
- 배포 방법
- 검증 방법
이 문서가 있으면 Codex는 단순히 파일을 고치는 도구가 아니라, 같은 기준을 유지하는 작업 파트너가 된다.
5. 설치 직후 바로 큰 작업을 맡기지 않는다
처음에는 작은 일부터 맡기는 편이 좋다.
- 현재 폴더 구조 설명해줘
- 글 하나의 맞춤법과 구조를 봐줘
- 이 프로젝트에서 실행할 수 있는 명령을 찾아줘
- 공개하면 안 되는 파일이 있는지 확인해줘
작은 작업에서 결과를 보고, 이후 구조 변경이나 콘텐츠 생성처럼 큰 작업을 맡긴다.
공식 문서는 따로 확인한다
설치 명령, 지원 표면, 로그인 옵션은 바뀔 수 있다. 실제 설치 전에는 OpenAI의 Codex 공식 문서에서 최신 Quickstart와 Authentication 안내를 확인한다.
이 블로그에서는 명령을 외우는 것보다 설치 후 작업 습관을 더 중요하게 본다. Codex는 설치한 순간보다 프로젝트 규칙을 배우기 시작한 순간부터 쓸 만해진다.
실무 적용 포인트
- 실제 작업에서 도움이 되는 순간
- AI에게 실제 프로젝트 폴더를 맡기기 전에 기본 작업 환경을 만들 때
- 쓰면 좋은 사람
- 터미널 사용이 낯설지만 영화 제작, 글쓰기, 자동화 프로젝트를 Codex와 함께 관리하고 싶은 사람
- 쓰면 안 되는 상황
- 공용 PC, 공개 서버, 타인의 계정이 섞인 환경처럼 코드와 파일 접근 권한을 분리하기 어려운 경우
- 현재 한계
- Codex 설치 명령과 지원 표면은 바뀔 수 있으므로 정확한 설치 명령은 공식 문서를 함께 확인해야 한다
- 다음 개선 방향
- 설치 후 프로젝트 폴더를 만들고 AGENTS.md 또는 인수인계 문서로 작업 규칙을 남긴다