信息核对 2026.11

首页 / 阶段二 / Muse Code

Muse Code：Meta 的终端 agent

Meta 做的编码 agent，命令叫 muse，原生二进制，跑在终端和 CI 里。它跟 Codex、Claude Code 是同一类东西，但有两个别的工具没有的特点：强度档位可调，以及能被 OpenClaw 当作执行后端接管。

命令行 需境外网络 需 Meta 账号 原生二进制

01先确认：你要的是不是这个 Muse

「Muse」这个名字在 AI 圈里被好几个产品用过，搜出来的结果会很混乱。本站指的是 Meta 的 Muse Code，判断特征有三条，全中就是它：

  • 安装域名是 dev.meta.ai；
  • 命令名是 muse，而不是别的名字；
  • 登录用的是 Meta 账号，浏览器会跳到 Meta 的页面。

如果你要找的是一款手机 App、或者名字拼成 Muze 的工具，那不是这个东西——错一个字母就是另一个产品。

02安装

macOS / Linux / WSL：官方脚本（最通用）

Terminal从 dev.meta.ai 拉安装脚本
curl -fsSL https://dev.meta.ai/install.sh | sh

macOS：Homebrew

macOS Terminal装的是 cask
brew install --cask muse-code

Windows

官方说明里 muse 是支持 Windows 的原生二进制，但公开的安装脚本是 .sh 格式。所以 Windows 上有两条路：

  1. 官网下载安装包：去 dev.meta.ai 找 Windows 版下载入口，这是最省事的。
  2. 在 WSL 里装：wsl 进 Linux 环境，再跑上面那条 install.sh。适合你本来就打算用 WSL 做项目的情况。

如果官网找不到 Windows 安装入口，就先用 WSL。不要自己拼一条 install.ps1 之类的地址——这类脚本路径一旦猜错，拿到的是 404 页面，执行起来还会报奇怪的语法错误。

验证

任意系统打印出版本号就成功
muse --version

03第一次启动：信任与登录

  1. 先 cd 进项目目录，再运行 muse。和 Codex、Claude Code 一样，它把当前目录当作工作范围。
  2. 首次启动它会问：是否信任这个工作区。这一步是在确认「你允许它在这个目录里读写」。只在你确实要让它干活的目录里点同意；在一个大目录（比如整个 D 盘）里点了同意，它就有权限在那儿乱动。
  3. 然后是登录：浏览器会打开 Meta 的授权页，登录你的 Meta 账号并批准。也可以选择粘贴 API Key 的方式。
  4. 单独的登录命令是 muse login，配置出问题时可以先跑它重新认证。

04它最有特点的功能：effort 档位

Muse Code 让你显式选择「这次要用多少算力」。共六档，默认是 High：

档位适合什么任务代价
Minimal / Low改文案、重命名、跑一条命令、回答「这个函数干嘛的」最省额度，复杂任务容易做浅
Medium单文件的小改动、简单的 bug 修复平衡
High（默认）大多数日常任务官方默认，一般不用动
Extra high / Ultra跨多文件的改造、要它自己反复试错验证的难题最费额度，也最慢

实用建议：日常别拉到 Ultra。真正的浪费不是「用了高档位」，而是用 Ultra 去改一个错别字。反过来，一个跨十个文件的重构，用 Low 只会得到一份看起来很敷衍的方案。

05基本用法

标准流程注意 muse init 的位置
# 1. 进项目
cd ~/projects/my-site

# 2. 先给项目写一份「规矩」，让它每次都读
muse init

# 3. 启动会话
muse

muse init 会在项目里写一个指令文件（相当于给 agent 的项目说明书）。生成之后你应该手动改一遍：自动生成的通常只有骨架，把项目实际的技术栈、不能碰的目录、验收命令补进去，效果差好几倍。

场景做法
只想问不想改明确说「只读分析，不要写文件」。
任务很大先要方案：「先列出你打算改哪些文件、每处改什么，等我确认」。确认后再让它动手。
任务很简单把 effort 调低，省时间也省额度。
在 CI 里跑它是原生二进制，可以直接在流水线里调用，不需要先装 Node。
想换个名字的命令另有一个 npm 包 muser-cli，命令是 muser，登录后要在 Meta 设置 › Devices 里把电脑注册成设备。功能定位重叠，选一个用就行，别两个都装。

06进阶：接进 OpenClaw 当执行后端

这是 Muse Code 和其它终端 agent 不一样的地方——它可以被 OpenClaw 接管，变成「你在微信/Telegram 里发一句话，OpenClaw 转给 Muse Code 去执行」。配置路径（以 OpenClaw 的 Control UI 为准）：

  1. 打开 OpenClaw 的 Control UI，进 Models 页。
  2. 在 AI Setup 里选 Connect provider，再选 Meta → Muse Code。
  3. 开始登录：浏览器里会出现一个设备码，确认并批准。
  4. 它会问是否沿用 Muse Code 的原生权限设置，确认后完成。
  5. OpenClaw 会自动启用 Muse 插件并把模型/运行时切过去。

没装 OpenClaw 的话，这一节可以跳过。等你走到 阶段三 再回来看。

07三个实战

实战一：给它一个「可验证的终点」

「跑 npm test，把失败的用例修到全绿。每修一个先说明原因。不许改测试文件本身。」 最后那句是防线——不改测试，它就没法靠「把测试删掉」来作弊。

实战二：跨文件重构，用高档位

「把项目里所有用 var 声明的变量改成 let/const：能确定不重新赋值的用 const，否则 let。改完列出每个文件的改动数量。不确定的不要动，单独列出来给我。」 这种任务把 effort 提到 Extra high 是合理的。

实战三：写一个给非程序员用的脚本

「写一个 Windows 批处理或 PowerShell 脚本：双击后自动把指定文件夹里的视频按日期重命名并归档。脚本里每一步都要输出中文提示，出错要停下来别继续。」 你要的是「能给家人用」的脚本，所以要强调提示语和容错。

08踩坑与排错

现象原因与处理
muse 命令找不到安装目录不在 PATH。重开终端；仍不行就查官方文档给的默认安装路径。
启动时反复问信任工作区每次换目录都会问一次。这是设计如此，不是 bug。
登录后仍提示未认证先跑 muse login 重新认证；检查浏览器是否拦了弹窗。
额度掉得很快检查 effort 是不是留在 Ultra；检查是不是让它做了大量只读探索。
它改得比预期激进降低 effort，并在指令里限定「只改 X 目录」。
Windows 上装了但跑不起来确认是官网下载的原生包，还是 WSL 里装的；两者 PATH 互相独立，容易混。

09边界

  • 它面向代码与命令行任务，不做办公文档排版（那用 WorkBuddy）。
  • 它需要 Meta 账号，账号体系与 OpenAI、Anthropic 完全不通用，这是选它之前要想清楚的成本。
  • effort 只是「想多深」，不等于「一定对」。验收永远在人这边。

上一课

05 · Claude Code

官方安装入口：dev.meta.ai（安装脚本 https://dev.meta.ai/install.sh）
OpenClaw 侧的接入说明：docs.openclaw.ai/plugins/muse
本页关于 Windows 安装方式的表述基于官方声明「原生二进制支持 Windows」与公开脚本只有 .sh 这一事实，具体安装包入口请以官网当前页面为准。