OpenCode Browse 是一个 MCP Server 加一个 Chromium 扩展,让编码智能体直接使用你平时在用的浏览器:你的标签页、你的登录状态、你的扩展。智能体在后台标签组里开页、读页面、点击、输入、截图、录标签页、抓网络流量。遇到必须由人完成的步骤——登录、两步验证、付款——它会把标签页交还给你。
Browse 出自 Anomaly,也就是 OpenCode 背后的团队,并且可与任何 MCP 客户端配合,不限于 OpenCode。首个 0.1.0 版本于 2026 年 11 月 16 日发布,目前最新版本为 0.1.5,源码采用 MIT 许可。
下面依次说明:各组件如何协作、如何安装、交接与允许站点如何工作、它与 Playwright MCP 和 Chrome DevTools MCP 有何区别,以及智能体如何借助 Apifox CLI 把抓到的流量变成经过测试的 API。
AI Coding 交流群
如果你也在用 AI 写代码,或者正在研究 Cursor、Claude Code 这些工具,欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流,还有各种新工具和新玩法。
什么是 OpenCode Browse?
OpenCode Browse 是一个体量很小的原生 MCP Server(browse CLI)加一个浏览器扩展,让 AI 编码智能体有控制地访问你已经在用的浏览器。智能体在自己的分组标签页里工作,用接近真人的方式操作页面,并在登录、两步验证和付款时暂停下来等你处理。

| 项目 | 详情 |
|---|---|
| 开发方 | Anomaly(OpenCode 团队) |
| 组成 | browse CLI 与 MCP Server,外加 Chrome 应用商店扩展 |
| 浏览器 | Chrome、Edge、Brave、Arc、Helium、Vivaldi、Opera、Chromium |
| MCP 客户端 | OpenCode、Claude Code、Cursor、Codex、Zed,以及另外 30 多个 |
| 许可证 | MIT |
| 首个版本 | v0.1.0,2026 年 11 月 16 日 |
| 最新版本 | v0.1.5 |
| 价格 | 产品页未标价 |
大多数给智能体用的浏览器工具会新开一个空白配置,导致智能体看不到你已登录的任何内容。Browse 反过来:智能体在你自己的配置里工作,你已经登录的后台或管理面板就在眼前,无需交出任何 API Key。
Browse 的工作原理:MCP Server、中继与扩展
Browse 由三个部分组成。

- MCP Server。 智能体启动
browse mcp,这是一个很小的 stdio 进程。 - 中继。 它按需启动在
127.0.0.1:19988(若被占用则顺延到 19997 以内下一个空闲端口),保存智能体标签页、交接、录制和网络抓包状态,无人使用后自动退出。 - 扩展。 它通过 WebSocket 连接中继,并借助
chrome.debugger在你的浏览器里执行命令。
标签页就是操作句柄。智能体调用 navigate 时不指定标签页,Browse 会新开一个后台标签页并返回它的 id,后续每次调用都带上这个 id。智能体只能操作自己开的或你借给它的标签页,空闲标签页 10 分钟后自动关闭。
OpenCode 拿到的是普通工具(navigate、snapshot、click、fill、screenshot、network、recording 等)。其他 MCP 客户端拿到的是 execute、status 和 tabs,其中 execute 在沙箱中运行 JavaScript,并提供一个 Playwright 风格的 page 对象,可用于调用所有工具。每个工具同时也是一个 CLI 命令:browse navigate https://example.com 会打印出一个标签页 id。
如何安装 OpenCode Browse
产品页建议先从 Chrome 扩展入手,它会引导你完成其余步骤。从终端安装的话,README 给出的是:
# macOS 和 Linux
curl -fsSL https://opencode.ai/browse/install | bash
# Windows PowerShell
irm https://opencode.ai/browse/install.ps1 | iex
# npm 或 bun
npm install -g @opencode/browse && browse install
bun add -g @opencode/browse && browse install
你也可以直接给智能体一句话:「配置 browse 让你能用我的 Chrome:运行 curl -fsSL https://opencode.ai/browse/install | bash。」Browse 随后会为这个智能体完成自配置。
browse install 做三件事:
- 安装
browse可执行文件并加入 PATH。 - 把 MCP Server 加进你的智能体,可以交互选择,也可以直接执行
browse install -a claude codex。 - 与扩展完成配对;如果浏览器里还没有安装扩展,会打开 Chrome 应用商店页面。
重启正在运行的智能体,让它加载这个 Server,然后试试「打开 news.ycombinator.com 告诉我头条是什么」。对于安装器不认识的客户端,browse install --agent none 会打印出可手动粘贴的 stdio 配置。如果你还不熟悉这个协议,Model Context Protocol 文档 解释了客户端如何加载 Server。
交接、借出标签页与允许站点
这三项特性决定了你能保留多少控制权。
交接(Handoff)。 智能体遇到登录、两步验证提示或付款时,会调用 handoff。页面上出现一张小卡片显示站点源(origin),徽标显示 WAIT。你完成人工部分,然后点击 Continue。只有真实点击才能结束一次交接,页面无法伪造。
借出标签页。 在任意已打开的标签页上点击 Browse 工具栏按钮,徽标显示 ON:智能体可以用它了。再点一次即可收回,运行中也可以。
允许站点与只读标签页。 智能体开标签页时可以传 allowedOrigins,把导航和弹窗限制在你指定的站点,或标记为 readOnly,拒绝点击、输入、上传和导航。README 明确说这些是护栏而非数据边界:页面自身发出的请求不会被过滤,eval 在只读标签页里仍会执行。如果你不希望智能体读某个页面,就不要把它开在 Browse 里。
README 里提到的其他防护还包括:
- 中继默认只监听
127.0.0.1,并且需要只有你能读到的令牌。 - 配对码只能使用一次、10 分钟内有效,每个浏览器有独立的密钥。
- 网络抓包会对鉴权头、API Key、Cookie 值和名称含密钥的字段做脱敏。但按普通名字命名的密钥仍可能漏出,分享前请自行检查。
- 清除 Cookie、关闭浏览器、修改站点权限等操作会被拒绝。
OpenCode Browse、Playwright MCP 与 Chrome DevTools MCP 对比
三者都能让智能体通过 MCP 驱动 Chromium 浏览器,但默认设定不同。
| OpenCode Browse | Playwright MCP | Chrome DevTools MCP | |
|---|---|---|---|
| 默认浏览器 | 你正在运行的浏览器与配置 | 它自己启动的浏览器,使用独立持久配置 | 工具需要时才启动的 Chrome |
| 使用你的登录状态 | 支持,且是设计初衷 | 支持,需 --extension 与 Playwright 扩展 |
支持,需连接正在运行的 Chrome |
| 人工交接 | 内置 handoff 卡片 |
README 未提供 | README 未提供 |
| 网络抓包 | 支持,凭证已脱敏 | 支持,请求列表与详情 | 支持,请求分析 |
| 性能追踪 | 未列为工具 | 非重点 | 支持,并附洞察 |
| 许可证 | MIT | Apache-2.0 | Apache-2.0 |
来源:Playwright MCP README 与 Chrome DevTools MCP README,查阅于 2026 年 11 月 17 日。
按任务选:
- Browse:智能体需要用你已登录的会话,而你希望登录和付款仍在自己的把关之下。
- Playwright MCP:需要在干净或隔离配置里重复执行的端到端流程。
- Chrome DevTools MCP:排性能问题、看控制台报错或某条请求为什么慢。
它们彼此独立,同一个智能体可以在一个会话里同时用 Browse 操作已登录的后台,用 Playwright MCP 跑测试。
用 Apifox CLI 把抓到的流量变成经过测试的 API
很多 Web 应用会调用没有公开规范的内部 API。智能体可以在你已登录的浏览器里打开这个应用,用 Browse 抓下流量,再交给 Apifox CLI,由它导入并测试。你只需要写一句提示词。

Browse 的变更日志说明它的网络抓包以 HAR 文件形式提供,而 Apifox CLI 支持用 --format har 导入 HAR。先把 CLI 配好:
npm install -g apifox-cli@latest
apifox auth login --with-token <YOUR_TOKEN>
apifox skill install
或者直接告诉智能体:「读一下 https://apifox.com/apifox-cli-installation-guide.md 并配好 Apifox CLI。」那份指南就是写给智能体看的。
然后给智能体一句提示词:
用 browse 在我的浏览器里打开 https://app.example.com/orders,在你加载订单列表
并打开一个订单的过程中抓取网络流量。把抓包保存为 HAR 文件。导入 Apifox 项目
123456,然后为 GET /api/orders 建一个测试用例,断言状态码为 200 且 items
数组非空,在环境 7890 上运行并汇总失败项。
抓包完成后,智能体执行类似下面的命令:
apifox import --project 123456 --format har --file ./orders.har --overwrite-mode merge
apifox endpoint list --project 123456
apifox cli-schema get test-case-create
apifox cli-schema validate test-case-create --file case.json
apifox test-case create --project 123456 --file case.json
apifox run --test-case <caseId> --project 123456 -e 7890 -r cli,json
智能体从 apifox cli-schema get 读取载荷结构并在写入前校验,因此不必猜 JSON 长什么样。--overwrite-mode merge 会保留你已有的接口。
用例跑通之后,同一条 apifox run 加上 -r junit 就能接入 CI:参见 Apifox CLI CI/CD 指南。在 Claude Code 中使用 Apifox CLI 的流程与此相同;如果你更习惯手动导出 HAR,也可以在 Apifox 中导入 HAR 文件。Apifox 免费版的可用人数请以官网为准。
上手前需要知道的限制
- 它还很年轻。 首个版本 0.1.0 于 2026 年 11 月 16 日发布,目前最新版本为 0.1.5;代码库始于 2026 年 10 月下旬,默认会自动更新(
browse update --mode notify改为只提醒)。 - 只支持 Chromium。 不支持 Firefox 和 Safari。
- 调试状态可见。 智能体附着期间,浏览器会一直显示「已开始调试」提示条。
- 数据发往智能体所用的模型服务商。 Browse 本身运行在本地,但智能体读到的页面内容会发给它的模型服务商。
常见问题
OpenCode Browse 免费吗?
源码采用 MIT 许可,产品页没有标价。CLI 用脚本或包管理器安装,扩展从 Chrome 应用商店安装。
用 Browse 必须装 OpenCode 吗?
不是必须。安装器可以配置 Claude Code、Codex、Cursor、Zed、VS Code、Gemini CLI 等众多客户端,browse install --agent none 会为其余客户端打印手动配置项。
智能体能看见我的密码吗?
fill 工具会隐藏密码和一次性验证码的值,登录也应该走交接流程由你自己输入。截图和页面文本则按原样返回,所以敏感页面不要开在智能体的标签页里。
智能体跑在另一台机器上时还能用 Browse 吗?
可以。在智能体所在机器上执行 browse install --remote,并把扩展配对到那个地址。Browse 不加密这条链路,请用 Tailscale 或 WireGuard。
Browse 与 Playwright MCP 有什么区别?
Browse 默认驱动你现有的浏览器和配置,并内置交接流程;Playwright MCP 默认启动自己的浏览器,也可以通过扩展模式连到你现有的浏览器上。