指南· 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 Key，不走浏览器登录 |
/login |
在会话内重新打开登录选项 |
muse logout |
清除已存储的浏览器会话和 Key |
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 |
向 stdout 输出 JSONL 事件 |
--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 Key 指南。
权限与沙箱
| 参数 | 作用 |
|---|---|
--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？先看 入门指南，再把这页放在一个标签页里随时查。