최종 업데이트: 2026년 9월 28일

Windows에서 Muse Code: 네이티브 설치, WSL2 필요 없음

요약 Muse Code는 Windows에서 네이티브로 실행됩니다. PowerShell을 열고 irm https://dev.meta.ai/install.ps1 | iex를 실행하면 됩니다. WSL2도, Linux 가상 머신도, 데스크톱 앱도 필요 없습니다. Windows에서 빠진 기능은 음성 입력과 세션 메시징뿐입니다.

WSL2가 필요한가요? 아닙니다

"Windows용 설치 프로그램이 없으니 먼저 WSL2를 설정하라"는 가이드가 아직 많습니다. 이는 오래된 정보입니다. 공식 문서에는 PowerShell용 설치 프로그램이 있고, 플랫폼 지원 항목에는 Muse Code가 "하나의 코드베이스로 macOS, Linux, Windows에서 실행"된다고 적혀 있습니다. WSL에 대한 언급은 전혀 없습니다.

이미 WSL 안에서 작업하는 것이 편하다면 그곳에 Linux 버전을 설치해도 됩니다. 이는 취향의 문제이지 필수 조건이 아닙니다.

5단계로 Windows에 Muse Code 설치하기

PowerShell 열기. Windows PowerShell 또는 Windows 터미널을 일반 사용자 권한으로 엽니다. 관리자 권한으로 실행할 필요는 없습니다.
공식 설치 프로그램 실행. 다음을 실행합니다: irm https://dev.meta.ai/install.ps1 | iex. 네이티브 muse 바이너리가 PATH에 추가됩니다.
설치 확인. 새 PowerShell 창을 열고 다음을 실행합니다: muse --version.
프로젝트에서 Muse Code 시작. cd로 프로젝트 폴더에 들어가 muse를 실행합니다. 작업 공간을 신뢰한 다음 브라우저 또는 API 키로 로그인합니다.
샌드박스 확인 창을 한 번 승인. 샌드박스가 처음 시작될 때 Windows가 사용자 계정 컨트롤(UAC) 확인 창을 띄울 수 있습니다. 승인하면 됩니다. 일반적인 사용에는 관리자 권한이 필요하지 않습니다.

irm https://dev.meta.ai/install.ps1 | iex

muse --version

설치는 dev.meta.ai에서만 하세요. 공식 Muse Code .exe, .msi, 데스크톱 앱은 존재하지 않습니다. Muse Code를 안전하게 다운로드하는 방법도 참고하세요.

출처: 공식 문서: 설치 및 플랫폼 지원

Windows에서 달라지는 점

항목	Windows에서는
셸	에이전트가 실행하는 명령은 Bash가 아닌 PowerShell 문법과 Windows 명령줄 도구를 사용합니다.
샌드박스	샌드박스를 처음 시작할 때 UAC 확인 창이 뜰 수 있습니다. 일반적인 사용에는 관리자 권한이 필요하지 않습니다.
음성 입력	사용 불가
세션 메시징	사용 불가(macOS와 Linux에서는 지원)
그 밖의 모든 것	CLI, 모델, 플랜, 명령어는 macOS 및 Linux와 동일

명령이 PowerShell에서 실행되므로, 프로젝트 지침(AGENTS.md)이나 스크립트가 Bash를 전제로 하고 있다면 이 점에 유의하세요.

Windows의 VS Code에서 Muse Code 사용하기

공식 VS Code 확장 프로그램은 없습니다. 통합 터미널(기본값은 PowerShell)을 열고 cd로 저장소에 들어가muse를 실행하세요. 위의 내용이 모두 그대로 적용됩니다.

다음 단계

Muse Code 사용법: 로그인, 신뢰 확인, 명령어, 첫 번째 작업.
Muse Code 가격: 플랜과 토큰 요금.
비용 계산기: 월 예상 요금 계산.

자주 묻는 질문

Muse Code는 Windows를 지원하나요?

네. Meta 문서에 따르면 Muse Code는 "하나의 코드베이스로 macOS, Linux, Windows에서 실행"됩니다. Windows에서는 PowerShell에서 irm https://dev.meta.ai/install.ps1 | iex로 설치합니다.

Muse Code를 쓰려면 WSL2가 필요한가요?

아닙니다. 공식 설치 프로그램은 네이티브 Windows 바이너리를 PATH에 추가합니다. 공식 문서에는 WSL에 대한 언급이 전혀 없습니다. WSL2를 먼저 설치하라는 가이드는 예전 상태의 제품을 설명하고 있습니다.

WSL 안에서 Muse Code를 써도 되나요?

Linux 셸을 선호한다면 WSL 배포판 안에서 macOS/Linux용 설치 명령어(curl -fsSL https://dev.meta.ai/install.sh | sh)를 일반 Linux 머신처럼 실행할 수 있습니다. 선택 사항일 뿐 필수는 아닙니다.

Windows가 왜 관리자 승인을 요청하나요?

Muse Code 샌드박스가 처음 초기화될 때 Windows가 사용자 계정 컨트롤(UAC) 확인 창을 띄울 수 있습니다. Meta 문서에 따르면 일반적인 사용에는 관리자 권한으로 실행할 필요가 없습니다.

Windows에서 작동하지 않는 기능은 무엇인가요?

음성 입력과 세션 메시징은 Windows에서 사용할 수 없습니다. 에이전트가 실행하는 명령은 Bash 대신 PowerShell 문법을 사용합니다.

Muse Code Windows 앱이나 .exe 다운로드가 있나요?

없습니다. Meta는 Muse Code를 PowerShell 한 줄 명령어로 설치하는 명령줄 도구로 제공합니다. "Windows용 Muse Code" .exe나 데스크톱 클라이언트를 내세우는 사이트는 공식이 아닙니다.

Windows의 VS Code에서 Muse Code를 쓸 수 있나요?

네, VS Code의 통합 터미널(PowerShell)에서 사용할 수 있습니다. 공식 문서에는 VS Code 확장 프로그램이 나와 있지 않습니다.