最後更新: 2026年9月28日

Muse Code 使用教學：從安裝到第一個任務

1. 安裝 CLI。 macOS/Linux：curl -fsSL https://dev.meta.ai/install.sh | sh。Windows（PowerShell）：irm https://dev.meta.ai/install.ps1 | iex。
2. 確認安裝。 執行 muse --version。
3. 在專案中開始工作階段。 在專案目錄中執行 muse，並核准工作區信任提示。
4. 登入。 選擇用瀏覽器登入，或貼上 Meta API 金鑰。腳本和 CI 請設定環境變數 META_API_KEY。
5. 交付第一個任務。 在輸入框中輸入任務。按 Enter 可在進行中的回合加入指示，Alt+Enter 排入下一個回合，Esc 取消。

如何安裝 Muse Code（Mac、Linux、Windows）

macOS 與 Linux

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

Windows（PowerShell）

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

Muse Code 可在 Windows 上原生執行，不需要 WSL。接著確認安裝：

muse --version

請只從 dev.meta.ai 安裝。第三方的「Muse Code 下載」網站都不是官方的。請參考如何安全下載 Muse Code 和 Windows 安裝教學。

來源: 官方文件

登入：瀏覽器或 API 金鑰

第一次在專案中執行 muse 時，它會要求你登入。有兩種方式：

• 瀏覽器登入：瀏覽器會開啟，你核准工作階段後回到終端機。
• API 金鑰：改為貼上 Meta API 金鑰。腳本和 CI 請將它匯出為環境變數：

export META_API_KEY="<your-key>"

你也可以用 muse auth set 儲存金鑰。環境變數優先於已儲存的金鑰，已儲存的金鑰又優先於瀏覽器工作階段。 Meta Managed Account（MMA）使用者必須使用 API 金鑰。登出請執行 muse logout。

要用哪個帳號？Muse Code 使用 Meta 帳號登入。訂閱 Muse Code 需要一個 Meta 帳號，加上與其關聯的 Meta Model API 帳號，而且方案只涵蓋 Muse Code。muse.ai 帳號也是同一類 Meta 帳號，但 Meta Muse 的消費者方案不包含 Muse Code， 需要另外訂閱。

不在美國嗎？Muse Code 的計費透過 Meta Model API 進行，Meta 表示該 API「在 Meta AI 可用且支援計費的大多數國家和地區皆可使用」 （支援的國家）。Meta 的地理使用政策列出了不提供服務的地區，其中包括中國（含香港和澳門）和俄羅斯。中國大陸讀者可參考我們實測過的替代做法 中国如何注册 Muse（含相關風險）。

來源: 官方文件

工作區信任提示與權限

第一次在某個資料夾啟動時，Muse Code 會請你信任該工作區。專案指示（例如 AGENTS.md）只會在受信任的工作區中載入。 之後預設會啟用兩層安全機制：

• 核准：安全的動作會自動執行；有風險的動作（例如具破壞性的 rm -rf）會等你決定。你可以選擇允許一次、在此工作區一律允許，或拒絕。
• 沙箱：shell 指令在作業系統沙箱中執行（macOS 為 Seatbelt，Linux 為 bubblewrap，Windows 為 Windows 沙箱），範圍限於你的工作區和暫存資料夾。.git、.muse 和 .agents 保持唯讀。

網路存取預設為 proxy-only（每個目的地都由你核准）；若要完全禁止，請使用 --sandbox-network restricted。--yolo 只能在隔離環境中使用。

來源: 官方文件

執行你的第一個任務

輸入任務並按 Enter。你不必等代理完成：按 Enter 可在進行中的回合加入指示，Alt+Enter 可排入下一個回合，Esc 則取消該回合。你可以把圖片貼到輸入框，並以 [Image #N] 引用；Alt+V 可切換語音聽寫（Windows 除外）。

來源: 官方文件

Muse Code 指令速查表

來源: 官方文件

專案規則：AGENTS.md（與 CLAUDE.md）

用以下指令建立專案指示檔：

muse init            # creates AGENTS.md
muse init --dry-run  # preview first

Muse Code 會從工作區根目錄往上到最近的 .git，尋找 AGENTS.md、CLAUDE.md、.agents/AGENTS.md 和 .claude/CLAUDE.md。所以如果你已經在用 Claude Code，現有的 CLAUDE.md 可以直接使用。 使用者設定存放在 ~/.config/muse/settings.json。

來源: 官方文件

選擇模型與推理強度

在工作階段中用 /models 切換模型，或在啟動時用 --model 指定。推理強度從 none 到 ultra（預設為 high），可用 /effort 或 --reasoning-effort 調整。強度越高，使用的輸出 token 越多，如果你按 token 付費就要特別注意 （查看 Muse Code 價格）。

來源: 官方文件

多代理：子代理與工作流程

主代理可以把範圍明確的任務交給子代理，也可以讓每個子代理在各自的 git worktree 中執行，避免平行修改互相衝突。 一個代理樹預設最多同時執行 8 個代理，可設定到 64 個。遇到較大的工作（平行稽核、比較不同做法、分階段遷移）時， Muse Code 可以執行工作流程：它會協調子代理，並回傳一份整合後的結果。小型且緊密相關的修改請留給主代理處理。

來源: 官方文件

復原錯誤的回合：倒回

執行 /rewind，或在輸入框為空時按兩次 Esc，選擇先前的訊息，Muse Code 就會從那裡開啟新的分支。原本的工作階段會保留下來。 倒回只會改變對話紀錄，不會還原工作區中的檔案，檔案請用 git 還原。

來源: 官方文件

在腳本與 CI 中執行 Muse Code

muse exec "run the tests and fix any failures" --json

無介面模式沒有 UI。成功時結束代碼為 0，失敗為 1，用法錯誤為 2。用 --max-model-steps 限制執行量， 並以 META_API_KEY 進行驗證。

來源: 官方文件

Windows 上的 Muse Code：有哪些不同

• 指令在 PowerShell 而不是 Bash 中執行。
• 沙箱第一次啟動時可能會要求系統管理員核准。
• Windows 上無法使用語音輸入和工作階段訊息功能。

來源: 官方文件

在 VS Code 中使用 Muse Code

官方文件沒有列出 VS Code 擴充功能。請開啟 VS Code 的整合式終端機，在那裡執行 muse。 任何「VS Code 版 Muse Code」擴充功能都應視為非官方。

開始前要知道的限制

• 方案以 5 小時為一個區間限制用量（Everyday Usage：每 5 小時 10-50 個提示詞）。用完額度後，你可以升級方案或等待額度重置。
• 便宜的 Contributor token 費率代表你允許 Meta 用你的提示詞和回應進行訓練，而且速率限制較低。
• Hooks 和 MCP 伺服器在沙箱和核准機制之外執行。

費用和方案請看 Muse Code 價格頁面。接下來可以閱讀我們的 Muse Code 評測，或比較 Muse Code vs Claude Code。