[codex] Ubuntu에서 Codex CLI 설치하기 (Node 버전 오류 + 권한 문제 해결)

Ubuntu 환경에서 @openai/codex CLI를 설치하는 과정에서
Node 버전 문제와 권한 오류를 동시에 겪을 수 있다.

이 글은 실제 설치 과정을 기반으로,
가장 안전하고 깔끔한 해결 방법을 정리한 것이다.

---

1. 문제 상황

Codex CLI 설치 시 다음과 같은 에러가 발생했다.

npm WARN EBADENGINE Unsupported engine {
npm WARN EBADENGINE   package: '@openai/codex@0.101.0',
npm WARN EBADENGINE   required: { node: '>=16' },
npm WARN EBADENGINE   current: { node: 'v12.22.9', npm: '8.5.1' }
npm WARN EBADENGINE }

npm ERR! code EACCES
npm ERR! syscall mkdir
npm ERR! path /usr/local/lib/node_modules
npm ERR! errno -13
npm ERR! Error: EACCES: permission denied, mkdir '/usr/local/lib/node_modules'

---

원인 분석

1️⃣ Node 버전이 너무 낮음

• 현재 Node: v12.22.9
• 요구 조건: >=16

Codex CLI는 최소 Node 16 이상이 필요하다.

---

2️⃣ 글로벌 npm 권한 문제

EACCES: permission denied, mkdir '/usr/local/lib/node_modules'

글로벌 설치 경로는 root 권한이 필요하다.
sudo 없이 설치하려다 실패한 것이다.

---

2. 해결 방법 (권장: nvm 사용)

Step 1. nvm 설치

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

설치 후 적용:

source ~/.bashrc

설치 확인:

nvm --version

예시 출력:

0.39.7

---

Step 2. Node LTS 설치

nvm install --lts

기본 버전으로 설정:

nvm use --lts
nvm alias default lts/*

설치 확인:

node -v

예시 출력:

v24.13.1

---

Step 3. Codex CLI 설치

이제 sudo 없이 설치 가능하다.

npm i -g @openai/codex

설치 확인:

codex --version

---

3. sudo로 설치하면 안 되는 이유

아래 방식은 권장하지 않는다.

sudo npm i -g @openai/codex

이 방식은:

• 시스템 Node 환경 오염
• 다른 개발 툴과 충돌 가능
• 장기적으로 관리 어려움

---

4. nvm을 사용하는 이유

• 프로젝트별 Node 버전 관리 가능
• sudo 필요 없음
• 시스템 Node와 완전 분리
• 환경 충돌 최소화
• 장기 유지보수에 유리

---

5. 정리

문제

• Node 버전 낮음
• 글로벌 npm 권한 문제

해결

• nvm 설치
• 최신 LTS Node 설치
• sudo 없이 Codex CLI 설치