WSL

WSL2를 사용하면 Codex는 기본 Windows 샌드박스 대신 Linux 환경에서 실행됩니다. Linux용 개발 도구가 필요하거나, 이미 WSL2에서 리포지터리를 관리하고 개발 작업을 진행하거나, 사용 가능한 Windows 샌드박스 구현이 요구 사항을 충족하지 못하는 경우 WSL2를 선택하세요.

Codex는 0.114 버전까지 WSL1을 지원했습니다. Codex 0.115부터 Linux 샌드박스가 bubblewrap을 사용하도록 변경되어 WSL1은 더 이상 지원되지 않습니다.

WSL에서 VS Code 실행하기

단계별 안내는 VS Code 공식 WSL 튜토리얼을 참고하세요.

사전 요구 사항

• WSL이 설치된 Windows가 필요합니다. WSL을 설치하려면 PowerShell을 관리자 권한으로 열고 wsl --install을 실행하세요. Linux 배포판으로는 Ubuntu를 많이 사용합니다.
• VS Code에 WSL 확장 프로그램이 설치되어 있어야 합니다.

WSL 터미널에서 VS Code 열기

# From your WSL shell
cd ~/code/your-project
code .

이 명령어를 실행하면 WSL에 원격으로 연결된 창이 열리고 필요한 경우 VS Code Server가 설치됩니다. 이 창의 통합 터미널은 Linux에서 실행됩니다.

WSL 연결 확인하기

• 녹색 상태 표시줄에 WSL: <distro>가 표시되는지 확인하세요.

• 통합 터미널에는 /home/...와 같은 Linux 경로가 표시되어야 합니다. C:\로 시작하는 경로는 Windows 경로입니다.

• 다음 명령어로도 연결을 확인할 수 있습니다.

  echo $WSL_DISTRO_NAME

  이 명령어는 사용 중인 배포판 이름을 출력합니다.

WSL에서 Codex CLI 사용하기

PowerShell이나 Windows 터미널을 관리자 권한으로 열고 다음 명령어를 실행하세요.

# Install default Linux distribution (like Ubuntu)
wsl --install

# Start a shell inside Windows Subsystem for Linux
wsl

그런 다음 WSL 셸에서 다음 명령어를 실행하세요.

# Install and run Codex in WSL
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

WSL에서 코드 작업하기

• /mnt/c/...처럼 WSL에 마운트된 Windows 경로에서 작업하면 Windows에서 같은 경로에 직접 접근할 때보다 느릴 수 있습니다. 리포지터리를 ~/code/my-app처럼 Linux 홈 디렉터리 아래에 두면 입출력 속도가 빨라지고 심볼릭 링크나 권한 관련 문제도 줄어듭니다.

  mkdir -p ~/code && cd ~/code
  git clone https://github.com/your/repo.git
  cd repo

• Windows에서 파일에 접근하려면 파일 탐색기에서 \wsl$\Ubuntu\home<user>로 이동하세요.

문제 해결 및 자주 묻는 질문

which codex || echo "codex not found"