Muse Code 다운로드·설치 방법: macOS, Linux, Windows 총정리

’다운로드’는 커맨드 한 줄

Muse Code 다운로드를 검색하는 사람들은 .dmg나 .exe, 혹은 앱스토어 페이지를 기대합니다. 그런 건 없습니다. Muse Code는 커맨드라인 프로그램이고, 공식적인 설치 방법은 Meta의 설치 스크립트입니다. macOS와 Linux에서는 이렇게 합니다:

curl -fsSL https://dev.meta.ai/install.sh | sh

Windows에서는 PowerShell에서 다음을 실행합니다:

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

어느 스크립트든 muse 바이너리를 PATH에 올려놓으며, muse --version으로 설치를 확인할 수 있습니다. 원격 스크립트를 셸에 바로 파이프하고 싶지 않다면, 먼저 내려받아(예: curl -fsSL https://dev.meta.ai/install.sh -o install.sh) 내용을 읽어본 뒤 실행하세요. 지원되는 모든 플랫폼에서 다운로드 이야기는 이게 전부입니다. 달라지는 건 어디서 실행하느냐뿐입니다.

macOS와 Linux

Mac이나 Linux 머신에서는 터미널을 열고 위의 curl 커맨드를 실행하면 됩니다. 첫 세션 전에 알아두면 좋은 것이 두 가지 있습니다.

설치 후 muse를 찾을 수 없다면 새 터미널 창을 열어 셸이 PATH를 다시 읽게 하세요.
첫 실행 때 로그인합니다. 프로젝트 디렉터리에서 muse를 실행하면 브라우저가 열리고, dev.meta.ai에서 Meta 개발자 계정으로 인증하게 됩니다. 인증 정보는 캐시되므로 세션마다 다시 할 필요는 없습니다. 서버, CI 러너 같은 헤드리스 머신에서는 브라우저를 건너뛰세요. Model API 대시보드에서 키를 만들어 META_API_KEY로 내보내거나, muse auth set으로 한 번 저장해 두면 됩니다.

그다음 git 저장소로 cd해서 muse를 실행하세요. 첫 태스크로 무엇이 좋은지는 시작 가이드에서 추천하고 있습니다.

Windows: 네이티브 PowerShell 설치 프로그램

이 가이드를 처음 게시했을 때는 네이티브 Windows 빌드가 없어서 WSL2가 유일한 방법이었습니다. 지금은 다릅니다. Meta 문서에 네이티브 Windows 설치 프로그램이 올라와 있습니다. 언제 나왔는지 Meta가 발표하지는 않았지만(서드파티 가이드가 2026년 9월 22일에 이미 소개하고 있었습니다), 현재는 이것이 공식 경로입니다.

PowerShell을 열고 다음을 실행하세요:

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

그런 다음 새 PowerShell 창을 열어 muse --version을 확인하고, git 저장소 안에서 muse를 실행하면 됩니다. 다만 Windows의 Muse Code가 다른 플랫폼과 완전히 같지는 않습니다. Meta는 다음과 같은 차이를 안내합니다.

Bash 대신 PowerShell. 에이전트가 커맨드를 PowerShell에서 실행하므로, 프로젝트용으로 작성해 주는 스크립트나 원라이너도 Bash가 아니라 PowerShell입니다.
샌드박스 첫 초기화 때 UAC 프롬프트. 샌드박스가 처음 초기화될 때 Windows가 권한을 요청할 수 있습니다. 정상적인 동작입니다.
음성 입력 없음. Windows에서는 음성 기능을 쓸 수 없습니다.
세션 간 메시징 없음. Windows에서는 세션끼리 메시지를 주고받을 수 없습니다. 이 기능은 macOS와 Linux 전용입니다.

Windows의 다른 선택지: WSL2가 나은 경우

WSL2도 여전히 작동합니다. 결국 Linux이므로 Muse Code가 Linux 머신에서와 똑같이 동작합니다. 프로젝트 도구가 Bash를 전제로 하거나, 팀 스크립트가 Linux용으로 작성되어 있거나, 세션 간 메시징을 쓰고 싶다면 WSL2를 고르세요. Linux용 Windows 하위 시스템(WSL)은 Windows 10이나 11에서 진짜 Linux 환경을 쓸 수 있게 해줍니다:

PowerShell을 관리자 권한으로 열고 wsl --install을 실행합니다. 기본적으로 Ubuntu가 포함된 WSL2가 설치됩니다. 재시작하라는 안내가 나오면 재시작하세요.
시작 메뉴에서 Ubuntu를 실행하고 Linux 사용자를 만듭니다.
기본 도구가 갖춰져 있는지 확인합니다: sudo apt update && sudo apt install -y curl git.
Ubuntu 터미널 안에서 macOS/Linux용 설치 프로그램을 실행합니다. PowerShell용이 아니라 위와 똑같은 curl … | sh 한 줄입니다.
저장소는 /mnt/c 아래가 아니라 ~/code 같은 Linux 파일 시스템에 두세요. Muse Code는 파일을 많이 읽고 쓰는데, Windows와 Linux 경계를 넘나드는 접근은 훨씬 느립니다.

WSL 안에서 브라우저 로그인이 뜨지 않으면 API 키를 대신 사용하세요. Model API 대시보드에서 키를 만든 뒤 Linux 셸 프로필에 META_API_KEY를 설정하거나 muse auth set으로 저장하면 됩니다.

VS Code, JetBrains, 그리고 ‘데스크톱 앱’ 문제

Meta는 여전히 Muse Code용 데스크톱 앱도, IDE도, 공식 에디터 확장도 내놓지 않았습니다. 그렇다고 쓰던 에디터를 포기해야 하는 건 아닙니다.

VS Code: 통합 터미널에서 muse를 실행하세요. 네이티브 설치 프로그램을 쓰면 Windows의 PowerShell 터미널에서 바로 작동합니다. Microsoft의 WSL 확장이 필요한 건 WSL2를 택한 경우뿐입니다. 프로젝트 폴더를 WSL에서 열면 통합 터미널이 Linux 셸이 되어 Muse Code가 평소처럼 작동합니다.
Zed와 JetBrains IDE: Agent Client Protocol(ACP)을 지원하는 에디터에 Muse Code를 연결해 주는 커뮤니티 프로젝트들이 있습니다. 모두 비공식이므로, 비공개 코드에 연결하기 전에 무엇을 어디로 보내는지 확인하세요.

“Muse Code 데스크톱 앱”이나 별도의 “Muse Code for Windows” 다운로드라고 광고하는 것은 경계하세요. 그중 어느 것도 Meta가 배포한 것이 아닙니다. 위의 두 설치 스크립트가 유일한 공식 배포 경로입니다. (Microsoft는 10월 7일 Meta의 소비자용 Muse 에이전트가 네이티브 앱으로 Windows에 나온다고 발표했는데, 이건 Muse Code가 아니라 Muse 이야기입니다.)

Muse Code 업데이트하기

보통은 아무것도 하지 않아도 됩니다. Muse Code는 스스로 업데이트합니다. 설치 프로그램이 작은 런처를 함께 설치하고, 이 런처가 실제 바이너리를 최신 상태로 유지합니다. CLI 1.4.11부터는 자동 업데이트가 적용될 때 열려 있던 세션도 기록을 그대로 유지한 채 이어집니다. 현재 버전이 궁금하다면 muse --version을 실행해 저희 변경 로그와 비교해 보세요. 현재 1.4 시리즈는 1.4 릴리스 노트 정리에서 다룹니다. 최신 빌드를 지금 바로 쓰고 싶다면 같은 설치 커맨드를 다시 실행하세요. 기존 설치를 그대로 덮어씁니다.

따로 맞춰 줘야 할 패키지 매니저도 없습니다. Meta는 이 CLI용 Homebrew formula, npm 패키지, winget 패키지를 배포하지 않습니다. npm에 있는 @muse-code/sdk 패키지는 나만의 에이전트를 만들기 위한 SDK이지, Muse Code 자체가 아닙니다.

자주 생기는 설치 문제 해결

설치 후 muse: command not found가 뜰 때. 새 터미널을 열어 셸이 PATH를 다시 읽게 하세요. macOS와 Linux에서는 설치 프로그램이 셸 프로필에 ~/.local/bin을 추가합니다. 흔치 않은 셸을 쓴다면 이 디렉터리를 직접 PATH에 추가하세요.
Linux에서 셸 커맨드가 전부 실패할 때. Linux 샌드박스는 번들로 포함된 bubblewrap 헬퍼에 의존합니다. 이것이 제대로 작동하지 않으면(bubblewrap 없이 배포되는 Alpine 같은 musl 기반 빌드 포함) Muse Code는 샌드박스 없이 셸 커맨드를 실행하는 대신 아예 실행을 거부합니다. glibc 기반 배포판이나 컨테이너를 사용하세요.
Windows에서 처음 실행할 때 권한 요청이 뜨는 경우. Windows 샌드박스가 처음 초기화될 때 관리자 승인(UAC)을 요청할 수 있습니다. 그 뒤로는 Muse Code를 관리자 권한으로 실행할 필요가 없습니다.
회사 프록시나 제한된 네트워크 환경. 먼저 -o install.sh로 스크립트를 내려받아 어떤 호스트에 접속하는지 확인한 다음, 네트워크 팀에 해당 호스트를 허용해 달라고 요청하세요.

Muse Code 제거하기

Meta가 제거 커맨드를 문서로 안내하지 않으므로 직접 지워야 합니다. macOS와 Linux에서는 설치 프로그램이 ~/.local/bin에 muse 런처와 버전별 muse-bin-* 파일을 넣어 둡니다. 이 파일들을 삭제하고, 설정까지 없애고 싶다면 ~/.config/muse/도 지우세요. Windows에서는 PowerShell에서 Get-Command muse를 실행해 바이너리 위치를 확인한 뒤 삭제하면 됩니다. 단, 제거한다고 해서 처리되지 않는 것이 두 가지 있습니다. 구독은 해지되지 않으니 Meta Accounts Center의 구독(Subscriptions) 메뉴에서 따로 해지해야 합니다. 또 Muse Code가 저장소에 만들어 둔 AGENTS.md, .agents/, .muse/ 같은 프로젝트 파일도 삭제되지 않습니다.

이제 결제 방식을 고르세요

설치는 무료지만 Muse Code 사용은 무료가 아닙니다. 월 구독 플랜 — Everyday Usage $5, High Usage $15, Power Usage $50, Maximum Usage $200 — 에 가입하거나, 플랜 없이 Meta Model API를 통해 토큰 단위로 지불할 수 있습니다. 가격 페이지에서 두 방식을 비교할 수 있고, 비용 계산기도 있습니다.