Muse Code 下载与安装教程：macOS、Linux 和 Windows

所谓“下载”，就是一条命令

很多人搜索 Muse Code 下载时，期待的是一个 .dmg、一个 .exe，或者一个应用商店页面。这些都没有。Muse Code 是一个命令行程序，官方获取方式就是 Meta 的安装脚本。在 macOS 和 Linux 上：

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

在 Windows 上，打开 PowerShell：

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

两个脚本都会把一个 muse 二进制放进你的 PATH；用 muse --version 确认安装成功。如果你不想把远程脚本直接管道进 shell，可以先把它下载下来（例如 curl -fsSL https://dev.meta.ai/install.sh -o install.sh），读一遍，再运行。在每个受支持的平台上，“下载”这件事就这么多——变的只是你在哪里运行它。

macOS 和 Linux

在 Mac 或 Linux 机器上，打开终端，运行上面那条 curl 命令。开始第一次会话之前，有两件事值得知道：

如果安装后找不到 muse，新开一个终端窗口，让 shell 重新读取 PATH。
第一次运行会让你登录。 在项目目录里运行 muse，它会打开浏览器，让你用 Meta 开发者账号在 dev.meta.ai 完成认证。凭证会被缓存，所以不必每次会话都重来一遍。在服务器、CI runner 和其他无界面机器上，可以跳过浏览器：在 Model API 控制台创建一个密钥，然后把它导出为 META_API_KEY，或者用 muse auth set 保存一次就好。

之后，cd 进一个 git 仓库，运行 muse 即可。我们的上手指南推荐了一个适合当作首个任务的练手题。

Windows：原生 PowerShell 安装脚本

本文首次发布时，Muse Code 还没有原生 Windows 版本，WSL2 是唯一的路。现在情况变了：Meta 的文档里已经列出了原生 Windows 安装脚本。Meta 没有公布它是哪天上线的（2026 年 9 月 22 日已有第三方教程在介绍它），但它就是如今的官方途径。

打开 PowerShell，运行：

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

然后新开一个 PowerShell 窗口，用 muse --version 检查一下，再到某个 git 仓库里运行 muse。不过，Windows 上的 Muse Code 和其他平台并不完全一样——Meta 列出了这几处差异：

用 PowerShell，不用 Bash。 agent 在 PowerShell 里执行命令，所以它为你的项目写的脚本和单行命令都会是 PowerShell 语法，而不是 Bash。
首次初始化沙箱时会弹出 UAC 提示。 沙箱第一次初始化时，Windows 可能会请求权限。这是正常现象。
没有语音输入。 Windows 上不支持语音。
没有会话间消息。 在 Windows 上，会话之间无法互发消息；这项功能只支持 macOS 和 Linux。

Windows 的另一条路：什么时候该选 WSL2

WSL2 依然可用——它本身就是 Linux，所以 Muse Code 在里面的表现和在 Linux 机器上完全一致。如果你项目的工具链默认依赖 Bash、团队的脚本是为 Linux 写的，或者你需要会话间消息，那就优先选它。适用于 Linux 的 Windows 子系统（WSL）能在 Windows 10 或 11 上提供一个真正的 Linux 环境：

以管理员身份打开 PowerShell，运行 wsl --install。默认会安装 WSL2 和 Ubuntu。按提示重启。
从开始菜单启动 Ubuntu，创建你的 Linux 用户。
确认基础工具都已就位：sudo apt update && sudo apt install -y curl git。
在 Ubuntu 终端里运行 macOS/Linux 的安装脚本——就是上面那行 curl … | sh，不是 PowerShell 那条。
把仓库放在 Linux 文件系统里，比如 ~/code，而不是放在 /mnt/c 下面。Muse Code 会大量读写文件，而跨越 Windows 与 Linux 边界的访问要慢得多。

如果在 WSL 里弹不出浏览器登录，就改用 API 密钥：在 Model API 控制台创建一个，然后在 Linux shell 的配置文件里设置 META_API_KEY，或者用 muse auth set 把它存起来。

VS Code、JetBrains，以及“桌面应用”问题

Meta 至今仍没有为 Muse Code 推出桌面应用、IDE，也没有官方的编辑器扩展。但这并不意味着你得放弃自己的编辑器：

VS Code： 在集成终端里运行 muse。用原生安装脚本的话，在 Windows 的 PowerShell 终端里直接就能用。只有选了 WSL2，才需要安装 Microsoft 的 WSL 扩展：在 WSL 中打开项目文件夹，集成终端就会变成一个 Linux shell，Muse Code 在里面照常工作。
Zed 和 JetBrains IDE： 有社区项目把 Muse Code 接入支持 Agent Client Protocol（ACP）的编辑器。它们都是非官方的——在让它们接触私有代码之前，先弄清楚它们把什么数据发到了哪里。

对任何打着“Muse Code 桌面应用”或独立“Muse Code for Windows”下载旗号的东西都要保持警惕。这些都不是 Meta 发布的；上面那两个安装脚本是唯一的官方分发渠道。（微软在 10 月 7 日宣布，Meta 的消费级 Muse agent 将以原生应用的形式登陆 Windows——那是 Muse，不是 Muse Code。）

更新 Muse Code

通常你什么都不用做：Muse Code 会自己更新。安装脚本会装上一个小小的启动器，由它负责让真正的二进制保持最新；从 CLI 1.4.11 起，自动更新落地时还开着的会话，也能带着历史记录接着往下走。想知道自己用的是哪个版本，运行 muse --version，再对照我们的更新日志——当前这一系列的改动见 1.4 版本说明。如果想马上用上最新版本，把同一条安装命令重新运行一遍就行，它会直接覆盖现有的版本。

也没有什么包管理器渠道需要同步。Meta 没有为这个 CLI 发布 Homebrew formula、npm 包或 winget 包——npm 上的 @muse-code/sdk 是用来构建你自己 agent 的 SDK，并不是 Muse Code 本身。

常见安装问题排查

安装后提示 muse: command not found。 新开一个终端，让 shell 重新读取 PATH。在 macOS 和 Linux 上，安装脚本会把 ~/.local/bin 写进你的 shell 配置文件；如果你用的是比较小众的 shell，就自己把这个目录加进 PATH。
在 Linux 上所有 shell 命令都失败。 Linux 沙箱依赖一个内置的 bubblewrap 辅助程序。如果它没法正常工作——包括 Alpine 这类基于 musl、本身就不带它的发行版——Muse Code 宁可拒绝执行 shell 命令，也不会在没有沙箱的情况下运行它们。请改用基于 glibc 的发行版或容器。
Windows 首次运行时弹出权限提示。 Windows 沙箱第一次初始化时，可能会请求管理员授权（UAC）。之后就不需要再以管理员身份运行 Muse Code 了。
公司代理和受限网络。 先用 -o install.sh 把脚本下载下来，看清楚它会连接哪些主机，再请网络团队放行这些主机。

卸载 Muse Code

Meta 的文档里没有卸载命令，所以只能手动删除。在 macOS 和 Linux 上，安装脚本会把 muse 启动器和带版本号的 muse-bin-* 文件放在 ~/.local/bin 里；把它们删掉即可，如果连设置也不想留，再删除 ~/.config/muse/。在 Windows 上，先在 PowerShell 里运行 Get-Command muse 找到二进制所在的位置，再把它删除。有两件事卸载是不会替你做的：它不会取消订阅——这要到 Meta 的 Accounts Center 里的“订阅”（Subscriptions）中操作；它也不会删除 Muse Code 写进你仓库里的项目文件，比如 AGENTS.md、.agents/ 和 .muse/。

然后决定怎么付费

安装免费，使用 Muse Code 则不免费。你可以订阅月度套餐——Everyday Usage（$5）、High Usage（$15）、Power Usage（$50）或 Maximum Usage（$200）——也可以不订套餐，通过 Meta Model API 按 token 付费。定价页对两种方式做了比较，还附带一个费用估算器。