Windows에서 WSL2로 Codex 사용하기

시작하기 전에: WSL2인지 확인하기

PowerShell에서 실행하세요:

wsl -l -v

VERSION 열이 2여야 합니다. 1이라면 wsl --set-version <DistroName> 2로 배포판을 변환하세요. OpenAI 문서에 따르면 WSL1은 Codex 0.114까지만 지원되었습니다. WSL1 오류를 참고하세요.

방법 A: 에이전트를 WSL에서 실행하는 데스크톱 앱

1. ChatGPT 데스크톱 앱에서 Settings(설정)를 여세요.
2. 에이전트를 Windows native(Windows 네이티브)에서 WSL로 전환하세요.
3. 앱을 다시 시작하세요. 다시 시작해야 변경 사항이 적용됩니다. 프로젝트는 그대로 유지됩니다.

통합 터미널은 별도로 설정합니다. 에이전트는 WSL에서 실행하면서 터미널에서는 PowerShell을 계속 쓸 수도 있고, 둘 다 WSL을 쓸 수도 있습니다.

방법 B: WSL2 안에 Codex CLI 설치

WSL2 셸을 열고 Linux 설치 프로그램을 사용하세요:

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

Windows와 WSL 간에 구성, 로그인, 기록 공유하기

Windows 앱은 Codex 홈을 %USERPROFILE%\.codex에 둡니다. WSL 안의 CLI는 기본적으로 ~/.codex를 사용하므로, 둘은 설정, 캐시된 인증 정보, 세션을 공유하지 않습니다. 공유하려면 WSL이 Windows 디렉터리를 가리키도록 하세요:

export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

영구적으로 적용하려면 이 줄을 ~/.bashrc 또는 ~/.zshrc에 추가하세요.

프로젝트를 둘 위치

Windows-native(Windows 네이티브) 에이전트를 계속 사용한다면, OpenAI는 프로젝트를 Windows 드라이브에 저장하고 WSL에서는 /mnt/<drive>/...로 접근할 것을 권장합니다. \\wsl$\에서 프로젝트를 여는 것도 가능하지만 Git이 감지되지 않을 수 있습니다. 해결 방법을 참고하세요.