指南· 4 分鐘閱讀

如何在 macOS、Linux 與 Windows(WSL2)上安裝 Muse Code

Muse Code 沒有桌面應用程式,也沒有 Windows 安裝檔——只有一行終端機安裝指令。這篇說明怎麼在 Mac、Linux,以及透過 WSL2 在 Windows 上把它跑起來,還有 VS Code 該怎麼搭配。

#install#windows#wsl#getting-started

所謂的「下載」,就是一行指令

大家搜尋 Muse Code 下載時,期待看到的是 .dmg.exe,或是一個應用程式商店頁面。這些都不存在。Muse Code 是一支命令列程式,官方的取得方式就是 Meta 的安裝指令碼:

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

指令碼會把 muse 執行檔放進你的 PATH;跑 muse --version 確認安裝成功。如果你不想把遠端指令碼直接 pipe 進 shell,可以先用 curl -fsSL https://dev.meta.ai/install.sh -o install.sh 下載下來、讀過一遍,再執行。在每個支援的平台上,「下載」這件事就只有這樣——差別只在於你在哪裡執行它。

macOS 與 Linux

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

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

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

Windows:裝在 WSL2 裡

Muse Code 沒有原生的 Windows 版本。Meta 的安裝程式鎖定的是 macOS 和 Linux,有開發者回報,從 PowerShell 執行時它直接拒絕執行。可行的路線是 Windows 子系統 Linux 版(WSL),它能在 Windows 10 或 11 上提供一個真正的 Linux 環境:

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

如果在 WSL 裡叫不出瀏覽器登入畫面,就改用 API 金鑰:到 Model API 儀表板建立一把,並在 Linux shell 的設定檔裡設定 MODEL_API_KEY

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

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

  • VS Code: 在整合式終端機裡執行 muse。在 Windows 上,安裝 Microsoft 的 WSL 擴充功能,在 WSL 中開啟專案資料夾,整合式終端機就會變成 Linux shell,Muse Code 可以在裡面正常運作。
  • Zed 與 JetBrains IDE: 有社群專案把 Muse Code 串接到支援 Agent Client Protocol(ACP)的編輯器。這些都是非官方的——讓它們碰你的私有程式碼之前,先查清楚它們把什麼資料送到哪裡。

對任何標榜「Muse Code 桌面應用程式」或「Muse Code for Windows」的下載,都要提高警覺。這些沒有一個是 Meta 發布的;上面那個安裝指令碼是唯一的官方發行管道。

保持在最新版本

Meta 的文件只提供安裝程式,其他什麼都沒有,所以請用 muse --help 查看你這個版本支援哪些指令,並追蹤我們的更新日誌掌握新版本。Muse Code 在 2026 年 8 月 31 日結束 beta,兩天後改用 Muse Spark 1.3 模型——只要安裝保持最新,兩者都能拿到。

接著決定怎麼付費

安裝免費,使用 Muse Code 則不然。你可以訂閱月費方案——Everyday Usage 5 美元、High Usage 15 美元,或 Power Usage 50 美元——也可以不訂方案,透過 Meta Model API 按 token 付費。定價頁面比較了這兩種方式,也附有費用估算器。

繼續閱讀