安装

全局安装（推荐）

安装原生 Rust 二进制文件以获得最佳性能：

npm install -g agent-browser
agent-browser install  # 下载 Chromium

这是最快的选择——命令通过原生 Rust CLI 直接运行，解析开销低至亚毫秒级别。

快速启动（无需安装）

如果想尝试而不想全局安装，可直接使用 npx：

npx agent-browser install   # 首次运行时下载 Chromium
npx agent-browser open example.com

注意： npx 在到达 Rust CLI 之前需经过 Node.js 路由，因此明显慢于全局安装。如需频繁使用，请进行全局安装。

项目安装（本地依赖）

对于希望在 package.json 中固定版本的项目：

npm install agent-browser
npx agent-browser install

然后通过 npx 或 package.json 脚本使用：

npx agent-browser open example.com

Homebrew（macOS）

brew install agent-browser
agent-browser install  # 下载 Chromium

从源码构建

git clone https://github.com/vercel-labs/agent-browser
cd agent-browser
pnpm install
pnpm build
pnpm build:native
./bin/agent-browser install
pnpm link --global

Linux 系统依赖

在 Linux 上，需安装系统依赖：

agent-browser install --with-deps
# 或手动执行：npx playwright install-deps chromium

自定义浏览器

可使用自定义浏览器可执行文件代替内置的 Chromium：

无服务器模式 - 使用 @sparticuz/chromium（约 50MB，相比原版的 684MB）
系统浏览器 - 使用已安装的 Chrome
自定义构建 - 使用修改后的浏览器构建版本

# 通过命令行参数
agent-browser --executable-path /path/to/chromium open example.com

# 通过环境变量
AGENT_BROWSER_EXECUTABLE_PATH=/path/to/chromium agent-browser open example.com

无服务器模式示例

import chromium from '@sparticuz/chromium';
import { BrowserManager } from 'agent-browser';

export async function handler() {
  const browser = new BrowserManager();
  await browser.launch({
    executablePath: await chromium.executablePath(),
    headless: true,
  });
  // ... 使用浏览器
}

AI 助手配置

agent-browser 可与任何 AI 助手开箱即用。如需更丰富的上下文支持：

AI 编程助手（推荐）

为你的 AI 编程助手安装技能：

npx skills add vercel-labs/agent-browser

该技能支持 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、Goose、OpenCode 以及 Windsurf。技能将自动从仓库获取并保持最新。

不要复制 node_modules 中的 SKILL.md —— 新功能加入后它会迅速过期。始终使用 npx skills add 或引用仓库版本。

AGENTS.md / CLAUDE.md

将以下内容添加到你的指令文件中：

## 浏览器自动化

使用 `agent-browser` 进行网页自动化。运行 `agent-browser --help` 查看所有命令。

核心工作流：
1. `agent-browser open <url>` - 导航至页面
2. `agent-browser snapshot -i` - 获取可交互元素及其引用（@e1, @e2）
3. `agent-browser click @e1` / `fill @e2 "text"` - 使用引用进行交互
4. 页面变更后重新快照