ChatGPT 문서
한국어
문의 goolvyouyou@gmail.com

WSL

Windows Subsystem for Linux에서 Codex 실행 및 문제 해결

WSL2를 사용하면 Codex는 네이티브 Windows 샌드박스를 사용하는 대신 Linux 환경 내부에서 실행됩니다. Linux 네이티브 도구가 필요하거나, 리포지토리와 개발자 워크플로가 이미 WSL2에 있거나, 네이티브 Windows 샌드박스 모드가 모두 현재 환경에서 작동하지 않는 경우 WSL2를 선택하세요.

WSL1은 Codex 0.114까지 지원되었습니다. Codex 0.115부터 Linux 샌드박스가 bubblewrap(으)로 전환되었으므로 WSL1은 더 이상 지원되지 않습니다.

WSL 내부에서 VS Code 실행

단계별 지침은 공식 VS Code WSL 튜토리얼을 참조하세요.

사전 요구 사항

  • WSL이 설치된 Windows가 필요합니다. WSL을 설치하려면 PowerShell을 관리자 권한으로 연 다음 wsl --install을 실행하세요(Ubuntu가 일반적인 선택입니다).
  • WSL 확장 프로그램이 설치된 VS Code가 필요합니다.

WSL 터미널에서 VS Code 열기

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

이 명령은 WSL 원격 창을 열고, 필요한 경우 VS Code Server를 설치하며, 통합 터미널이 Linux에서 실행되도록 합니다.

WSL 연결 확인

  • WSL: <distro>이 표시되는 녹색 상태 표시줄을 확인하세요.
  • 통합 터미널에는 C:\ 대신 Linux 경로(예: /home/...)가 표시되어야 합니다.
  • 다음 명령으로 확인할 수 있습니다.
  echo $WSL_DISTRO_NAME

이 명령은 배포판 이름을 출력합니다.

상태 표시줄에 "WSL: ..."이 표시되지 않으면 Ctrl+Shift+P을 누르고 WSL: Reopen Folder in WSL을 선택하세요. 최상의 성능을 위해 리포지토리는 C:\이 아닌 /home/... 아래에 두세요.

Windows 앱이나 프로젝트 선택기에 WSL 리포지토리가 표시되지 않으면 파일 선택기 또는 Explorer에 \\wsl$을 입력한 다음 배포판의 홈 디렉터리로 이동하세요.

WSL에서 Codex CLI 사용

관리자 권한으로 실행한 PowerShell 또는 Windows Terminal에서 다음 명령을 실행하세요.

# 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/... 같은 Windows 마운트 경로에서 작업하면 Windows 네이티브 경로에서 작업할 때보다 느릴 수 있습니다. 더 빠른 I/O와 더 적은 심볼릭 링크 및 권한 문제를 위해 리포지토리를 Linux 홈 디렉터리(예: ~/code/my-app) 아래에 두세요.
  mkdir -p ~/code && cd ~/code
  git clone https://github.com/your/repo.git
  cd repo
  • Windows에서 파일에 접근해야 하는 경우 Explorer의 \\wsl$\Ubuntu\home\&lt;user&gt; 아래에서 찾을 수 있습니다.

문제 해결 및 FAQ

WSL에서 대규모 리포지토리가 느리게 느껴집니다

  • /mnt/c 아래에서 작업하고 있지 않은지 확인하세요. 리포지토리를 WSL로 이동하세요(예: ~/code/...).
  • 필요한 경우 WSL의 메모리와 CPU 할당량을 늘리고 WSL을 최신 버전으로 업데이트하세요.
  wsl --update
  wsl --shutdown

WSL의 VS Code에서 codex를 찾을 수 없습니다

바이너리가 존재하고 WSL 내부의 PATH에 포함되어 있는지 확인하세요.

which codex || echo "codex not found"

바이너리를 찾을 수 없으면 Codex CLI 설정 지침을 따르세요.