跳到正文Skip to content
Agent J Beta
菜单Menu
中文EN
登录Sign in

搜索文档和页面Search docs and pages

Windows

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

① 自己装:一条命令

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

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

  1. 在账户页 https://agentj.app/account/ 的空席位卡点「获取专属安装命令」,再点「复制安装命令」。在 Windows 上打开账户页,给的就是 PowerShell 那一条;不是的话点「换成 Windows(PowerShell)命令」。
  2. 打开 PowerShell(开始菜单里搜 PowerShell,不用管理员身份),粘贴,回车。命令长这样:
    $env:AGENTJ_CODE='AJI-…'; irm https://agentj.app/install.ps1 | iex
  3. 照屏幕走。每一步开头都写着这是第几步、在做什么:
屏幕上你要做的
安装码命令里带了码就直接用;没带会让你粘贴一次(不显示)
WSL2 和 Ubuntu弹出管理员确认窗口时点同意;要重启就重启,重启后再粘贴同一条命令
Ubuntu 用户起个用户名(直接回车用默认的),设一个密码(输入时不显示,记住它)
系统组件不用做,Windows 上不问密码
AI已经登录过 Claude Code 或 Codex 就直接用。没有就选一条路:连不上官方服务选 Agents Relay 中转(见香港和中国大陆),能连就在浏览器里登录官方账号
Agent J不用做:装好、启动后台服务、用同一个码绑定这个席位
手机屏幕上出现二维码:用你自己的手机打开 https://m.agentj.app ,点「扫二维码」扫它
接上 AI不用做:AI 先真实回复一次才接上
永不休眠显示要你自己在 PowerShell 里做的 Windows 电源设置;Ubuntu 里不改任何东西(详细说明)

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

  1. 看到「✅ 全部完成」,就在手机上跟它打个招呼。以后要在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 时,也会用一句话告诉你这两步。

② 请人帮你装:在旁边或远程

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

现在的做法:

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

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

③ 让Agent J 主机上的 AI 帮你装

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

  1. 已经买了席位:在账户页空席位卡上点「复制安装提示词」,发给 Ubuntu 里的 AI。
  2. 还没买:把下面这句话原样发给它,它会带你注册账号、买席位:
请用 curl 把 https://agentj.app/install.md 下载到本地,用读文件的工具完整读完,然后一步一步照着做,每一步开始前重读那一节。需要我动手的时候告诉我。

AI 每一步做什么、哪几步会停下来叫你,见让 AI 装的时候。

④ 远程安装助手(云端)

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

现在这样用:

  1. 照①的命令装。这条命令本身就是安装助手:每一步在做什么都写在屏幕上,出错时会写一行「怎么办:…」。照着修好,再粘贴同一条命令接着装。
  2. 还是弄不明白,而 Agent J 已经装上了:在「Ubuntu」里运行下面这条命令。它把你的问题和去掉了密钥的体检结果发给我们服务器上的客服,一般几分钟内回你具体步骤。
agentj support ask "<你的问题>" --attach-doctor
  1. 还没装上,或者连不上我们:发邮件到 feedback@agentj.app,写清卡在哪一步、报错原文,附上截图(先遮住安装码、key 和二维码)。

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

完整安装说明

Windows

For Windows 10 and Windows 11 (64-bit). Agent J runs in Ubuntu inside Microsoft's Linux subsystem (WSL2); the install command sets that up first, so there is nothing to prepare.

① Install it yourself: one command

When to choose it: the Agent J host has no AI tool yet, or you would rather do it yourself. You need one code from start to finish: the installation code (it starts with AJI-) on an empty seat card in your account.

Time: usually 15 to 30 minutes, mostly downloading; the first WSL install may need one restart. The parts that need you add up to a few minutes.

  1. On https://agentj.app/account/ press "Get installation command" on the empty seat card, then "Copy installation command". Opened on Windows, the page gives you the PowerShell line; if not, press "Windows (PowerShell) command".
  2. Open PowerShell (search Start for PowerShell; no administrator needed), paste and press Enter. The command looks like
    $env:AGENTJ_CODE='AJI-…'; irm https://agentj.app/install.ps1 | iex
  3. Follow the screen. Every step starts with its number and what it is doing:
On screenWhat you do
Installation codeTaken from the command; if it is missing you paste it once (hidden)
WSL2 and UbuntuAllow the Windows administrator prompt; restart if asked, then paste the same command again
Ubuntu userPick a user name (Enter takes the suggestion) and a password (hidden; remember it)
System partsNothing; Windows does not ask for a password
AIReuses Claude Code or Codex if you are signed in. Otherwise pick a route: if the official services are unreachable choose the Agents Relay route (see Hong Kong and mainland China); if they work, sign in with your own account in the browser
Agent JNothing: it installs, starts the background service and links this seat with the same code
PhoneA QR code appears: open https://m.agentj.app on your own phone, tap "Scan QR code" and scan it
Connect the AINothing: the AI must answer one real request before it is connected
Keep it awakeShows the Windows power steps to do in PowerShell yourself; nothing changes inside Ubuntu (details)

One more option: the AI step's menu also has item 6, 「用 OpenCode 自带的免费模型先跑起来」 (start now with OpenCode's own free model): no sign-in, no key, ready at once; your conversations and code go to OpenCode and its model provider. It prefers free models whose provider does not train on your conversations; free models are rate-limited and can disappear, so switch to a model of your own for sensitive work later (Models & Key on the phone). The other choices and the recommended default are unchanged.

  1. When you see "✅ 全部完成" (all done), say hello to it from your phone. To use agentj on the Agent J host later, open "Ubuntu" from the Start menu, not PowerShell.

If something goes wrong:

  • If a step fails, the screen says what to do. Fix it and paste the same command again; finished steps are skipped.
  • The installation code works once and expires after 24 hours (the card shows the time).
  • Already installed, but the AI is missing or an old version will not upgrade? In "Ubuntu" run curl -fsSL https://agentj.app/install.sh | bash again (no code). It checks the version first: an older Agent J is repaired forward with the signed package from agentj.app (not the old agentj update, no GitHub; seat, pairing and settings stay), then only the AI step runs.
  • Confirm systemd is on: the background service runs on it. In "Ubuntu" run ps -p 1 -o comm=; it should print systemd. If not, in "Ubuntu" run printf '[boot]\nsystemd=true\n' | sudo tee -a /etc/wsl.conf (skip it when the file already has systemd=true under [boot]), then in PowerShell run wsl --shutdown, reopen "Ubuntu" and run agentj service install. The install command does both steps itself; agentj service install and upgrades also name these two steps in one sentence when systemd is off.

② Get someone to help: beside you or remotely

When to choose it: you are not at home with computers or terminals, and a family member, friend or colleague can sit with you or help over a video call or screen sharing.

What to do today:

  1. The helper walks you through ①. The code is copied only from your own account page and pasted only on your own computer; when helping remotely, you share your screen and the helper tells you what to do. Never put the code or a key into a chat.
  2. A Windows administrator prompt appears along the way, and there may be one restart. A helper who warns you in advance saves you a fright.
  3. Scan the pairing QR code with your own phone. If the helper's phone scans it, that phone becomes a remote for the Agent J host: afterwards run agentj devices to find its device ID, then agentj revoke <device-id> to remove it.
  4. Phone not at hand, or the scan did not work? No need to reinstall: once it is installed, press "Add a remote" on the Agent J host's seat card in your account, confirm with your passkey, and scan with your phone.

Tip: One-step helper pairing arrives in a later planned release: the helper connects their own phone for a while and guides you through the install from it; once your phone is paired and the AI is connected, the helper is disconnected automatically.

③ Let the AI on the Agent J host install it

When to choose it: you already use Claude Code, Codex or OpenCode inside Ubuntu on WSL and want it to do the work and explain as it goes. On Windows Agent J installs only inside WSL2, and an AI running on Windows itself stops and tells you so; without WSL yet, ① is simpler.

  1. Already bought a seat: press "Copy installation prompt" on the empty seat card in your account and send it to the AI in Ubuntu.
  2. Not yet: send it this sentence exactly as written, and it walks you through opening an account and buying a seat:
Please download https://agentj.app/install.md with curl, read the whole file with your file-reading tool, then follow it step by step, re-reading each section before you do it. Tell me when you need me to do something.

What the AI does at each step, and where it stops for you: When the AI installs it.

④ Remote installation assistant (cloud)

When to choose it: nobody is around to help, there is no AI on the Agent J host, and you are stuck halfway and want to ask someone.

How it works today:

  1. Install with the command from ①. That command is the installation assistant: the screen says what each step is doing, and when something fails it says what to do. Fix it and paste the same command again to carry on.
  2. Still stuck, and Agent J is already installed: run this command in "Ubuntu". It sends your question and a health check with the secrets removed to our support desk, which usually answers with concrete steps within a few minutes.
agentj support ask "<your question>" --attach-doctor
  1. Not installed yet, or you cannot reach us: email feedback@agentj.app with the step, the exact error and a screenshot (cover the installation code, keys and QR code first).

Tip: In a later planned release the cloud assistant suggests the next step right on your phone, and nothing runs until you tap it.

Full installation instructions