macOS
适用于 Apple 芯片和 Intel 芯片的 Mac。
① 自己装:一条命令
什么时候选它: Agent J 主机上还没有 AI 工具,或者你想自己动手。全程只用一个码:账户页空席位卡上的安装码(AJI- 开头)。
预计时间: 一般 10 分钟以内。机器自己跑只要几分钟(我们的测试机上约 2 分钟),其余是你登录 AI、扫码的时间。
- 在账户页 https://agentj.app/account/ 的空席位卡点「获取专属安装命令」,再点「复制安装命令」。在 Mac 上打开账户页,给的就是终端那一条;不是的话点「换成 macOS / Linux 命令」。
- 打开终端(按 Command + 空格,搜 Terminal),粘贴,回车。命令长这样:
curl -fsSL https://agentj.app/install.sh | bash -s -- AJI-… - 照屏幕走。每一步开头都写着这是第几步、在做什么:
| 屏幕上 | 你要做的 |
|---|---|
| 安装码 | 命令里带了码就直接用;没带会让你粘贴一次(不显示) |
| 系统组件 | 可能要输入一次Agent J 主机密码(输入时不显示) |
| AI | 已经登录过 Claude Code 或 Codex 就直接用。没有就选一条路:连不上官方服务选 Agents Relay 中转(见香港和中国大陆),能连就在浏览器里登录官方账号 |
| Agent J | 不用做:装好、启动后台服务、用同一个码绑定这个席位 |
| 手机 | 屏幕上出现二维码:用你自己的手机打开 https://m.agentj.app ,点「扫二维码」扫它 |
| 接上 AI | 不用做:AI 先真实回复一次才接上 |
| 永不休眠 | 手机配对好以后问一次。直接回车就是同意(推荐):插着电不自动睡眠。合盖会再问一次;同意后合上盖子的 Mac 既不睡也不关机,出门前要自己关机。每项改动都在手机上弹密码卡(详细说明) |
多一个选项:AI 那一步的菜单里还有第 6 项「用 OpenCode 自带的免费模型先跑起来」:不登录、不填 key,先用起来;对话和代码会发给 OpenCode 和它的模型供应商。它优先选不拿对话训练的免费模型;免费模型有限流、随时可能下线,敏感工作请之后换成自己的模型(手机「模型与 Key」)。其他选项和默认推荐都不变。
- 看到「✅ 全部完成」,就在手机上跟它打个招呼。装完以后,同一个终端窗口里就能直接用
agentj status。
出了问题:
- 中途哪一步失败,屏幕上会写一行「怎么办:…」。修好后粘贴同一条命令,做完的步骤会跳过。
- 安装码只能用一次,24 小时内有效(卡片上写着到期时间)。
- 已经装好、只差 AI,或旧版升不上去:再运行一次
curl -fsSL https://agentj.app/install.sh | bash(不用带码)。它先看版本:旧版会直接从 agentj.app 下载签名安装包修复升级(不用旧版的agentj update,不连 GitHub;席位、配对和设置都保留),再只补接 AI 这一步。
② 请人帮你装:在旁边或远程
什么时候选它: 你不熟悉Agent J 主机或终端,有家人、朋友或同事能坐在旁边,或者通过视频通话、屏幕共享帮你。
现在的做法:
- 帮手照①带着你做。码只在你自己的账户页复制,只粘在你自己的Agent J 主机上;远程帮的时候你共享屏幕、帮手口头指挥,码和 key 不要发进聊天。
- 要输入Agent J 主机密码的时候由你自己输,不要告诉帮手。
- 扫二维码配手机,用你自己的手机。如果扫的是帮手的手机,它就成了这台Agent J 主机的遥控器:装完以后运行
agentj devices找到它的设备号,再运行agentj revoke <设备号>把它移走。 - 当时手机不在手边,或者扫码那一步没配上,不用重装:装好以后在账户页这台Agent J 主机的席位卡上点「添加遥控器」,用通行密钥确认,再用你的手机扫码。
提示:一键帮手配对计划在后续版本推出:帮手用自己的手机临时连上,在手机上带你装完;你的手机配好、AI 接上以后,帮手自动断开。
③ 让Agent J 主机上的 AI 帮你装
什么时候选它: 你已经在用 Claude Code、Codex 或 OpenCode,想让它替你操作、边装边解释。
- 已经买了席位:在账户页空席位卡上点「复制安装提示词」,发给Agent J 主机上的 AI。
- 还没买:把下面这句话原样发给它,它会带你注册账号、买席位:
请用 curl 把 https://agentj.app/install.md 下载到本地,用读文件的工具完整读完,然后一步一步照着做,每一步开始前重读那一节。需要我动手的时候告诉我。
AI 每一步做什么、哪几步会停下来叫你,见让 AI 装的时候。
④ 远程安装助手(云端)
什么时候选它: 身边没人帮忙,Agent J 主机上也没有 AI,装到一半卡住了想问人。
现在这样用:
- 照①的命令装。这条命令本身就是安装助手:每一步在做什么都写在屏幕上,出错时会写一行「怎么办:…」。照着修好,再粘贴同一条命令接着装。
- 还是弄不明白,而 Agent J 已经装上了:在终端里运行下面这条命令。它把你的问题和去掉了密钥的体检结果发给我们服务器上的客服,一般几分钟内回你具体步骤。
agentj support ask "<你的问题>" --attach-doctor
- 还没装上,或者连不上我们:发邮件到 feedback@agentj.app,写清卡在哪一步、报错原文,附上截图(先遮住安装码、key 和二维码)。
提示:后续版本计划让云端助手直接在你的手机上给出下一步建议,你点了才执行。
macOS
For Macs with Apple silicon and Intel processors.
① 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.
- On https://agentj.app/account/ press "Get installation command" on the empty seat card, then "Copy installation command". Opened on a Mac, the page gives you the Terminal line; if not, press "macOS / Linux command".
- Open Terminal (press Command + Space and search for Terminal), paste and press Enter. The command looks like
curl -fsSL https://agentj.app/install.sh | bash -s -- AJI-… - Follow the screen. Every step starts with its number and what it is doing:
| On screen | What you do |
|---|---|
| Installation code | Taken from the command; if it is missing you paste it once (hidden) |
| System parts | You may be asked for the Agent J host password once (hidden) |
| AI | Reuses 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 J | Nothing: it installs, starts the background service and links this seat with the same code |
| Phone | A QR code appears: open https://m.agentj.app on your own phone, tap "Scan QR code" and scan it |
| Connect the AI | Nothing: the AI must answer one real request before it is connected |
| Keep it awake | Asked once your phone is paired. Press Enter for yes (recommended): no sleep while plugged in. A second question covers the closed lid; with that yes a closed Mac neither sleeps nor shuts down, so shut it down yourself before travel. 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.
- When you see "✅ 全部完成" (all done), say hello to it from your phone. Afterwards
agentj statusworks 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 | bashagain (no code). It checks the version first: an older Agent J is repaired forward with the signed package from agentj.app (not the oldagentj 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:
- 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.
- When the Agent J host asks for its password, you type it yourself; don't tell your helper.
- 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 devicesto find its device ID, thenagentj revoke <device-id>to remove it. - 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.
- 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.
- 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:
- 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.
- Still stuck, and Agent J is already installed: run this command in 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
- 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.