如何在 macOS、Linux 和 Windows（WSL2）上安装 Muse Code

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

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

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

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

macOS 和 Linux

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

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

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

Windows：装在 WSL2 里

Muse Code 没有原生 Windows 版本。Meta 的安装脚本面向的是 macOS 和 Linux，有开发者反馈，在 PowerShell 里运行它会直接拒绝执行。可行的路线是适用于 Linux 的 Windows 子系统（WSL），它能在 Windows 10 或 11 上提供一个真正的 Linux 环境：

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

如果在 WSL 里弹不出浏览器登录，就改用 API 密钥：在 Model API 控制台创建一个，并在 Linux shell 的配置文件里设置 MODEL_API_KEY。

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

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

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

对任何打着“Muse Code 桌面应用”或“Muse Code for Windows”旗号的下载都要保持警惕。这些都不是 Meta 发布的；上面那个安装脚本是唯一的官方分发渠道。

保持最新

Meta 的文档里只有安装脚本，别的什么都没有，所以请用 muse --help 查看你这个版本支持哪些命令，并关注我们的更新日志获取版本发布信息。Muse Code 于 2026 年 8 月 31 日结束 beta，两天后切换到了 Muse Spark 1.3 模型——安装保持最新，两样就都有了。

然后决定怎么付费

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