安装 agent-browser 并下载 Chrome

你将得到什么

• 全局可用的 agent-browser 命令（官方推荐：npm 全局安装原生 Rust 二进制）
• 本机已下载的 Chrome for Testing（或已检测到的现有 Chrome / Brave / Playwright / Puppeteer）
• （可选）Linux 系统依赖一次装齐的 --with-deps 路径

开始前准备

1. 本机已安装 Node.js 与 npm（全局安装路径需要它们）。
2. 可访问外网，以便首次 agent-browser install 拉取 Chrome for Testing。
3. macOS 用户也可改用 Homebrew（见步骤 3）；从源码构建才需要 Node 24+ / pnpm 11+ / Rust——本课不走源码路径。

核心事实（先记住）

步骤 1：全局安装 CLI

在终端执行：

npm install -g agent-browser

对照结果：

• 命令退出码为 0
• 随后可运行：

agent-browser --help

或：

which agent-browser
agent-browser --version

应看到帮助/版本输出，而不是 command not found。

项目内依赖安装（可选）：npm install agent-browser 后通过 package.json scripts 或本地 node_modules 调用；本课以全局安装为准。

步骤 2：下载 Chrome for Testing

首次使用需要浏览器运行时。官方说明：执行下列命令会从 Chrome for Testing 下载；若本机已有 Chrome / Brave / Playwright / Puppeteer，也会自动检测。daemon 运行不需要 Playwright 或 Node.js。

agent-browser install

对照结果：

• 命令成功结束（退出码 0）
• 再次运行时不应再完整重下（若已就绪会很快结束或提示已安装）

Linux：顺带装系统库

在 Linux 上若缺共享库，官方建议：

agent-browser install --with-deps

对照结果：

• 若包管理器装齐依赖 → 退出码 0
• 若无法装齐 → 非零退出（官方明确：不能装齐每个所需浏览器库时退出非零）——此时按报错补齐发行版依赖后再重试

步骤 3（可选）：Homebrew / 无安装试跑

macOS Homebrew：

brew install agent-browser
agent-browser install

不想全局安装时（官网首页）：

npx agent-browser open example.com

对照结果：浏览器会话启动并打开 Example Domain；下一课会系统讲解 snapshot 与关闭会话。

步骤 4：升级（以后需要时）

agent-browser upgrade

官方说明：会检测你是用 npm、Homebrew 还是 Cargo 安装，并跑对应更新命令。

本课检查清单

• agent-browser --help 有输出
• agent-browser install（或 --with-deps）成功
• 已知产品页与仓库 URL，便于对照官方变更

常见问题

下一课：用 open → snapshot → click / fill → screenshot → close 跑通官方 Quick Start。