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

搜索文档和页面Search docs and pages

macOS

适用于 Apple 芯片和 Intel 芯片的 Mac。

① 自己装:一条命令

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

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

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

多一个选项: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 和二维码)。

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

完整安装说明

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.

  1. 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".
  2. 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-…
  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 partsYou 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. 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.

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