最后更新: 2026年9月28日

Muse Code 教程：从安装到跑通第一个任务

1. 安装命令行工具。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 key。脚本和 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 下载”站都不是官方的。使用时的网络环境请自行确认。

来源: 官方文档

登录：浏览器或 API key

第一次在项目里运行 muse 时，它会让你登录。有两种方式：

• 浏览器登录：自动打开浏览器，你确认会话后回到终端。
• API key：直接粘贴 Meta API key。脚本和 CI 里用环境变量：

export META_API_KEY="<your-key>"

也可以用 muse auth set 保存 key。优先级：环境变量 > 保存的 key > 浏览器会话。Meta Managed Account（MMA）用户只能用 API key。退出登录用 muse logout。

国内用户注意：Muse Code 按美元计费，订阅需要 Meta 账号加一个关联的 Meta Model API 账号。Meta 的地理使用政策（Geographic Use Policy）把中国（包括香港和澳门）列为不支持的地区，所以大陆用户没法直接订阅。可以参考本站的中国如何注册 Muse（含风险说明）。那篇讲的是 muse.ai（Meta 面向个人用户的 Muse，目前只在美国上线）：它和 Muse Code 用的是同一类 Meta 账号，但 Muse Code 要另外关联 Meta Model API 账号并单独订阅，Muse 个人版套餐不包含 Muse Code。

来源: 官方文档

工作区信任提示和权限

第一次在某个文件夹启动时，Muse Code 会让你信任这个工作区。项目说明（比如 AGENTS.md）只在受信任的工作区里加载。之后默认有两层防护：

• 审批：安全的操作自动执行；有风险的（比如破坏性的 rm -rf）会等你确认。你可以允许一次、在这个工作区一直允许，或拒绝。
• 沙箱：shell 命令在系统沙箱里执行（macOS 用 Seatbelt，Linux 用 bubblewrap，Windows 用 Windows sandbox），只能访问工作区和临时目录。.git、.muse 和 .agents 保持只读。

网络访问默认是 proxy-only（每个目标地址由你批准）；想完全断网用 --sandbox-network restricted。--yolo 只在隔离环境里用。

来源: 官方文档

跑第一个任务

输入任务，按 Enter。不用等 agent 跑完：按 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 越多，按量付费的话要注意（看 Muse Code 价格）。

来源: 官方文档

多 agent：子 agent 和 workflow

主 agent 可以把边界清晰的任务分给子 agent，可选每个子 agent 用独立的 git worktree，这样并行修改不会互相冲突。一棵 agent 树默认最多同时跑 8 个 agent，可配置到 64 个。更大的活（并行审计、对比多种方案、分阶段迁移），Muse Code 可以跑一个 workflow：编排多个子 agent，最后汇总成一个结果。小而耦合紧的改动还是留给主 agent。

来源: 官方文档

走错了？用回退

运行 /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 上有什么不一样

• 命令在 PowerShell 里执行，而不是 Bash。
• 第一次用沙箱时可能要管理员授权。
• Windows 上没有语音输入和会话消息功能。

来源: 官方文档

在 VS Code 里用 Muse Code

官方文档没有列出 VS Code 插件。打开 VS Code 的内置终端，在里面运行 muse 就行。任何“Muse Code for VS Code”插件都当作非官方处理。

开始之前要知道的限制

• 套餐按 5 小时窗口限量（Everyday Usage：每 5 小时 10-50 次提问）。用完了就升级或者等刷新。
• 便宜的 Contributor 按量档允许 Meta 用你的提示词和输出训练模型，而且速率限制更低。
• hooks 和 MCP 服务器在沙箱和审批之外运行。

费用和套餐见 Muse Code 价格页。接下来可以看 Muse Code 评测，或者 Muse Code 和 Claude Code 对比。