Claude Cowork, Docker Desktop 같은 도구를 Windows 10/11 Home에서 사용하려면 WSL2(Windows Subsystem for Linux 2) 를 먼저 설치해야 합니다. 이 글은 설치 경험이 없는 분도 따라할 수 있도록 단계별로 안내합니다.
이 글이 필요한 분: Windows 10/11 Home에서 Claude Cowork 또는 Docker Desktop 설치를 시도했다가 막히신 분
WSL2가 왜 필요한가요?
WSL2는 Windows 안에서 리눅스를 실행할 수 있게 해주는 기능입니다. 그런데 Cowork나 Docker처럼 가상 머신을 쓰는 도구들은 내부적으로 Windows의 가상화 엔진(vmcompute 서비스)을 필요로 합니다.
WSL2를 설치하면 이 가상화 엔진이 함께 활성화됩니다. WSL2의 리눅스 배포판을 직접 사용할 일이 없더라도, “가상화 엔진을 켜는 스위치” 역할로서 WSL2 설치가 필요합니다.
WSL1은 안 되나요? WSL1은 가상 머신 방식이 아니라 시스템 번역 방식이라, Cowork에 필요한 가상화 엔진을 활성화하지 않습니다. WSL2여야 합니다.
Cowork 동작에 필요한 최소 조건
정확히는 아래 세 가지 조건만 갖춰지면 됩니다.
| 조건 | 담당 |
|---|---|
| BIOS에서 CPU 가상화 활성화 (Intel VT-x 또는 AMD-V) | 직접 확인 필요 |
| 가상 머신 플랫폼(VirtualMachinePlatform) Windows 기능 활성화 | wsl --install이 자동 처리 |
| vmcompute 서비스 실행 | WSL2 Store 앱이 자동 처리 |
CPU 가상화 하나만 직접 확인하면 됩니다. 나머지 둘은 wsl --install 실행 시 자동으로 처리됩니다.
“Hyper-V가 필요하다”는 말이 사실인가요? 아닙니다. Hyper-V는 Windows Pro/Enterprise 전용 기능으로, Home 에디션에는 없습니다. 일부 GitHub 이슈나 문서에서 “Hyper-V 필요”라고 언급하는 경우가 있지만, 이는 부정확하거나 과도한 요구사항입니다. WSL2만 올바르게 설치된 Home 에디션에서도 Cowork는 정상 동작합니다.
설치 전 확인: CPU 가상화
WSL2는 CPU의 하드웨어 가상화 기능이 켜져 있어야 동작합니다.
Ctrl+Shift+Esc → 성능 탭 → CPU를 클릭하면 우측 하단에
“가상화: 사용” 또는 “가상화: 사용 안 함” 이 표시됩니다.
- “가상화: 사용” → 다음 단계로 바로 진행하세요.
- “가상화: 사용 안 함” → 컴퓨터를 재시작하고 BIOS/UEFI 설정 화면에서
Intel VT-x 또는 AMD-V 항목을 활성화한 뒤 다시 부팅해야 합니다.
BIOS 진입 방법은 제조사마다 다르며, 보통 부팅 직후
F2,Del,F10키로 진입합니다.
WSL2 설치
이미 WSL2가 설치되어 있는지 먼저 확인
PowerShell 또는 명령 프롬프트를 열고 아래 명령어를 실행합니다.
wsl --version버전 번호가 2.x.x.x 형태로 출력된다면 WSL2가 이미 설치된 것입니다.
이 경우 설치 확인 섹션으로 바로 이동하세요.
신규 설치 (WSL이 없는 경우)
PowerShell 또는 명령 프롬프트를 관리자 권한으로 열고 아래 명령어를 실행합니다.
관리자 권한으로 여는 방법: 시작 메뉴에서 “PowerShell”을 검색 → 우클릭 → “관리자 권한으로 실행”
wsl --install설치가 완료되면 재시작을 요청합니다. 컴퓨터를 재시작합니다.
재시작 후 Ubuntu 터미널 창이 자동으로 열리면서 아래와 같은 메시지가 나타납니다.
Installing, this may take a few minutes...
Please create a default UNIX user account. The username does not need to match your Windows username.
Enter new UNIX username:사용자 이름과 비밀번호를 입력합니다. 이 계정은 Linux 환경용이며, Cowork 사용에는 직접 영향을 주지 않습니다. 입력 후 터미널을 닫아도 됩니다.
WSL1에서 WSL2로 업그레이드 (WSL1이 이미 설치된 경우)
wsl --version 명령이 작동하지 않고 wsl -l -v 명령 결과에서
VERSION 열이 1로 표시된다면 WSL1입니다. 아래 명령어로 업그레이드합니다.
# WSL 커널을 최신 버전으로 업데이트
wsl --update
# 이후 새로 설치되는 배포판의 기본 버전을 WSL2로 설정
wsl --set-default-version 2
# 이미 설치된 배포판을 WSL2로 전환 (배포판 이름은 wsl -l -v 결과에 맞게)
wsl --set-version Ubuntu 2배포판 이름 확인:
wsl -l -v명령으로 설치된 배포판 이름을 확인하세요. Ubuntu 외에 다른 배포판을 사용 중이라면 해당 이름으로 바꿔서 실행합니다.
전환에 수 분이 걸릴 수 있습니다. 완료 후 재시작합니다.
”Windows 기능 켜기/끄기”와의 관계
설치 중 또는 이후에 “Windows 기능 켜기/끄기”를 열면 몇 가지 항목이 눈에 띕니다. 각 항목의 정확한 의미를 정리합니다.
| 항목 | 상태 | 설명 |
|---|---|---|
| 리눅스용 Windows 하위 시스템 | wsl --install로 설치했다면 체크 안 됨이 정상 | 2022년부터 Store 앱으로 분리됨. 레거시 방식(Windows 기능에서 직접 체크)으로 설치한 경우 체크되어 있을 수 있으며, 그것도 정상 |
| 가상 머신 플랫폼 | 체크되어 있어야 함 | wsl --install이 자동 활성화. 확인 후 없다면 체크 |
| Hyper-V | 없거나 회색 처리 | Home 에디션 전용 기능이 아님. 필요하지 않음 |
wsl --install 명령으로 설치했다면 가상 머신 플랫폼은 이미 자동으로 활성화됩니다.
직접 확인하고 싶다면 “Windows 기능 켜기/끄기”에서 가상 머신 플랫폼 항목에 체크 표시가 있는지 확인하세요.
Hyper-V가 보이지 않거나 비활성화되어 있어도 정상입니다. Hyper-V는 Home 에디션에 없는 기능이며, Cowork 동작에 불필요합니다.
설치 확인
PowerShell에서 아래 두 명령어로 설치 상태를 확인합니다.
# WSL2 버전 확인
wsl --version
# vmcompute 서비스 실행 여부 확인
Get-Service vmcomputewsl --version 결과가 2.x.x.x이고,
Get-Service vmcompute의 Status가 Running 또는 Stopped로 나오면
(Stopped도 정상 — 필요할 때 자동으로 시작됩니다) 설치가 완료된 것입니다.
트러블슈팅
wsl --install 실행 시 오류가 나는 경우
인터넷 연결을 확인하고, PowerShell을 반드시 관리자 권한으로 열었는지 확인하세요.
오류 코드가 0x80370102라면 BIOS에서 CPU 가상화가 비활성화된 것입니다.
재시작 후 Ubuntu 창이 뜨지 않는 경우
시작 메뉴에서 “Ubuntu”를 검색해 직접 실행합니다. 초기 설정(사용자명/비밀번호)을 완료한 뒤 닫으면 됩니다.
Get-Service vmcompute 결과가 나오지 않는 경우
PowerShell을 관리자 권한으로 실행해야 합니다.
동일한 방법을 따라 했는데도 Cowork가 실행되지 않는 경우
동일한 Windows 11 Home 환경이라도 메인보드 펌웨어 버전에 따라 동작 여부가 달라질 수 있습니다. 관련 GitHub 이슈에서 다른 사용자들의 경험을 확인할 수 있습니다.
WSL2 설치가 완료됐다면 이제 Claude Cowork 설치로 돌아가세요.
💬 댓글 (0)