설치와 설정 — 5분 만에 준비 끝내기

이번 레슨에서는 코덱스를 내 컴퓨터에 설치하고 로그인까지 마칩니다. 요리를 시작하기 전에 주방 도구를 갖추는 단계라고 생각하시면 됩니다. 준비물은 딱 두 가지, Node.js(버전 18 이상)와 ChatGPT 계정(Plus 이상 권장)입니다.

1단계: CLI 설치

터미널(맥은 Terminal, 윈도우는 PowerShell이나 WSL)을 열고 아래 명령어를 입력합니다. npm은 Node.js를 설치하면 함께 딸려오는 패키지 관리자입니다.

코덱스 CLI 설치

# npm으로 전역 설치
npm install -g @openai/codex

# 맥에서 Homebrew를 쓴다면 이렇게도 가능합니다
brew install --cask codex

# 설치 확인 — 버전이 출력되면 성공
codex --version

2단계: 로그인

프로젝트 폴더로 이동한 뒤 codex를 실행하면, 처음 한 번 로그인 안내가 나옵니다. "Sign in with ChatGPT"를 선택하면 브라우저가 열리고, 평소 쓰던 ChatGPT 계정으로 로그인하면 끝입니다. 별도의 API 키를 발급받지 않아도 됩니다.

첫 실행과 로그인

# 내 프로젝트 폴더로 이동
cd my-project

# 코덱스 실행 — 처음이면 로그인 화면이 나옵니다
codex

ChatGPT Plus/Pro/Team 요금제라면 코덱스 사용량이 요금제에 포함되어 있습니다. 즉 이미 ChatGPT를 구독 중이라면 추가 비용 없이 시작할 수 있어요.

3단계: IDE 확장과 클라우드 확인

• IDE 확장: VS Code나 Cursor의 확장 마켓플레이스에서 "Codex"를 검색해 OpenAI가 만든 확장을 설치합니다. CLI와 같은 계정, 같은 설정을 공유합니다.
• 클라우드: 브라우저에서 chatgpt.com/codex 에 접속하면 클라우드 작업 화면이 보입니다. GitHub 저장소 연결은 5강에서 자세히 다룹니다.
• 설정 파일: 코덱스의 전역 설정은 홈 폴더의 ~/.codex/config.toml 에 저장됩니다. 지금은 몰라도 괜찮고, 나중에 커스터마이징할 때 찾아오면 됩니다.

회사 컴퓨터라면 npm 전역 설치나 브라우저 로그인이 보안 정책에 막힐 수 있습니다. 이럴 땐 IT 담당자에게 문의하거나, 개인 프로젝트에서 먼저 연습해 보세요.

여기까지 하면 준비 완료입니다. 터미널에 codex라고 치면 대화형 화면이 열리고, 이제 무엇이든 시킬 수 있습니다. 다음 레슨에서 첫 작업을 시켜 보겠습니다.