• Windows에서는 WSL(Windows Subsystem for Linux)을 통해서만 실행할 수 있습니다.

윈도우를 통해 작업할때. 가끔 발생하는 오류들의 대부분이 위와같은 문제입니다.

에이전트를 만들때도 그랬고, 커서로 claude-code 를 이용하려고 했을때도 발생했던 오류입니다.

그때 링크를 통해 들어가서

해결할 수 있습니다.

개발자는 Windows 컴퓨터에서 Windows와 Linux의 기능을 동시에 액세스할 수 있습니다. WSL(Linux용 Windows 하위 시스템)을 사용하면 개발자가 Linux 배포판(예: Ubuntu, OpenSUSE, Kali, Debian, Arch Linux 등)을 설치하고 기존 가상 머신 또는 이중 부팅 설정의 오버헤드 없이 수정되지 않은 Windows에서 Linux 애플리케이션, 유틸리티 및 Bash 명령줄 도구를 직접 사용할 수 있습니다.

필수 조건

아래 명령을 사용하려면 Windows 10 버전 2004 이상(빌드 19041 이상) 또는 Windows 11을 실행해야 합니다. 이전 버전에 있는 경우 수동 설치 페이지를 참조하세요.

WSL 설치 명령

이제 단일 명령으로 WSL을 실행하는 데 필요한 모든 항목을 설치할 수 있습니다. "관리자 권한으로 실행"을 마우스 오른쪽 단추로 클릭하고 선택하여 관리자 모드에서 PowerShell 또는 Windows 명령 프롬프트를 열고 wsl --install 명령을 입력한 다음 컴퓨터를 다시 시작합니다.

PowerShell복사

wsl --install

이 명령을 사용하면 WSL을 실행하고 Linux의 Ubuntu 배포를 설치하는 데 필요한 기능을 사용할 수 있습니다. (이 기본 배포는 변경할 수 있습니다).

이전 빌드를 실행 중이거나 설치 명령을 사용하지 않고 단계별 지침을 원하는 경우 이전 버전에 대한 WSL 수동 설치 단계를 참조하세요.

새로 설치된 Linux 배포를 처음 시작할 때 콘솔 창이 열리고 파일이 압축을 해제하고 컴퓨터에 저장될 때까지 대기하라는 메시지가 표시됩니다. 향후 모든 출시에는 1초 미만이 소요됩니다.