非官方指南，与 Meta 无关联。
MuseAICode
简体中文

最后更新:

Muse Code Windows 安装：原生支持，不用 WSL2

一句话Muse Code 原生支持 Windows。打开 PowerShell，执行 irm https://dev.meta.ai/install.ps1 | iex 就装好了，不需要 WSL2、Linux 虚拟机或桌面客户端。Windows 上只少了语音输入和会话消息两个功能。

要不要装 WSL2？不用

网上不少教程还在说"没有 Windows 安装包，先装 WSL2"，这个说法已经过时了。官方文档现在有 PowerShell 安装命令， "Platform support"一节明确写着 Muse Code 在 macOS、Linux 和 Windows 上用同一套代码运行，全文没有提到 WSL。

如果你本来就在 WSL 里干活，也可以在 WSL 里装 Linux 版。这是个人习惯，不是必须。

5 步在 Windows 上装好 Muse Code

  1. 打开 PowerShell：用普通用户身份打开 Windows PowerShell 或 Windows Terminal，不需要"以管理员身份运行"。
  2. 运行官方安装命令：执行：irm https://dev.meta.ai/install.ps1 | iex。它会把原生的 muse 程序装到系统路径里。
  3. 检查是否装好：新开一个 PowerShell 窗口，执行：muse --version。
  4. 在项目里启动：cd 进项目目录，运行 muse。选择信任这个工作区，然后用浏览器登录或 API key 登录。
  5. 首次沙箱授权：沙箱第一次启动时，Windows 可能弹出用户账户控制（UAC）提示，点允许即可。日常使用不需要管理员权限。
irm https://dev.meta.ai/install.ps1 | iex
muse --version

只从 dev.meta.ai 安装。官方没有 exe、msi 安装包，也没有桌面客户端。详见 Muse Code 怎么安全下载。

来源: 官方文档：安装与平台支持

Windows 上有什么不一样

方面Windows 上
命令行agent 执行的命令用 PowerShell 语法和 Windows 命令行工具，不是 Bash
沙箱第一次启动可能弹 UAC 提示；日常使用不需要管理员权限
语音输入不可用
会话消息不可用（macOS 和 Linux 支持）
其他命令行工具、模型、套餐和命令都和 macOS、Linux 一样

因为命令在 PowerShell 里跑，如果项目说明（AGENTS.md）或脚本默认用 Bash，要留意这一点。

在 VS Code 里用

官方没有 VS Code 扩展。打开内置终端（默认是 PowerShell），cd 进代码仓库，运行 muse 即可，上面的步骤完全适用。

接下来

常见问题

Muse Code 支持 Windows 吗？

支持。Meta 官方文档写的是 Muse Code 在 macOS、Linux 和 Windows 上"用同一套代码运行"。Windows 上用 PowerShell 执行 irm https://dev.meta.ai/install.ps1 | iex 安装。

要先装 WSL2 吗？

不用。官方安装命令会装一个原生的 Windows 程序，官方文档里也完全没提 WSL。让你先装 WSL2 的教程，写的是旧情况。

还能在 WSL 里用吗？

可以。如果你习惯 Linux 环境，在 WSL 里执行 macOS/Linux 的安装命令（curl -fsSL https://dev.meta.ai/install.sh | sh）即可，和普通 Linux 一样。这是可选项，不是必须。

为什么会弹管理员权限提示？

沙箱第一次初始化时，Windows 可能弹出用户账户控制（UAC）提示。Meta 文档说明日常使用不需要以管理员身份运行。

Windows 上有哪些功能用不了？

语音输入和会话消息（session messaging）在 Windows 上不可用。agent 执行的命令用 PowerShell 语法，不是 Bash。

有 Muse Code 的 Windows 客户端或 exe 安装包吗？

没有。Muse Code 是命令行工具，只能用上面的 PowerShell 命令安装。提供"Muse Code Windows 版 exe"或桌面客户端下载的网站都不是官方的。

能在 VS Code 里用吗？

能，在 VS Code 的内置终端（PowerShell）里运行 muse 就行。官方文档没有列出 VS Code 扩展。