macOS, Linux, Windows(WSL2)에 Muse Code 설치하는 법
Muse Code에는 데스크톱 앱도, Windows 설치 프로그램도 없습니다. 터미널에서 실행하는 설치 커맨드 한 줄이 전부입니다. Mac과 Linux, 그리고 WSL2를 통해 Windows에서 실행하는 방법과 VS Code는 어떻게 하면 되는지까지 정리했습니다.
’다운로드’는 커맨드 한 줄
Muse Code 다운로드를 검색하는 사람들은 .dmg나 .exe, 혹은 앱스토어 페이지를 기대합니다. 그런 건 없습니다. Muse Code는 커맨드라인 프로그램이고, 공식적인 설치 방법은 Meta의 설치 스크립트입니다:
curl -fsSL https://dev.meta.ai/install.sh | bash스크립트가 muse 바이너리를 PATH에 올려놓으며, muse --version으로 설치를 확인할 수 있습니다. 원격 스크립트를 셸에 바로 파이프하고 싶지 않다면, 먼저 curl -fsSL https://dev.meta.ai/install.sh -o install.sh로 내려받아 내용을 읽어본 뒤 실행하세요. 지원되는 모든 플랫폼에서 다운로드 이야기는 이게 전부입니다. 달라지는 건 어디서 실행하느냐뿐입니다.
macOS와 Linux
Mac이나 Linux 머신에서는 터미널을 열고 위 커맨드를 실행하면 됩니다. 첫 세션 전에 알아두면 좋은 것이 두 가지 있습니다.
- 설치 후
muse를 찾을 수 없다면 새 터미널 창을 열어 셸이 PATH를 다시 읽게 하세요. - 첫 실행 때 로그인합니다. 프로젝트 디렉터리에서
muse를 실행하면 브라우저가 열리고, dev.meta.ai에서 Meta 개발자 계정으로 인증하게 됩니다. 인증 정보는 캐시되므로 세션마다 다시 할 필요는 없습니다. 서버, CI 러너 같은 헤드리스 머신에서는 브라우저를 건너뛰세요. Model API 대시보드에서 키를 만들고MODEL_API_KEY로 내보내면 됩니다.
그다음 git 저장소로 cd해서 muse를 실행하세요. 첫 태스크로 무엇이 좋은지는 시작 가이드에서 추천하고 있습니다.
Windows: WSL2 안에 설치하기
네이티브 Windows 빌드는 없습니다. Meta의 설치 프로그램은 macOS와 Linux를 대상으로 하며, PowerShell에서 시도해 본 개발자들은 아예 실행이 거부된다고 전합니다. 제대로 작동하는 경로는 Linux용 Windows 하위 시스템(WSL)으로, Windows 10이나 11에서 진짜 Linux 환경을 쓸 수 있게 해줍니다:
- PowerShell을 관리자 권한으로 열고
wsl --install을 실행합니다. 기본적으로 Ubuntu가 포함된 WSL2가 설치됩니다. 재시작하라는 안내가 나오면 재시작하세요. - 시작 메뉴에서 Ubuntu를 실행하고 Linux 사용자를 만듭니다.
- 기본 도구가 갖춰져 있는지 확인합니다:
sudo apt update && sudo apt install -y curl git. - Ubuntu 터미널 안에서 Muse Code 설치 프로그램을 실행합니다. 위와 똑같은
curl … | bash한 줄입니다. - 저장소는
/mnt/c아래가 아니라~/code같은 Linux 파일 시스템에 두세요. Muse Code는 파일을 많이 읽고 쓰는데, Windows와 Linux 경계를 넘나드는 접근은 훨씬 느립니다.
WSL 안에서 브라우저 로그인이 뜨지 않으면 API 키를 대신 사용하세요. Model API 대시보드에서 키를 만들고 Linux 셸 프로필에 MODEL_API_KEY를 설정하면 됩니다.
VS Code, JetBrains, 그리고 ‘데스크톱 앱’ 문제
Meta는 Muse Code용 데스크톱 앱도, IDE도, 공식 에디터 확장도 내놓지 않았습니다. 그렇다고 쓰던 에디터를 포기해야 하는 건 아닙니다.
- VS Code: 통합 터미널에서
muse를 실행하세요. Windows에서는 Microsoft의 WSL 확장을 설치하고 프로젝트 폴더를 WSL에서 열면, 통합 터미널이 Linux 셸이 되어 Muse Code가 평소처럼 작동합니다. - Zed와 JetBrains IDE: Agent Client Protocol(ACP)을 지원하는 에디터에 Muse Code를 연결해 주는 커뮤니티 프로젝트들이 있습니다. 모두 비공식이므로, 비공개 코드에 연결하기 전에 무엇을 어디로 보내는지 확인하세요.
“Muse Code 데스크톱 앱”이나 “Muse Code for Windows”라고 광고하는 다운로드는 경계하세요. 그중 어느 것도 Meta가 배포한 것이 아닙니다. 위의 설치 스크립트가 유일한 공식 배포 경로입니다.
최신 상태 유지하기
Meta 문서에는 설치 프로그램 말고는 아무 내용도 없으므로, 내 버전이 지원하는 커맨드는 muse --help로 확인하고 릴리스 소식은 저희 변경 로그에서 챙겨 보세요. Muse Code는 2026년 8월 31일에 베타를 졸업했고, 이틀 뒤 Muse Spark 1.3 모델로 전환했습니다. 최신 버전으로 설치해 두면 둘 다 누릴 수 있습니다.
이제 결제 방식을 고르세요
설치는 무료지만 Muse Code 사용은 무료가 아닙니다. 월 구독 플랜 — Everyday Usage $5, High Usage $15, Power Usage $50 — 에 가입하거나, 플랜 없이 Meta Model API를 통해 토큰 단위로 지불할 수 있습니다. 가격 페이지에서 두 방식을 비교할 수 있고, 비용 계산기도 있습니다.