팁Codex CLI 설치, Windows에서 5분 안에 끝내기

2026-05-02

Codex CLI 설치, 먼저 어디서 돌릴지 정하기

Codex CLI 설치를 찾는 사람은 보통 명령어 한 줄만 궁금합니다. 2026년 5월 2일 기준 공식 문서대로 가면 설치 자체는 `npm i -g @openai/codex`로 끝나요. 대신 실제로 시간이 새는 자리는 설치 직후입니다. Windows PowerShell로 바로 갈지, WSL2로 들어갈지, 로그인은 ChatGPT로 할지 API key로 할지 여기서 한 번 갈립니다.

제 쪽에선 개인 PC면 PowerShell 네이티브가 제일 빨랐고, 회사 노트북이거나 Linux 툴을 많이 쓰는 사람은 WSL2가 덜 꼬이더라구요. Codex CLI 설치를 짧게 끝내고 싶으면 아래 순서가 편합니다.

Step 1: PowerShell로 갈지 WSL2로 갈지 먼저 고르기

OpenAI 문서는 Windows 네이티브를 기본으로 권합니다. Windows 11이 가장 안정적이고, 최근 업데이트된 Windows 10은 best effort 수준입니다. Linux 도구 체인이 이미 WSL에 있으면 처음부터 WSL2로 가는 편이 속 편합니다.

Step 2: Codex CLI 설치는 npm 한 줄이면 끝

공식 Quickstart 기준으로 가장 쉬운 길은 npm 전역 설치입니다. 이미 Node와 npm을 쓰는 PC라면 이 경로가 제일 덜 번거롭습니다. npm을 안 쓰는 사람은 GitHub Release 바이너리로 바로 받는 길도 있구요.

Step 3: 첫 실행에서 로그인 방식 고르기

이제 `codex`만 실행하면 됩니다. 개인이 바로 써볼 땐 ChatGPT 로그인이 편합니다. Plus, Pro, Business, Enterprise/Edu는 Codex가 포함되고, 2026년 5월 2일 기준 Free와 Go도 한시 포함 상태입니다. 반대로 CI/CD처럼 자동 실행이 목적이면 API key가 맞습니다. 그쪽은 구독이 아니라 API 사용량으로 요금이 붙습니다.

Step 4: 첫 질문은 가볍게 던지기

Codex CLI 설치가 끝났는지 확인할 땐 복잡한 기능 구현보다 폴더 요약이 낫습니다. 현재 폴더를 읽고 첫 파일을 추천하게 하면 권한, 파일 읽기, 응답 흐름이 한 번에 보입니다. 여기서 바로 큰 작업을 던지면 설치 문제인지 작업 문제인지 섞여서 헷갈립니다.

Step 5: Windows에서 제일 자주 막히는 건 읽기 권한

Windows에서 많이 걸리는 건 설치 실패보다 샌드박스 읽기 권한입니다. 다른 드라이브 자료를 읽게 했는데 막히면 그 경로를 세션에 추가하면 됩니다. 공식 문서도 Windows 네이티브를 기본으로 두되, 안 맞으면 `unelevated`나 WSL2로 넘기라고 적어놨습니다.

Step 6: 설치 끝났으면 바로 최신 버전으로 맞추기

Codex CLI 설치 뒤 한동안 안 건드리면 버전 차이에서 막히는 일이 꽤 생깁니다. 새 환경에서는 시작 전에 한 번 올려두는 편이 낫더라구요.

Codex CLI 설치는 명령어보다 실행 자리 고르기가 더 큽니다. 개인 PC라면 PowerShell, Linux 작업이 많으면 WSL2, 자동 배치는 API key 이 셋만 구분하면 처음부터 덜 헤맵니다.