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

搜索文档和页面Search docs and pages

Linux

适用于 Ubuntu、Debian 等常见发行版,台式机、笔记本和云服务器都可以。只能用 SSH 登录、没有桌面的云服务器,还要看安装说明里云服务器那一节。

完整云服务器方案选带 systemd 的虚拟机。普通容器可能不支持隔离或后台服务:安装包后、初始化/登录/绑定席位前,运行 agentj doctor --isolation-only --json。它只用临时文件测试真实隔离,不读客户身份、不联网。退出码非零就停下看 JSON 里失败的 checks(有 reason 再看);通过也不代表平台允许长期后台运行。没有 systemd 用户会话时,tmux/nohup 下的 agentj serve 只是手动降级路线:升级、重启、崩溃后要自行启动,不承诺救援守护、手机紧急修复或 systemd 用户定时任务。详见完整安装说明。

① 自己装:一条命令

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

预计时间: 一般 10 分钟以内。机器自己跑只要几分钟(我们的测试机上约 2 分钟),其余是你登录 AI、扫码的时间。

  1. 在账户页 https://agentj.app/account/ 的空席位卡点「获取专属安装命令」,再点「复制安装命令」。在 Linux 上打开账户页,给的就是终端那一条;不是的话点「换成 macOS / Linux 命令」。
  2. 打开终端,粘贴,回车。命令长这样:
    curl -fsSL https://agentj.app/install.sh | bash -s -- AJI-…
  3. 照屏幕走。每一步开头都写着这是第几步、在做什么:
屏幕上你要做的
安装码命令里带了码就直接用;没带会让你粘贴一次(不显示)
系统组件会装 bubblewrap(Agent J 隔离);只有 Claude Code 自带沙箱需要 socat,可能要输入一次Agent J 主机密码(输入时不显示)
AI已经登录过 Claude Code 或 Codex 就直接用。没有就选一条路:连不上官方服务选 Agents Relay 中转(见香港和中国大陆),能连就在浏览器里登录官方账号
Agent J不用做:装好、启动后台服务、用同一个码绑定这个席位
手机屏幕上出现二维码:用你自己的手机打开 https://m.agentj.app ,点「扫二维码」扫它
接上 AI不用做:AI 先真实回复一次才接上
永不休眠手机配对好以后问一次。直接回车就是同意(推荐):插着电不自动睡眠,合上盖子也不睡,开机不用登录 Agent J 也自动运行。每项改动都在手机上弹密码卡(详细说明)

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

  1. 看到「✅ 全部完成」,就在手机上跟它打个招呼。装完以后,同一个终端窗口里就能直接用 agentj status。

出了问题:

  • 中途哪一步失败,屏幕上会写一行「怎么办:…」。修好后粘贴同一条命令,做完的步骤会跳过。
  • 安装码只能用一次,24 小时内有效(卡片上写着到期时间)。
  • 已经装好、只差 AI,或旧版升不上去:再运行一次 curl -fsSL https://agentj.app/install.sh | bash(不用带码)。它先看版本:旧版会直接从 agentj.app 下载签名安装包修复升级(不用旧版的 agentj update,不连 GitHub;席位、配对和设置都保留),再只补接 AI 这一步。

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

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

现在的做法:

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

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

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

什么时候选它: 你已经在用 Claude Code、Codex 或 OpenCode,想让它替你操作、边装边解释。

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

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

④ 远程安装助手(云端)

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

现在这样用:

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

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

完整安装说明

Linux

For Ubuntu, Debian and other common distributions, on desktops, laptops and cloud servers. A cloud server you reach only over SSH (no desktop) also needs the cloud-server section of the install guide.

A VM with systemd is the full cloud-server setup. For a generic container, the fence and background service may fail: after installing the package, before init/login or binding a seat, run agentj doctor --isolation-only --json. It tests the real fence using temporary files without customer identity or network access. If the exit status is nonzero, stop and inspect the failed JSON checks entry (reason when present); a pass does not prove the platform permits a persistent background process. With no systemd user session, agentj serve under tmux/nohup is only a manual fallback: restart it after an update, reboot or crash; rescue, emergency repair and systemd user timers are not guaranteed. See the full install guide.

① 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 under 10 minutes. the Agent J host's own work takes a few minutes (about 2 on our test machine); the rest is you signing in to an AI and scanning a code.

  1. On https://agentj.app/account/ press "Get installation command" on the empty seat card, then "Copy installation command". Opened on Linux, the page gives you the terminal line; if not, press "macOS / Linux command".
  2. Open a terminal, paste and press Enter. The command looks like
    curl -fsSL https://agentj.app/install.sh | bash -s -- AJI-…
  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)
System partsInstalls bubblewrap for Agent J isolation; socat is needed only for Claude Code's own sandbox; you may be asked for the Agent J host password once (hidden)
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 awakeAsked once your phone is paired. Press Enter for yes (recommended): no sleep while plugged in, also with the lid closed, and Agent J starts at boot without a login. Each change is a password card on your phone (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. Afterwards agentj status works in the same terminal window.

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? 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.

② 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. When the Agent J host asks for its password, you type it yourself; don't tell your helper.
  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 and want it to do the work and explain as it goes.

  1. Already bought a seat: press "Copy installation prompt" on the empty seat card in your account and send it to the AI on the Agent J host.
  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 a terminal. 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