## macOS {#macos}

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


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

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

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

1. 在账户页 https://agentj.app/account/ 的空席位卡点「获取专属安装命令」，再点「复制安装命令」。在 Mac 上打开账户页，给的就是终端那一条；不是的话点「换成 macOS / Linux 命令」。
2. 打开终端（按 Command + 空格，搜 Terminal），粘贴，回车。命令长这样：

   ```bash
   curl -fsSL https://agentj.app/install.sh | bash -s -- AJI-…
   ```
3. 照屏幕走。每一步开头都写着这是第几步、在做什么：

| 屏幕上 | 你要做的 |
|---|---|
| 安装码 | 命令里带了码就直接用；没带会让你粘贴一次（不显示） |
| 系统组件 | 可能要输入一次Agent J 主机密码（输入时不显示） |
| AI | 已经登录过 Claude Code 或 Codex 就直接用。没有就选一条路：连不上官方服务选 Agents Relay 中转（见[香港和中国大陆](/docs/install/#hk-cn)），能连就在浏览器里登录官方账号 |
| Agent J | 不用做：装好、启动后台服务、用同一个码绑定这个席位 |
| 手机 | 屏幕上出现二维码：用**你自己的手机**打开 https://m.agentj.app ，点「扫二维码」扫它 |
| 接上 AI | 不用做：AI 先真实回复一次才接上 |
| 永不休眠 | 手机配对好以后问一次。直接回车就是同意（推荐）：插着电不自动睡眠。合盖会再问一次；同意后合上盖子的 Mac 既不睡也不关机，出门前要自己关机。每项改动都在手机上弹密码卡（[详细说明](/docs/keep-awake/)） |

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

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

出了问题：

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


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

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

现在的做法：

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

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

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

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

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

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

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


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

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

现在这样用：

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

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

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

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


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