快速开始

mu 有两种用法：自带所需一切的桌面端，和 mu 命令行。两者共用账号、设置、会话和经验，在一边开始的任务可以到另一边接着做。

桌面端

1. 从 Releases 下载适合你系统的安装包，或者去首页，它会替你选好系统。

   系统	文件
   macOS，Apple 芯片	mu-<version>-mac-arm64.dmg
   macOS，Intel	mu-<version>-mac-x64.dmg
   Windows x64 / Arm	mu-<version>-win-x64.exe / mu-<version>-win-arm64.exe
   Linux x64 / Arm（Debian、Ubuntu）	mu-<version>-linux-amd64.deb / mu-<version>-linux-arm64.deb

   发布页上的 SHA256SUMS 列出每个文件的校验和。macOS 版已签名，并经过 Apple 公证。Windows 版还没有代码签名，所以第一次运行时 SmartScreen 会警告：选更多信息，再选仍要运行。

2. 打开它。新手引导分四步：模型、权限模式、判定器、开始。

   • 模型。 粘贴一个 API key，mu 会从格式认出是哪家服务（DeepSeek、Kimi、Qwen、GLM、SiliconFlow、OpenRouter、OpenAI、Anthropic、Google Gemini、xAI 等），并用一次请求检查它。也可以用 ChatGPT、Claude、Grok 或 Google 订阅登录。密钥不对、余额为零、地区不支持或连不上网，每一种都会说明该怎么办。
   • 权限。 默认选中「Jev 审批」；见权限与安全。
   • 判定器。 没有密钥时，由免费的 Jev 回答。之后随时可以回来改。
   • 开始。 如果 mu 找到 Claude Code 或 Codex 的对话，会提出帮你导入。

3. 选一个文件夹，开始对话。

其他什么都不用装：不用 Node.js，第一次启动也不下载任何东西。有新版本时，桌面端会告诉你版本号和大小，你同意后才下载，重启时安装。

命令行

npm i -g mu-agent      # Node.js 22.19 或更新
mu setup               # 接入一个模型，选择判定器
mu                     # 在当前目录开一个会话

mu setup 一步步问你，中文或英文都行。如果跳过它，第一次在没有模型的情况下运行 mu 时，会问一次要不要现在设置。写脚本时，mu setup --help 列出非交互的用法；密钥从标准输入读取，从不写在命令行上。

可以试试这些：

在会话里，/status 显示判定器、各判定点的模式和最近的判定，/help 列出所有命令。完整列表见命令行页。

你的第一个任务

打开一个项目文件夹，用你自己的话说要做什么。接下来会这样：

1. Jev 先读你的消息，显示一行判定，比如「多步任务 · 用重档」。用时远不到一秒；按 Esc 跳过。
2. 模型开始干活。 长工具输出先过滤再交给模型；在「Jev 审批」模式下，项目之外的命令要等批准。
3. 它说做完时，mu 检查有没有东西验证过这份工作，没有就提醒一次。

想让它一直做到某个条件成立，用目标模式：/goal all tests in packages/api pass。

判定器

mu 把一次会话里的例行问题交给一个小而快的判定器。你不需要专门设置：没有 Jev 密钥时，由 OpenCode Zen 上免费的 Jev 回答，mu 每天提示一次。要用自己的密钥、本地判定器或别的模型，见判定器。

每个判定点从一开始就按判定结果行事，每次判定都会记录下来：/status、mu ledger，或桌面端的「判定」页。想先观察判定器、再决定信不信它，就把判定点设成影子模式：照常提问并记录，但不改变任何东西。

{ "modes": { "default": "shadow" } }

这一行写在 ~/.mu/agent/mu.json 里；/mu mode default shadow 效果相同，但只对当前会话有效。

文件放在哪里

在 Windows 上，~ 是你的用户文件夹（%USERPROFILE%）。