轻舟 qz：阿里开源的浏览器 Agent，一句话让 Chrome 自己查网页、整理带来源的表格，还能被 Claude Code 调用

想从十几个网页里收集参数做对比表，通常要开一堆标签页，一个个复制粘贴，最后还得补来源链接。有些页面要先登录才能看，在线爬虫工具也进不去。

轻舟（英文名 qz）是阿里巴巴在 GitHub 上开源的浏览器 Agent，以 Chrome 扩展的形式装在侧边栏里。你用一句话描述任务，它就在你自己的 Chrome 里开标签页、点按钮、翻页、读正文，最后交回一张带来源的表格、一个文件或一份报告。模型用你自己的 API Key，DeepSeek、Kimi、OpenRouter 都能接。它还能反过来被 Claude Code、Codex 这类编程 Agent 调用，替它们跑网页上的活。

这篇对照官方仓库、Chrome 应用商店页面和 CLI 文档，讲清楚它能做什么、怎么装、怎么接模型、怎么给 Claude Code 用，以及权限和隐私上要注意什么。资料查阅于 2026-10-21。

先看基本信息

项目名取自李白的“两岸猿声啼不住，轻舟已过万重山”。仓库 README 有中文版，界面也是中文的。

它和普通 AI 插件有什么不一样

市面上的 AI 浏览器插件，多数只做“总结这一页”“翻译这一段”。轻舟是一个会自己动手的 Agent，有几点区别比较明显：

• 在你已经登录的 Chrome 里干活。 它直接用你现有的 Cookie 和登录状态，不需要另开一个虚拟浏览器。要登录才能看的后台、论坛、电商页面，它也能读。
• 每一步都摆在侧边栏里。 打开了哪个页面、执行了什么脚本、读到了什么，都会列出来，你随时可以停下或者插话纠正。
• 多任务并行。 一个任务可以拆出子任务分头去查，适合“对比 10 款产品”“汇总 20 个项目”这种量大的调研。
• 结果直接落成数据表。 提取出来的内容进入侧边栏的“数据”页，可以导出成 Excel 或 CSV，每行带来源链接。
• 跑通的流程能存成 Skill。 一次做成功后说一句“保存为 Skill”，下次一句话就能复用。

官方 README 拿它跟 Nanobrowser、Browser Use、agent-browser、Playwright MCP 比了一张表，重点是“整个任务交给它”“直接用已登录的 Chrome”“存成 Skill”这几项。这张表是项目方自己做的，参考就好。

安装：三步就能跑起来

1. 装扩展。 打开 Chrome 应用商店的轻舟页面，点“添加至 Chrome”，再点工具栏上的轻舟图标打开侧边栏。第一次打开会弹出数据说明，点同意后才能用。

打不开应用商店的话，可以去 GitHub Releases 下载 ZIP 解压，在 chrome://extensions 打开“开发者模式”，点“加载已解压的扩展程序”，选中 qz-browser-agent-extension 文件夹。写这篇时 Releases 页面还是空的，应用商店是目前唯一的正式渠道。

2. 接模型。 进入设置，选服务商，填 API Key，再选模型、上下文长度和是否支持图片，保存即可。国内用户最方便的是 DeepSeek，官方截图里用的就是 DeepSeek V4.1 Flash。有 ChatGPT 账号的，可以选 OpenAI Codex，按设备码提示登录，不用另外填 Key。

3. 下指令。 在侧边栏输入框里直接说，比如：

查今年诺贝尔奖各奖项得主，整理成带来源链接的表格。

怎么写任务，效果更好

官方给的几个例子写法很有代表性：说清楚要查什么、从哪里查、交付成什么样、没查到怎么办。

对比最近 6 个月发布的主流开源大模型，每行一个模型：发布日期、参数量、上下文长度、协议、主要基准成绩，附官方来源。

规划 3 天杭州文化漫游，串联西湖、博物馆与历史街区。查阅文旅部门和场馆官网，核对开放时间、门票与预约要求，整理每日路线表并附来源，未核实处标明。

找 arXiv 上最近一个月关于 browser agent 的 10 篇论文，整理标题、一句话结论和链接。

第三个跑通后说“保存为 Skill”，以后说一句“本周的 browser agent 论文”就能重跑。从官方截图看，存下来的 Skill 是一份 Markdown 说明，写明了前置条件、主流程和失败时的备用方案。你也可以在“技能”页里查看和修改。

几个小建议：

• 先拿一两个页面试，确认它抓得对，再放大到几十个。
• 明确要求“附来源”“没核实的标出来”。模型偶尔会编，有链接才能逐条核对。
• 任务跑偏了，直接在侧边栏插一句话纠正，不用从头再来。

让 Claude Code、Codex 把网页活交给它

这一块是轻舟比较特别的地方。编程 Agent 写代码很强，但遇到要登录的网页、连续点击、异步翻页就容易卡住。轻舟提供了 Skill、CLI 和 MCP 三种接法，让这些 Agent 把网页任务转交给你浏览器里的轻舟。

先装 Skill，让 Agent 知道怎么调用轻舟：

npx skills add alibaba/qz-browser-agent -g

再配对一次。CLI 需要 Node.js 22 或以上，运行后会在默认浏览器里自动完成配对：

npx qz-browser-agent@latest connect

之后在 Claude Code 里说“用轻舟对比最近 6 个月发布的开源大模型，整理成带来源的表格”就行。也可以直接用命令行：

npx qz-browser-agent@latest create "总结当前页面" --stream

我们在 Node 22 下装了 npm 上的 0.1.3 版，qz --help 列出的命令有 connect、create、send、tasks、show、watch、approve / reject、cancel、data、images、skills、settings、automations、status、mcp、stop 等。常用的几个：

用 MCP 的客户端，把 qz mcp 打出来的地址填进 HTTP 配置就能接上。Windows 上官方建议用 PowerShell 7.3 或更新版本。CLI 只在你本机开一个服务，默认端口 18765，被占用时会自动换一个端口。

如果你已经在用 Claude Code 或 Codex，本站的 AI 编程 Agent 生态全景 整理了周边各类工具，可以看看轻舟放在哪个位置合适。

权限和隐私：装之前要想清楚

轻舟官方的说法是“本地优先”：会话、Skill、采集的数据都存在你的浏览器里，项目没有自己的后台服务器。但这不等于数据不出门，下面几点要心里有数：

• 页面内容会发给模型。 任务里读到的网页正文、截图、标签页标题和网址，都会作为上下文发给你配置的模型服务商。在登录状态下读后台、邮箱、网银页面，这些内容也会被发过去。
• 权限很大。 官方文档列了 19 项权限加上 <all_urls>（所有网站）。其中 debugger 用来通过 CDP 操作页面，运行时 Chrome 顶部会出现“qz 已开始调试此浏览器”的提示，这是正常的。历史记录、书签、录屏是可选权限，用到时才会弹窗请求。
• API Key 存在浏览器配置里。 别在公用电脑上装。Key 最好设消费上限，万一泄露也能及时止损，可以参考本站的 API Key 泄露止损清单。
• 网页里的内容可能“带指令”。 这是所有浏览器 Agent 的共同风险：网页上可能藏着诱导 AI 执行操作的文字。涉及付款、发帖、删除这类不可逆操作的任务，最好盯着侧边栏看，或者干脆不交给它。
• 遵守网站规则。 用它批量采集数据，和写爬虫一样要看网站的服务条款，别高频访问，也别抓个人隐私数据。

适合谁，不适合谁

适合：

• 经常做竞品对比、资料汇总、行业调研，需要“表格 + 来源”的人。
• 要从登录后的页面里整理信息，写爬虫又嫌麻烦的人。要长期、大批量、稳定地抓数据，还是写代码更合适，可以看本站的 Scrapling 爬虫上手实测。
• 在用 Claude Code、Codex，想给它们配一个能操作真实浏览器的帮手。

先等等：

• 不想折腾 API Key、只想装完就用的人。轻舟必须先配好模型才能干活。只想在侧边栏整理书签、自动填表的话，可以看看 Starizon AI 这类开箱即用、带免费额度的扩展。
• 对隐私要求很高、浏览器里登录着大量敏感账号的人。可以单独建一个 Chrome 用户配置给它用。
• 项目开源才 10 天左右，版本迭代很快，界面和命令以后可能会变。

资料来源

• GitHub 仓库：alibaba/qz-browser-agent（中文 README、CLI 文档 docs/cli.md、权限说明 docs/permissions.md）
• 官网：alibaba.github.io/qz-browser-agent
• Chrome 应用商店：轻舟 qz
• npm：qz-browser-agent

文中截图来自轻舟官方仓库。CLI 命令列表是我们 2026 年 10 月 21 日在 Node.js 22 下实际运行 qz --help 得到的；扩展的实际任务效果没有用自己的 API Key 实测，功能描述来自官方文档。