윈도우 11 에 WSL 을 사용하는 Codex CLI 설치 방법

윈도우 11에 WSL을 사용하는 Codex CLI를 설치하는 방법은 아래와 같다.

설치 방법

아래의 명령어를 명령 프롬프트(CMD)에 입력하여 WSL을 설치한다.

wsl --install

WSL 설치가 완료된 화면

아래의 명령어를 입력하여 WSL이 잘 동작하는지 확인한다.

wsl
exit

WSL 동작 확인 화면

아래의 명령어를 입력하여 설치 스크립트를 다운로드하고 실행한다.

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

설치 스크립트가 다운로드되었고 실행된 화면

아래의 명령어를 입력하여 노드를 설치한다.

wsl
nvm install 22

NVM 설치 화면

아래의 명령어를 입력하여 OpenAI의 Codex 패키지를 설치한다.

npm i -g @openai/codex

Codex가 설치된 화면

아래의 명령어를 입력하여 CODEX를 실행한다.

codex

Codex가 실행된 화면

아래의 사진처럼 ChatGPT 계정으로 로그인한다.

로그인 화면

선택화면

Codex가 정상적으로 실행되면 아래와 같은 화면이 나타난다.

실행된 화면

아래의 명령어를 입력하면 Codex 상태를 확인할 수 있다.

/status

Codex 상태가 나타난 화면

오류

아래와 같이 오류 메시지가 발생할 수 있다.

Linux용 Windows 하위 시스템 설치된 배포가 없습니다.
아래 지침에 따라 배포를 설치하여 이 resolve 수 있습니다.

사용 가능한 배포를 나열하려면 'wsl.exe --list --online' 사용
설치하려면 'wsl.exe --install <Distro>'를 선택하세요.

오류가 발생한 화면

이 경우에는 아래의 명령어를 입력하여 WSL이 쓸 적절한 이미지를 탐색한다.

wsl --list --online

설치가능한 이미지 목록이 나타난 화면

아래와 같이 명령어를 입력하여 이미지를 설치한다. 필자는 우분투 24.04를 설치했다.

wsl --install Ubuntu-24.04

이미지가 설치된 화면

이걸로 해결되지 않는다면 아래의 사진처럼 Hyper-V를 선택하여 윈도우 기능을 설치한다.

윈도우에서 사용할 기능을 선택한 화면

윈도우 기능이 설치된 화면