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 確認安裝成功。如果你不想把遠端指令碼直接 pipe 進 shell，可以先下載下來（例如 curl -fsSL https://dev.meta.ai/install.sh -o install.sh）、讀過一遍，再執行。在每個支援的平台上，「下載」這件事就只有這樣——差別只在於你在哪裡執行它。

macOS 與 Linux

在 Mac 或 Linux 電腦上，打開終端機，執行上面那行 curl 指令。第一次開 session 之前，有兩件事值得先知道：

安裝後如果找不到 muse，開一個新的終端機視窗，讓 shell 重新讀取 PATH。
第一次執行會要你登入。 在專案目錄裡執行 muse，它會開啟瀏覽器，讓你用 Meta 開發者帳號在 dev.meta.ai 完成驗證。憑證會被快取，不必每個 session 都重來一次。在伺服器、CI runner 和其他無頭環境的機器上，就跳過瀏覽器：到 Model API 儀表板建立金鑰，然後匯出成 META_API_KEY，或用 muse auth set 儲存一次就好。

接著 cd 進一個 git 儲存庫，執行 muse 就行了。我們的新手上路指南推薦了一個很適合當第一個任務的題目。

Windows：原生的 PowerShell 安裝程式

這篇指南剛發布時，Muse Code 還沒有原生的 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 列出了這幾點差異：

用 PowerShell，不是 Bash。 agent 在 PowerShell 裡執行指令，所以它替你的專案寫的指令碼和單行指令都會是 PowerShell，而不是 Bash。
第一次初始化沙箱時會跳出 UAC 提示。 沙箱第一次初始化時，Windows 可能會要求權限。這是正常的。
沒有語音輸入。 Windows 上無法使用語音。
沒有 session 之間的訊息傳遞。 在 Windows 上，session 之間無法互傳訊息；這項功能只支援 macOS 和 Linux。

Windows 的另一條路：什麼時候該選 WSL2

WSL2 照樣能用——它本身就是 Linux，所以 Muse Code 在裡面的行為和在 Linux 電腦上一模一樣。如果你專案的工具鏈預設用 Bash、團隊的指令碼是為 Linux 寫的，或是你需要 session 之間的訊息傳遞，就優先選它。Windows 子系統 Linux 版（WSL）能在 Windows 10 或 11 上提供一個真正的 Linux 環境：

以系統管理員身分開啟 PowerShell，執行 wsl --install。預設會安裝 WSL2 和 Ubuntu。出現提示時重新開機。
從「開始」功能表啟動 Ubuntu，建立你的 Linux 使用者。
確認基本工具都已備妥：sudo apt update && sudo apt install -y curl git。
在 Ubuntu 終端機裡執行 macOS/Linux 的安裝程式——就是上面那行 curl … | sh，不是 PowerShell 那一行。
把儲存庫放在 Linux 檔案系統裡，例如 ~/code，而不是放在 /mnt/c 底下。Muse Code 會大量讀寫檔案，而跨越 Windows 與 Linux 邊界的存取速度慢上許多。

如果在 WSL 裡叫不出瀏覽器登入畫面，就改用 API 金鑰：到 Model API 儀表板建立一把，然後在 Linux shell 的設定檔裡設定 META_API_KEY，或用 muse auth set 把它存起來。

VS Code、JetBrains，以及「桌面應用程式」的問題

Meta 到現在仍沒有替 Muse Code 推出桌面應用程式、IDE，也沒有官方的編輯器擴充功能。但這不代表你得放棄慣用的編輯器：

VS Code： 在整合式終端機裡執行 muse。用原生安裝程式的話，在 Windows 的 PowerShell 終端機裡就能直接使用。只有選了 WSL2，才需要 Microsoft 的 WSL 擴充功能：在 WSL 中開啟專案資料夾，整合式終端機就會變成 Linux shell，Muse Code 可以在裡面正常運作。
Zed 與 JetBrains IDE： 有社群專案把 Muse Code 串接到支援 Agent Client Protocol（ACP）的編輯器。這些都是非官方的——讓它們碰你的私有程式碼之前，先查清楚它們把什麼資料送到哪裡。

對任何標榜「Muse Code 桌面應用程式」或獨立「Muse Code for Windows」的下載，都要提高警覺。這些沒有一個是 Meta 發布的；上面那兩支安裝指令碼是唯一的官方發行管道。（Microsoft 在 10 月 7 日宣布，Meta 的消費者 Muse agent 將以原生應用程式登上 Windows——那是 Muse，不是 Muse Code。）

更新 Muse Code

平常你什麼都不用做：Muse Code 會自己更新。安裝程式會裝上一個小型啟動器，由它負責讓真正的執行檔保持最新；從 CLI 1.4.11 開始，自動更新完成時還開著的 session，也會帶著歷史紀錄接續下去。想知道自己目前是哪個版本，執行 muse --version，再對照我們的更新日誌——目前這個系列的變更請見 1.4 版本說明。如果想馬上用到最新版本，重新執行同一行安裝指令就行，它會直接蓋掉現有的版本。

也沒有什麼套件管理工具的管道需要同步。Meta 沒有替這個 CLI 發布 Homebrew formula、npm 套件或 winget 套件——npm 上的 @muse-code/sdk 是讓你打造自己 agent 的 SDK，不是 Muse Code 本身。

常見安裝問題排解

安裝後出現 muse: command not found。 開一個新的終端機，讓 shell 重新讀取 PATH。在 macOS 和 Linux 上，安裝程式會把 ~/.local/bin 加進你的 shell 設定檔；如果你用的是比較少見的 shell，就自己把這個目錄加進 PATH。
在 Linux 上每個 shell 指令都失敗。 Linux 沙箱仰賴內建的 bubblewrap 輔助程式。少了能正常運作的 bubblewrap——包括 Alpine 這類以 musl 為基礎、本來就沒有附帶它的發行版——Muse Code 寧可拒絕執行 shell 指令，也不會在沒有沙箱的情況下執行。請改用以 glibc 為基礎的發行版或容器。
Windows 第一次執行時跳出權限提示。 Windows 沙箱第一次初始化時，可能會要求系統管理員核准（UAC）。之後就不必再以系統管理員身分執行 Muse Code。
公司的 Proxy 和受限的網路。 先用 -o install.sh 把指令碼下載下來，看清楚它會連到哪些主機，再請網管團隊開放這些主機。

解除安裝 Muse Code

Meta 的文件沒有提供解除安裝指令，所以只能手動移除。在 macOS 和 Linux 上，安裝程式會把 muse 啟動器和帶版本號的 muse-bin-* 檔案放在 ~/.local/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 按 token 付費。定價頁面比較了這兩種方式，也附有費用估算器。