macOS 安裝 Muse Code 完整指南 | 一行指令啟動 Meta AI 編碼代理

AI
, , , ,
1

學習如何在 macOS 上安裝 Muse Code：確認系統需求、安裝 Docker Desktop、執行官方一行指令、完成登入或 API Key 設定，並整合至 Cursor 或 VS Code。

Muse Code 是 Meta 推出的 AI 編碼代理（coding agent），能直接在終端機中協助你生成、重構與除錯程式碼。它透過 Docker 容器執行，支援 macOS 與 Linux，尤其對 Apple Silicon 有良好效能。本指南將帶你從零開始，在 macOS 上完成安裝與首次啟動。

安裝前準備

確認 macOS 版本

Muse Code 官方支援 macOS 與 Linux，建議使用 macOS Monterey（12）或更新版本。Apple Silicon（M1/M2/M3）晶片能獲得最佳效能。

安裝 Docker Desktop（必要條件）

Muse Code 依賴 Docker 容器環境，因此必須先安裝 Docker Desktop。

  1. 前往 Docker 官方網站 下載 macOS 版本。
  2. 安裝並完成初始設定。
  3. 開啟 Docker Desktop，確認右上角鯨魚圖示顯示為 Running 狀態。

一行指令安裝 Muse Code

  1. 開啟 Terminal（可透過 Spotlight 搜尋「Terminal」或前往 /Applications/Utilities/Terminal.app）。
  2. 執行官方安裝指令：
curl -fsSL https://dev.meta.ai/install.sh | bash
  • curl -fsSL：下載安裝腳本。
  • | bash：直接以 bash 執行腳本。
  1. 等待安裝完成。終端機會顯示進度，完成後通常會提示你可以使用 muse 指令。

第一次啟動 Muse Code

  1. 切換到你要開發的專案資料夾：
cd /path/to/your/project
  1. 執行 Muse Code：
muse
  1. 首次啟動時會出現認證選項，請選擇其中一種：
  • Login with browser：終端機會開啟瀏覽器，引導你登入 Meta 帳號。你可能需要先設定付款資訊才能使用 API。
  • Set an API key：將你在 Meta Model API 控制台 申請到的 API Key 貼到終端機。

完成認證後，Muse Code 即可開始運作。

在編輯器中整合使用（可選）

Muse Code 可透過 MCP（Model Context Protocol）與支援 AI Agent 的編輯器整合，例如 Cursor 或安裝了 Claude Code 外掛的 VS Code / JetBrains。

  1. 在編輯器中安裝對應的 MCP server 外掛。
  2. 設定外掛連接到本機的 Muse Code 服務。
  3. 之後即可在編輯器的指令面板中呼叫 Muse Code 進行程式生成或重構。

常見問題與排錯

curl: command not found

表示系統缺少 Command Line Tools。請執行以下指令安裝：

xcode-select --install

muse: command not found

可能是安裝腳本執行失敗或 PATH 未更新。請先關閉並重新開啟 Terminal，再試一次 muse。若仍無效，重新執行安裝指令。

Docker 未啟動

如果 Docker Desktop 未執行，Muse Code 的容器服務將無法啟動。請開啟 Docker Desktop，等待右上角圖示顯示 Running 後再試。

結論

透過 Docker 容器化技術，Muse Code 在 macOS 上的安裝流程相當簡潔——只需一行指令即可完成。無論你是偏好純終端機操作，還是習慣整合至 Cursor、VS Code 等編輯器，都能快速啟用這個 AI 編碼代理，提升開發效率。

References / Sources