[WSL2] OpenAI Codex CLI 설치하는 방법 (최신 버전 관리 포함)

 

WSL2에서 Codex CLI 설치 가이드

Windows 11 + WSL2 환경에서 OpenAI Codex CLI를 설치하고 최신 버전까지 관리하는 방법을 단계별로 정리했습니다.

 

설치 전 확인 사항

설치 전에 아래 조건이 충족되는지 확인하세요.

• Node.js 버전: v22 이상 (LTS 권장)
• npm (Node.js 설치 시 자동 포함)
• WSL2 (Ubuntu 등 리눅스 환경)

 

WSL2 Ubuntu 접속

PowerShell에서 WSL2 Ubuntu에 접속합니다.

wsl -d Ubuntu

 

설치 및 설정 절차

1. Node.js 설치 (필요 시)

Node.js가 없는 경우 NodeSource 저장소를 추가하고 Node.js LTS 버전을 설치합니다.

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

 

2. Codex CLI 전역 설치

아래 명령어로 Codex CLI를 전역(global)으로 설치합니다.

sudo npm install -g @openai/codex

 

3. 설치 확인

설치가 완료되면 버전을 확인합니다.

codex --version

 

4. 대화형 모드 실행

codex 

 

5. 최신 버전 확인 & 업데이트

현재 설치된 버전과 최신 버전을 비교하고 필요하면 업데이트합니다.

# 최신 버전 확인
npm view @openai/codex version

# 최신 버전으로 업데이트
sudo npm install -g @openai/codex@latest