指南· 7 分鐘閱讀
Muse Code CLI 指令速查表：常用指令、旗標與快捷鍵
Muse Code 值得記住的指令一頁看完：安裝與登入、斜線指令、鍵盤快捷鍵、CI 用的 muse exec、核准模式與 --yolo、模型與推理強度、skills、MCP，以及設定檔放在哪裡。
Muse Code 是在終端機裡執行的程式，幾乎所有事情都靠 muse 這個指令完成。這一頁整理了 Meta 文件中（以 CLI 1.4.13 為準）的指令、旗標、斜線指令和快捷鍵。在工作階段中輸入 /help 可以看到你這個版本支援的完整清單，輸入 /keymap 則可查看快捷鍵。
安裝、登入與確認版本
| 指令 | 用途 |
|---|---|
curl -fsSL https://dev.meta.ai/install.sh | sh |
在 macOS 或 Linux 上安裝 |
irm https://dev.meta.ai/install.ps1 | iex |
在 Windows（PowerShell）上安裝 |
muse --version |
顯示已安裝的版本 |
muse |
在目前的資料夾啟動工作階段；第一次執行時會帶你登入 |
muse auth set |
儲存 API 金鑰，不用瀏覽器登入 |
/login |
在工作階段中重新開啟登入選項 |
muse logout |
清除已儲存的瀏覽器工作階段與金鑰 |
muse usage |
查看方案額度還剩多少 |
/upgrade |
開啟 Accounts Center 變更方案 |
Muse Code 會自動更新。更新、疑難排解與解除安裝的方法，請見我們的 安裝教學。
工作階段斜線指令
| 指令 | 用途 |
|---|---|
/help |
列出這個工作區可用的所有指令 |
/new |
開新的工作階段，保留終端機捲動紀錄 |
/clear |
開新的工作階段並清除捲動紀錄 |
/resume |
從這個工作區先前的工作階段中挑一個繼續 |
/resume --last |
繼續最近一次的工作階段 |
/name [name] |
顯示或設定工作階段名稱 |
/fork |
從最近的穩定點分支出新的工作階段 |
/rewind |
從你先前的某則訊息分支 |
/side [prompt] 或 /btw <prompt> |
開一段旁支對話，不打亂主線 |
/compact |
摘要先前的脈絡以騰出空間 |
/recap |
摘要最近的活動 |
/copy |
複製上一則回應 |
/export transcript |
將對話存成 .txt 檔案 |
/export trajectory |
將完整的工作階段記錄存成 JSON |
規劃、目標與 agent
| 指令 | 用途 |
|---|---|
/plan |
先提出計畫，等你核准後才開始實作 |
/grill |
對計畫反覆壓力測試，直到站得住腳 |
/goal <objective> |
設定 agent 要達成的目標；用 /goal pause、/goal resume、/goal edit、/goal clear 管理 |
/loop <cadence> <prompt> |
依間隔（10m）或 cron 運算式重複執行一則提示 |
/workflows |
開啟多 agent 工作流程的控制室 |
/subagents |
顯示執行中與已完成的 subagent |
/tasks |
開啟背景任務抽屜 |
/stop |
取消背景任務與終端機 |
/plan、/grill 和 /goal 如何搭配，請見 內建 skills 這篇。
模型與推理
| 指令或旗標 | 用途 |
|---|---|
/model <model-id> |
直接切換模型，例如 /model muse-wonder-1.0 |
/models |
開啟模型選單 |
/effort |
設定這個工作階段的推理強度 |
--model <id> |
啟動時指定模型 |
--reasoning-effort <level> |
none、minimal、low、medium、high（預設）、xhigh、max 或 ultra |
/settings |
設定，包括方案中的 Model → Contributor 模式 |
--contributor-mode on|off |
只對這次執行覆寫 Contributor 模式 |
推理 token 以輸出計費，所以 max 和 ultra 留給困難的問題就好。把推理強度設為 ultra 也可能自動啟動多 agent 工作流程。
鍵盤快捷鍵
| 按鍵 | 用途 |
|---|---|
agent 執行中按 Enter |
即時引導：把你的文字加進正在跑的這一輪 |
Alt+Enter |
把文字排進下一輪 |
Esc |
中斷目前這一輪 |
輸入框空白時按 Esc |
收回最後一則排隊中的指示 |
閒置時按 Esc Esc |
倒回（rewind） |
Ctrl+C |
中斷（輸入框空白時）或清除輸入內容 |
Alt+V（Mac 為 Option+V） |
開始或停止語音輸入（Windows 不支援） |
agent 問你釐清問題時，用數字鍵選擇選項，Space 切換複選，Tab 加上備註，Enter 送出。
無頭執行：muse exec
| 旗標 | 用途 |
|---|---|
muse exec "<prompt>" |
執行一項任務直到完成後結束 |
--json |
將 JSONL 事件輸出到 stdout |
--prompt-file <path> |
從檔案讀取提示 |
--max-model-steps <n> |
限制這次執行能做的工作量 |
--session-id <uuid> |
以非互動方式繼續先前的工作階段 |
--no-session-log |
不保留工作階段記錄 |
muse export --session <uuid> --out run.json |
匯出一個工作階段 |
結束代碼：0 代表這一輪完成，1 代表失敗或已取消（包括達到步數上限），2 代表用法錯誤，130/143 代表被中斷。0 不代表程式碼是對的——請跑你的測試。在 CI 中用 META_API_KEY 驗證身分，範例請見我們的 API 金鑰指南。
權限與沙盒
| 旗標 | 用途 |
|---|---|
--approval-mode on-request |
預設：有風險的 shell 指令會停下來等你審查 |
--approval-mode untrusted |
沒有允許規則的操作一律停下來審查 |
--approval-mode never |
不跳出核准提示；沙盒仍然有效 |
--approval-judge off |
每個核准決定都交給你，而不是內建的判斷器 |
--disable-approval |
略過核准，保留沙盒 |
--disable-sandbox |
保留核准，關閉沙盒 |
--yolo |
不核准、不用沙盒、直接信任工作區——只適合用完即丟的容器 |
--sandbox-network <mode> |
proxy-only（預設）、restricted 或 unrestricted |
--trust-workspace |
直接信任資料夾，略過第一次執行的確認提示 |
工作階段預設使用 Auto-review 設定檔，其他還有 Ask me、Read-only 和 Unrestricted。各自允許哪些操作，請見 文件。
Skills、MCP 與專案設定
| 指令 | 用途 |
|---|---|
muse init |
為專案寫一份 AGENTS.md（加 --dry-run 先預覽） |
muse skills list |
列出已安裝的 skills |
muse skills install ./my-skill --scope user |
安裝 skill |
muse skills import --from claude |
匯入 Claude Code 的 skills（Codex 用 --from codex） |
/migrate |
匯入 Claude Code 或 Codex 的記憶與 MCP 設定 |
/mcp |
顯示已連線的 MCP 伺服器與工具 |
muse mcp login <server> |
登入遠端 MCP 伺服器 |
muse config status |
顯示目前生效的設定 |
/theme |
切換終端機主題 |
檔案放在哪裡
- 設定：
~/.config/muse/settings.json——預設權限設定檔、MCP 伺服器、hooks、工作階段保留期限。 - 專案指示：
AGENTS.md；Muse Code 也會讀取CLAUDE.md、.agents/AGENTS.md和.claude/CLAUDE.md。 - 專案 skills 與記憶： 儲存庫中的
.agents/skills/和.agents/memory/。 - 專案 hooks：
.muse/hooks.json，只有在你信任該資料夾之後才會載入。
第一次用 Muse Code？先從 入門指南 開始，再把這頁開在分頁裡隨時查。