Tải và cài đặt Muse Code trên macOS, Linux và Windows

“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. Trên macOS và Linux:

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

Trên Windows, trong PowerShell:

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

Script nào cũng đặ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 (ví dụ 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 curl ở 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 rồi export nó thành META_API_KEY, hoặc lưu nó một lần bằng muse auth set.

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: trình cài đặt PowerShell native

Khi bài hướng dẫn này mới đăng, Windows chưa có bản build native và WSL2 là con đường duy nhất. Giờ thì đã khác: tài liệu của Meta hiện có trình cài đặt native cho Windows. Meta không công bố nó xuất hiện từ ngày nào (một hướng dẫn của bên thứ ba đã mô tả nó từ trước ngày 22 tháng 9 năm 2026), nhưng hôm nay đây là con đường chính thức.

Mở PowerShell và chạy:

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

Sau đó mở một cửa sổ PowerShell mới, kiểm tra muse --version, rồi chạy muse bên trong một git repository. Dù vậy, Muse Code trên Windows không hoàn toàn giống các nền tảng khác — Meta liệt kê những khác biệt sau:

PowerShell thay cho Bash. Agent chạy lệnh trong PowerShell, nên các script và lệnh một dòng mà nó viết cho dự án của bạn sẽ là PowerShell chứ không phải Bash.
Hộp thoại UAC ở lần khởi tạo sandbox đầu tiên. Lần đầu sandbox khởi tạo, Windows có thể hỏi xin quyền. Điều này là bình thường.
Không có nhập liệu bằng giọng nói. Tính năng voice không có trên Windows.
Không có nhắn tin giữa các phiên. Trên Windows, các phiên không thể nhắn tin cho nhau; tính năng này chỉ có trên macOS và Linux.

Lựa chọn khác trên Windows: khi nào nên dùng WSL2

WSL2 vẫn dùng tốt — nó là Linux, nên Muse Code chạy y hệt như trên một máy Linux. Hãy chọn nó nếu công cụ của dự án mặc định dùng Bash, nếu script của team được viết cho Linux, hoặc nếu bạn cần nhắn tin giữa các phiên. Windows Subsystem for Linux 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 cho macOS/Linux bên trong terminal Ubuntu — cùng dòng curl … | sh như ở trên, không phải dòng PowerShell.
Để 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, rồi đặt META_API_KEY trong file profile của shell Linux hoặc lưu nó bằng muse auth set.

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

Meta vẫn 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. Với trình cài đặt native, cách này chạy thẳng trên Windows trong một terminal PowerShell. Chỉ khi chọn WSL2 bạn mới cần 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 một bản tải “Muse Code cho Windows” riêng lẻ. Không thứ nào trong số đó do Meta phát hành; hai script cài đặt ở trên là kênh phân phối chính thức duy nhất. (Ngày 7 tháng 10, Microsoft thông báo agent Muse dành cho người dùng phổ thông của Meta sắp có mặt trên Windows dưới dạng app native — đó là Muse, không phải Muse Code.)

Cập nhật Muse Code

Thường thì bạn không phải làm gì cả: Muse Code tự cập nhật. Trình cài đặt dựng sẵn một launcher nhỏ lo việc giữ binary thật luôn ở bản mới, và từ CLI 1.4.11, một phiên đang mở khi bản cập nhật tự động được cài sẽ tiếp tục lại cùng với lịch sử của nó. Muốn biết mình đang ở bản nào, hãy chạy muse --version rồi đối chiếu với changelog của chúng tôi — ghi chú phát hành 1.4 điểm qua loạt phiên bản hiện tại. Nếu muốn lấy ngay bản build mới nhất, cứ chạy lại đúng lệnh cài đặt; nó sẽ thay thế bản đang có.

Cũng không có kênh package manager nào cần đồng bộ. Meta không phát hành Homebrew formula, package npm hay package winget nào cho CLI — package @muse-code/sdk trên npm là SDK để bạn tự xây agent riêng, không phải bản thân Muse Code.

Xử lý các lỗi cài đặt thường gặp

Báo muse: command not found sau khi cài. Mở một terminal mới để shell đọc lại PATH. Trên macOS và Linux, trình cài đặt thêm ~/.local/bin vào file profile của shell; nếu bạn dùng một shell ít phổ biến, hãy tự thêm thư mục đó vào PATH.
Trên Linux, lệnh shell nào cũng thất bại. Sandbox trên Linux dựa vào một helper bubblewrap đi kèm. Nếu helper này không chạy được — kể cả trên các bản dựa trên musl như Alpine, vốn không có sẵn nó — Muse Code sẽ từ chối chạy lệnh shell chứ không chịu chạy chúng ngoài sandbox. Hãy dùng một bản phân phối hoặc container dựa trên glibc.
Hộp thoại xin quyền của Windows ở lần chạy đầu. Lần đầu khởi tạo, sandbox của Windows có thể xin quyền administrator (UAC). Sau đó bạn không cần chạy Muse Code với quyền administrator nữa.
Proxy công ty và mạng bị khóa chặt. Tải script về trước bằng -o install.sh để xem nó kết nối tới những host nào, rồi nhờ team mạng mở cho các host đó.

Gỡ cài đặt Muse Code

Meta không có tài liệu nào về lệnh gỡ cài đặt, nên bạn phải gỡ thủ công. Trên macOS và Linux, trình cài đặt đặt launcher muse cùng các file muse-bin-* theo phiên bản vào ~/.local/bin; hãy xóa chúng đi, và xóa luôn ~/.config/muse/ nếu muốn bỏ cả phần thiết lập. Trên Windows, chạy Get-Command muse trong PowerShell để xem binary nằm ở đâu, rồi xóa nó. Có hai việc mà gỡ cài đặt không làm thay bạn: nó không hủy gói đăng ký — việc đó làm ở mục Subscriptions trong Accounts Center của Meta — và nó không xóa các file dự án mà Muse Code đã ghi vào repository của bạn, như AGENTS.md, .agents/ và .muse/.

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, Power Usage giá $50, hoặc Maximum Usage giá $200 — 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í.