Cách cài Muse Code trên macOS, Linux và Windows (WSL2)

“Bản tải về” chỉ là một lệnh

Nhiều người tìm bản tải Muse Code với mong đợi sẽ thấy một file .dmg, một file .exe hay một trang trên app store. Không có thứ nào như vậy cả. Muse Code là một chương trình dòng lệnh, và cách chính thức để có nó là script cài đặt của Meta:

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

Script đặt binary muse vào PATH của bạn; muse --version xác nhận đã cài thành công. Nếu không muốn pipe một script từ xa thẳng vào shell, hãy tải nó về trước bằng curl -fsSL https://dev.meta.ai/install.sh -o install.sh, đọc qua, rồi mới chạy. Đó là toàn bộ câu chuyện tải về trên mọi nền tảng được hỗ trợ — thứ duy nhất thay đổi là bạn chạy nó ở đâu.

macOS và Linux

Trên Mac hoặc máy Linux, mở terminal và chạy lệnh ở trên. Có hai điều nên biết trước phiên đầu tiên:

Nếu không tìm thấy muse sau khi cài, hãy mở một cửa sổ terminal mới để shell đọc lại PATH.
Lần chạy đầu tiên là bước đăng nhập. Chạy muse trong một thư mục dự án sẽ mở trình duyệt để xác thực tại dev.meta.ai bằng tài khoản Meta developer. Thông tin đăng nhập được cache, nên bạn không phải làm lại mỗi phiên. Trên server, CI runner và các máy headless khác, hãy bỏ qua trình duyệt: tạo một key trong dashboard Model API và export nó thành MODEL_API_KEY.

Từ đó, cd vào một git repository và chạy muse. Hướng dẫn bắt đầu của chúng tôi có gợi ý một task đầu tiên phù hợp.

Windows: cài bên trong WSL2

Không có bản build native cho Windows. Trình cài đặt của Meta nhắm tới macOS và Linux, và các developer thử chạy nó từ PowerShell cho biết nó đơn giản là từ chối chạy. Con đường hoạt động được là Windows Subsystem for Linux, thứ cho bạn một môi trường Linux thực thụ trên Windows 10 hoặc 11:

Mở PowerShell với quyền administrator và chạy wsl --install. Lệnh này cài WSL2 với Ubuntu làm mặc định. Khởi động lại máy khi được nhắc.
Mở Ubuntu từ menu Start và tạo user Linux của bạn.
Bảo đảm đã có sẵn các công cụ cơ bản: sudo apt update && sudo apt install -y curl git.
Chạy trình cài đặt Muse Code bên trong terminal Ubuntu — cùng dòng curl … | bash như ở trên.
Để các repository trong filesystem của Linux, ví dụ ~/code, thay vì dưới /mnt/c. Muse Code đọc và ghi rất nhiều file, và truy cập xuyên qua ranh giới Windows–Linux chậm hơn nhiều.

Nếu bước đăng nhập qua trình duyệt không hiện lên từ bên trong WSL, hãy dùng API key thay thế: tạo một key trong dashboard Model API và đặt MODEL_API_KEY trong file profile của shell Linux.

VS Code, JetBrains và câu hỏi “app desktop”

Meta không phát hành app desktop, IDE hay extension editor chính thức nào cho Muse Code. Điều đó không có nghĩa là bạn phải từ bỏ editor của mình:

VS Code: chạy muse trong terminal tích hợp. Trên Windows, cài extension WSL của Microsoft, mở thư mục dự án trong WSL, và terminal tích hợp sẽ trở thành một shell Linux nơi Muse Code hoạt động bình thường.
Zed và các IDE của JetBrains: các dự án cộng đồng làm cầu nối đưa Muse Code vào những editor hỗ trợ Agent Client Protocol (ACP). Chúng không chính thức — hãy kiểm tra xem chúng gửi gì đi đâu trước khi trỏ một cái vào code riêng tư.

Hãy dè chừng bất cứ thứ gì được quảng cáo là “app desktop Muse Code” hay bản tải “Muse Code cho Windows”. Không thứ nào trong số đó do Meta phát hành; script cài đặt ở trên là kênh phân phối chính thức duy nhất.

Giữ cho bản cài luôn mới

Tài liệu của Meta chỉ nêu trình cài đặt, ngoài ra không có gì khác, nên hãy xem muse --help để biết các lệnh mà phiên bản của bạn hỗ trợ, và theo dõi changelog của chúng tôi để nắm các bản phát hành. Muse Code ra khỏi beta ngày 31 tháng 8 năm 2026 và chuyển sang model Muse Spark 1.3 hai ngày sau đó — một bản cài cập nhật sẽ có cả hai.

Rồi chọn cách trả tiền

Cài đặt thì miễn phí; dùng Muse Code thì không. Bạn có thể đăng ký một gói hằng tháng — Everyday Usage giá $5, High Usage giá $15, hoặc Power Usage giá $50 — hoặc bỏ qua gói và trả theo token qua Meta Model API. Trang pricing so sánh cả hai cách và có sẵn công cụ ước tính chi phí.