## Windows {#windows}

适用于 Windows 10 和 Windows 11（64 位）。Agent J 运行在微软的 Linux 子系统（WSL2）里的 Ubuntu 上，安装命令会先把它装好，你不用提前准备。


### ① 自己装：一条命令 {#windows-self}

**什么时候选它：** Agent J 主机上还没有 AI 工具，或者你想自己动手。全程只用一个码：账户页空席位卡上的**安装码**（`AJI-` 开头）。

**预计时间：** 通常 15 到 30 分钟，大部分是在下载；第一次装 WSL 可能要重启一次。要你动手的部分加起来几分钟。

1. 在账户页 https://agentj.app/account/ 的空席位卡点「获取专属安装命令」，再点「复制安装命令」。在 Windows 上打开账户页，给的就是 PowerShell 那一条；不是的话点「换成 Windows（PowerShell）命令」。
2. 打开 PowerShell（开始菜单里搜 PowerShell，不用管理员身份），粘贴，回车。命令长这样：

   ```powershell
   $env:AGENTJ_CODE='AJI-…'; irm https://agentj.app/install.ps1 | iex
   ```
3. 照屏幕走。每一步开头都写着这是第几步、在做什么：

| 屏幕上 | 你要做的 |
|---|---|
| 安装码 | 命令里带了码就直接用；没带会让你粘贴一次（不显示） |
| WSL2 和 Ubuntu | 弹出管理员确认窗口时点同意；要重启就重启，重启后再粘贴同一条命令 |
| Ubuntu 用户 | 起个用户名（直接回车用默认的），设一个密码（输入时不显示，记住它） |
| 系统组件 | 不用做，Windows 上不问密码 |
| AI | 已经登录过 Claude Code 或 Codex 就直接用。没有就选一条路：连不上官方服务选 Agents Relay 中转（见[香港和中国大陆](/docs/install/#hk-cn)），能连就在浏览器里登录官方账号 |
| Agent J | 不用做：装好、启动后台服务、用同一个码绑定这个席位 |
| 手机 | 屏幕上出现二维码：用**你自己的手机**打开 https://m.agentj.app ，点「扫二维码」扫它 |
| 接上 AI | 不用做：AI 先真实回复一次才接上 |
| 永不休眠 | 显示要你自己在 PowerShell 里做的 Windows 电源设置；Ubuntu 里不改任何东西（[详细说明](/docs/keep-awake/#windows)） |

> **多一个选项**：AI 那一步的菜单里还有第 6 项「用 OpenCode 自带的免费模型先跑起来」：不登录、不填 key，先用起来；对话和代码会发给 OpenCode 和它的模型供应商。它优先选不拿对话训练的免费模型；免费模型有限流、随时可能下线，敏感工作请之后换成自己的模型（手机「模型与 Key」）。其他选项和默认推荐都不变。

4. 看到「✅ 全部完成」，就在手机上跟它打个招呼。以后要在Agent J 主机上用 `agentj`，从开始菜单打开「Ubuntu」，不是 PowerShell。

出了问题：

- 中途哪一步失败，屏幕上会写一行「怎么办：…」。修好后**粘贴同一条命令**，做完的步骤会跳过。
- 安装码只能用一次，24 小时内有效（卡片上写着到期时间）。
- 已经装好、只差 AI，或旧版升不上去：在「Ubuntu」里再运行一次 `curl -fsSL https://agentj.app/install.sh | bash`（不用带码）。它先看版本：旧版会直接从 agentj.app 下载签名安装包修复升级（不用旧版的 `agentj update`，不连 GitHub；席位、配对和设置都保留），再只补接 AI 这一步。
- 确认 systemd 已开启：后台服务靠它运行。在「Ubuntu」里运行 `ps -p 1 -o comm=`，应该显示 `systemd`。不是的话，在「Ubuntu」里运行 `printf '[boot]\nsystemd=true\n' | sudo tee -a /etc/wsl.conf`（文件里 `[boot]` 下已经有 `systemd=true` 就跳过），再在 PowerShell 里运行 `wsl --shutdown`，重新打开「Ubuntu」后运行 `agentj service install`。安装命令会自己做这两步；`agentj service install` 和升级遇到没开 systemd 时，也会用一句话告诉你这两步。


### ② 请人帮你装：在旁边或远程 {#windows-helper}

**什么时候选它：** 你不熟悉Agent J 主机或终端，有家人、朋友或同事能坐在旁边，或者通过视频通话、屏幕共享帮你。

现在的做法：

1. 帮手照①带着你做。码只在**你自己的**账户页复制，只粘在你自己的Agent J 主机上；远程帮的时候你共享屏幕、帮手口头指挥，码和 key 不要发进聊天。
2. 中途会弹出 Windows 的管理员确认窗口，可能还要重启一次。帮手提前跟你说一声，你就不会慌。
3. 扫二维码配手机，用**你自己的手机**。如果扫的是帮手的手机，它就成了这台Agent J 主机的遥控器：装完以后运行 `agentj devices` 找到它的设备号，再运行 `agentj revoke <设备号>` 把它移走。
4. 当时手机不在手边，或者扫码那一步没配上，不用重装：装好以后在账户页这台Agent J 主机的席位卡上点「添加遥控器」，用通行密钥确认，再用你的手机扫码。

> **提示**：一键帮手配对计划在后续版本推出：帮手用自己的手机临时连上，在手机上带你装完；你的手机配好、AI 接上以后，帮手自动断开。

### ③ 让Agent J 主机上的 AI 帮你装 {#windows-ai}

**什么时候选它：** 你已经在 WSL 的 Ubuntu 里用 Claude Code、Codex 或 OpenCode，想让它替你操作、边装边解释。Windows 上 Agent J 只能装在 WSL2 里，装在 Windows 本身的 AI 会停下来告诉你；还没有 WSL 的话，选①更省事。

1. 已经买了席位：在账户页空席位卡上点「复制安装提示词」，发给 Ubuntu 里的 AI。
2. 还没买：把下面这句话原样发给它，它会带你注册账号、买席位：

```text
请用 curl 把 https://agentj.app/install.md 下载到本地，用读文件的工具完整读完，然后一步一步照着做，每一步开始前重读那一节。需要我动手的时候告诉我。
```

AI 每一步做什么、哪几步会停下来叫你，见[让 AI 装的时候](/docs/install/#ai-steps)。


### ④ 远程安装助手（云端） {#windows-assistant}

**什么时候选它：** 身边没人帮忙，Agent J 主机上也没有 AI，装到一半卡住了想问人。

现在这样用：

1. 照①的命令装。这条命令本身就是安装助手：每一步在做什么都写在屏幕上，出错时会写一行「怎么办：…」。照着修好，再粘贴同一条命令接着装。
2. 还是弄不明白，而 Agent J 已经装上了：在「Ubuntu」里运行下面这条命令。它把你的问题和去掉了密钥的体检结果发给我们服务器上的客服，一般几分钟内回你具体步骤。

```bash
agentj support ask "<你的问题>" --attach-doctor
```

3. 还没装上，或者连不上我们：发邮件到 feedback@agentj.app，写清卡在哪一步、报错原文，附上截图（先遮住安装码、key 和二维码）。

> **提示**：后续版本计划让云端助手直接在你的手机上给出下一步建议，你点了才执行。


[完整安装说明](/docs/install/#windows)
