⚙️GPT Codex CLI 설치하기
첫 번째 도구 준비
Node.js 설치부터 GPT Codex CLI 설치, 첫 실행까지 단계별로 진행합니다.
Chapter 2: GPT Codex CLI 설치하기
"악기를 연주하려면 먼저 악기를 구해야 합니다."
이번 챕터에서는 바이브 코딩의 핵심 도구인 GPT Codex CLI를 설치합니다. 여러분의 컴퓨터에 "AI 연주자"를 초대하는 과정이라고 생각하세요.
터미널이란? — 여러분의 새로운 연습실
설치를 시작하기 전에, **터미널(Terminal)**이 무엇인지 먼저 알아야 합니다.
Ableton Live를 열면 GUI(그래픽 인터페이스)가 보이죠? 버튼을 클릭하고, 트랙을 드래그하고, 노브를 돌립니다. 이것은 "그래픽 방식"입니다.
터미널은 텍스트 방식입니다. 마치 MIDI 메시지를 직접 타이핑하는 것과 같아요. Note On, Channel 1, C4, Velocity 127 — 이런 식으로 컴퓨터에게 텍스트로 명령을 내리는 공간입니다.
처음에는 낯설지만, 실은 더 정확하고 강력한 방법입니다. 프로 엔지니어들이 믹싱 콘솔의 정확한 dB 값을 직접 입력하는 것과 비슷하다고 생각하세요.
터미널 여는 방법
macOS: Cmd + Space → "Terminal" 검색 → Enter
Windows: Win + R → "cmd" 입력 → Enter (또는 Windows Terminal 설치 권장)
Linux: Ctrl + Alt + T
기본 터미널 명령어 3가지
바이브 코딩에 꼭 필요한 터미널 명령어는 딱 세 가지입니다:
pwd는 "내가 지금 어디에 있지?"를 알려줍니다. 음악으로 치면, 악보에서 현재 마디 번호를 확인하는 것과 같습니다.
ls는 "이 폴더에 뭐가 있지?"를 보여줍니다. 악보 선반에서 어떤 악보들이 있는지 확인하는 것과 같아요.
cd는 다른 폴더로 이동하는 명령어입니다. 연습실에서 다른 연습실로 옮기는 것과 같습니다.
터미널을 처음 열면 여러분의 홈 디렉토리에 있습니다. macOS에서는 /Users/여러분이름, Windows에서는 C:\Users\여러분이름 입니다. 이곳이 여러분의 "기본 연습실"입니다.
어디서든 홈으로 돌아가려면 cd ~을 입력하세요. ~(물결 표시)는 "집"을 의미합니다.
Step 1: Node.js 설치하기
GPT Codex CLI는 Node.js 위에서 작동합니다. Node.js는 JavaScript를 실행하는 환경인데, 여기서는 "Codex라는 악기를 연주하기 위한 앰프"라고 생각하세요.
일렉트릭 기타를 연주하려면 기타만으로는 안 됩니다. 앰프가 있어야 소리가 나죠. Node.js는 바로 그 앰프 역할입니다. Codex CLI(기타)를 작동시키는 기반 환경이에요.
nvm으로 Node.js 설치하기 (권장)
**nvm(Node Version Manager)**을 사용하면 Node.js 버전을 쉽게 관리할 수 있습니다. 직접 설치하는 것보다 훨씬 안전하고 유연합니다.
nvm 설치 스크립트 실행
터미널에 아래 명령어를 복사-붙여넣기하세요:
Windows에서는 nvm 대신 nvm-windows를 사용합니다. github.com/coreybutler/nvm-windows에서 설치 파일을 다운로드하세요.
터미널 재시작
nvm 설치 후, 터미널을 완전히 닫았다가 다시 열어야 합니다. 새 악기를 설치한 후 DAW를 재시작하는 것과 같은 원리입니다.
nvm으로 Node.js LTS 설치
터미널을 다시 열고, Node.js LTS(Long Term Support — 안정 버전)를 설치합니다:
설치 확인
제대로 설치되었는지 확인합니다:
버전 번호가 표시되면 성공입니다!
**npm(Node Package Manager)**은 Node.js의 "악보 가게"입니다. 전 세계 개발자들이 만든 도구(패키지)를 검색하고 설치할 수 있는 거대한 저장소예요. Codex CLI, Claude Code, Gemini CLI 모두 npm을 통해 설치합니다.
Step 2: GPT Codex CLI 설치
Node.js가 준비되었으니, 이제 진짜 주인공인 Codex CLI를 설치할 차례입니다.
Codex CLI 설치
여기서 -g는 **global(전역)**의 약자입니다. 이 옵션을 붙이면 컴퓨터 어디서든 codex 명령어를 사용할 수 있습니다. 마치 Ableton을 시스템 전체에 설치하는 것과 같아요.
설치 확인
버전 번호가 나타나면 설치 성공!
ChatGPT 계정 로그인
처음 Codex를 실행하면 ChatGPT 계정으로 로그인해야 합니다.
브라우저가 자동으로 열리고, ChatGPT 계정으로 로그인하면 됩니다. Pro Plan 구독이 활성화된 계정으로 로그인하세요.
Codex CLI는 ChatGPT Pro Plan 이상에서만 작동합니다. Free나 Plus Plan으로는 사용할 수 없으니 주의하세요. 구독은 chat.openai.com에서 관리할 수 있습니다.
인터페이스 확인
로그인 후 Codex 인터페이스가 표시됩니다:
> 프롬프트가 나타나면 성공입니다! 여기에 자연어로 명령을 입력하면 됩니다.
(비교) Claude Code 설치
Claude Code도 같은 방식으로 설치할 수 있습니다. 나중에 필요할 때를 대비해 알아두세요.
Claude Code 설치
첫 실행 및 인증
Claude Max Plan 구독이 필요합니다. 브라우저에서 Anthropic 계정으로 로그인합니다.
(비교) Gemini CLI 설치
Gemini CLI는 Google 계정만 있으면 무료로 사용할 수 있다는 큰 장점이 있습니다.
Gemini CLI 설치
첫 실행 및 인증
Google 계정으로 로그인하면 바로 사용할 수 있습니다. 별도 유료 구독이 필요 없습니다.
설치 비교 총정리
세 CLI 도구를 바이올린 명기에 비유해 보겠습니다. 작곡을 공부하는 여러분이라면 이 이름들이 더 와닿을 거예요.
Claude Code = 스트라디바리우스(Stradivarius) 풍부하고 균형 잡힌 톤, 압도적인 완성도. 300년이 지나도 최고로 꼽히는 악기처럼, Claude Code는 코드 이해력과 맥락 파악 능력에서 가장 깊은 울림을 줍니다. 복잡한 오케스트라 총보를 다룰 때 — 즉, 대규모 프로젝트를 분석하고 리팩터링할 때 진가를 발휘합니다.
ChatGPT Codex = 과르네리 델 제수(Guarneri del Gesù) 스트라디바리우스와 쌍벽을 이루는 명기. 거칠지만 강렬하고, 독특한 개성이 있습니다. 파가니니가 과르네리를 선택했듯, Codex CLI는 빠른 프로토타이핑과 실험적인 코딩에서 특유의 추진력을 보여줍니다. 솔리스트처럼 혼자 무대를 장악하는 스타일이에요.
Gemini CLI = 니콜라 아마티(Nicola Amati) 또는 과다니니(Guadagnini) 아마티는 스트라디바리와 과르네리의 스승이 사용한 악기 가문이고, 과다니니는 뛰어난 음색을 합리적인 가격에 제공하는 명기입니다. Gemini CLI도 마찬가지로, 무료라는 놀라운 접근성과 함께 충분히 좋은 성능을 제공합니다. 학생이 처음 진지한 악기를 구할 때, 가장 현실적이면서도 품격 있는 선택지와 같습니다.
결국 프로 연주자들은 곡과 홀에 따라 악기를 바꿔 연주합니다. 여러분도 프로젝트와 상황에 따라 세 도구를 자유롭게 오가게 될 거예요.
첫 번째 테스트: "Hello World"
설치가 끝났으니, 간단한 테스트를 해봅시다. 프로그래밍 세계의 전통인 "Hello World"를 바이브 코딩으로 만들어 보겠습니다.
프로젝트 폴더 만들기
먼저 작업할 폴더를 만듭니다:
mkdir은 "Make Directory"의 줄임말로, 새 폴더를 만드는 명령어입니다. ~은 홈 디렉토리를 의미합니다.
Codex 실행
첫 번째 명령 내리기
프롬프트에 다음을 입력합니다:
> "Hello, Vibe Coding!"이라고 출력하는 HTML 파일을 만들어줘. 배경은 검은색, 글자는 흰색, 화면 중앙에 크게 보여줘.AI가 코드를 생성하고, 파일을 만들겠냐고 물어봅니다. 승인하면 index.html 파일이 생성됩니다.
결과 확인
파일 탐색기에서 index.html을 더블클릭하거나, 터미널에서 열 수 있습니다:
Windows에서는 open 대신 start index.html을 사용합니다. Linux에서는 xdg-open index.html입니다.
축하합니다! 여러분은 방금 코드를 한 줄도 직접 작성하지 않고 첫 번째 웹 페이지를 만들었습니다!
방금 한 일은 마치 처음으로 DAW를 열고, 가상악기 프리셋을 불러와서, 건반 하나를 눌러 소리를 들어본 것과 같습니다. 아직 곡을 쓴 건 아니지만, 도구가 작동한다는 확신을 얻었습니다. 이 확신이 중요합니다.
자주 묻는 질문 (FAQ)
macOS/Linux에서 EACCES 에러가 나면, nvm으로 Node.js를 설치했는지 확인하세요. nvm을 사용하면 이 문제가 발생하지 않습니다. 절대 sudo npm install -g를 사용하지 마세요 — 이는 보안 위험을 초래합니다.
ChatGPT Pro Plan이 활성화되어 있는지 chat.openai.com/settings에서 확인하세요. 무료 플랜이나 Plus 플랜으로는 Codex CLI를 사용할 수 없습니다.
네! 세 도구 모두 동시에 설치할 수 있습니다. 서로 충돌하지 않습니다. 마치 Ableton과 Logic Pro를 같은 컴퓨터에 설치할 수 있는 것과 같습니다. 각각 독립적으로 작동합니다.
다음 챕터 미리보기
도구 설치를 마쳤으니, 다음 챕터에서는 AI에게 프로젝트의 맥락을 알려주는 방법을 배웁니다. AGENTS.md라는 파일을 작성해서 AI에게 "이 프로젝트는 이런 프로젝트이고, 이런 규칙을 따라야 해"라고 알려주는 것이죠.
AGENTS.md는 오케스트라의 **총보(full score)**와 같습니다. 지휘자(여러분)가 연주자(AI)에게 곡의 전체 구조와 규칙을 알려주는 문서예요. 기대해주세요!