@browser_use:现在可以将 browser-use 与 Anthropic 全新的 computer SDK 配合使用。https://docs.browser-use.com/open-source/customize/int…

X AI KOLs Timeline 工具

摘要

Browser Use 现已集成 Anthropic 全新的 computer SDK,通过 Anthropic Python SDK 为 Claude 提供浏览器操作和 Bash 工具。该工具集(Browser Use 0.13.11+)支持本地 Chromium、Browser Use Cloud 以及现有的浏览器会话。

现在可以将 browser-use 与 Anthropic 全新的 computer SDK 配合使用。https://docs.browser-use.com/open-source/customize/integrations/toolsets-for-claude…
查看原文
查看缓存全文

缓存时间: 2026/10/08 13:04

你现在可以将 browser-use 与新的 Anthropic computer SDK 一起使用了。https://docs.browser-use.com/open-source/customize/integrations/toolsets-for-claude…


Claude 的 Browser Use 工具集 - Browser Use

来源:https://docs.browser-use.com/open-source/customize/integrations/toolsets-for-claude Claude 的 Browser Use 工具集由 Browser Use 维护,并与 Claude 兼容。它通过 Anthropic Python SDK 提供浏览器操作和 Bash 工具。SDK 的工具执行器会将 Claude 的每次工具调用发送给 Browser Use,将结果返回给 Claude,并不断重复此过程直到 Claude 完成任务。

打开完整尺寸架构图 (https://docs.browser-use.com/open-source/images/anthropic/architecture.svg)

安装

你需要在 Linux 或 macOS 上安装 Python 3.11 或更高版本,并具备 /bin/bash。在 Windows 上,请在 WSL 中运行示例。

uvx browser-use install 会安装本地 Chromium。如果你只使用 Browser Use Cloud,可以跳过此步骤。在 Claude Console 中创建 Anthropic API 密钥,然后在运行脚本的终端中导出它。无论使用哪种浏览器模式,此密钥都是必需的:

在运行示例之前,请检查已安装的 SDK 是否包含浏览器工具集:

Browser Use 0.13.11 或更高版本包含此集成。仅处于 Anthropic 1.x 版本范围内并不能保证支持浏览器工具集:你需要安装 Anthropic 提供的兼容版本。如果检查结果显示缺少 anthropic.tools.browser,请先按照 Anthropic 的浏览器工具集发布说明进行操作,然后再继续。重新安装 Browser Use 或添加 Cloud 密钥都无法提供该 SDK 模块。本地浏览器只需要 ANTHROPIC_API_KEY,不需要 Browser Use Cloud 密钥。使用 Cloud 时请同时导出两个密钥:Anthropic 运行 Claude,而 Browser Use 提供浏览器环境。上述 export 命令仅对当前终端生效;本脚本不会自动加载 .env 文件。

快速开始

本示例读取三篇 Hacker News 帖子,并将其标题和 URL 以 Markdown 和 JSON 格式保存到 outputs/ 目录中。它启用全部 31 个浏览器操作以及 Bash,无需审批提示。

将以下内容保存为 run_browser.py:

运行它:

脚本会打印 Claude 的最终回答,包括三个标题和已保存的文件名。设置 ANTHROPIC_LOG=info 可以包含 SDK 请求日志。系统提示词是你的应用程序的一部分,请根据你的任务进行调整。

选择浏览器

要在 Browser Use Cloud 中运行浏览器,请在 Browser Use Cloud 创建密钥,设置 BROWSER_USE_API_KEY,并在快速开始示例的 BrowserUse(...) 调用中取消注释 use_cloud=True。保留其 configs 和 confirm 参数。对于远程上传,请用上传文件到远程浏览器中的暂存文档策略和解析器替换本地 file_policy。在此模式下不需要本地 Chromium。Bash 仍然在 SDK 主机上运行。保持 ANTHROPIC_API_KEY 用于 Claude,并在同一终端中导出额外的 Cloud 密钥:

BrowserUse 支持三种浏览器配置:

要使用你已经启动的浏览器,请传入一个已连接的 BrowserSession。驱动程序不会关闭借用的会话,请在你的应用程序清理代码块中关闭它。有关 CDP 配置,请参见远程浏览器连接。

Browser Use 集成提供 BrowserUse 用于浏览器操作,Bash 用于 shell 命令。通过 tools=[driver, bash] 同时注册两者。如果你的应用程序不应执行 shell 命令,则省略 bash。Claude 调用 navigate、read_page 和 left_click 等结构化操作,驱动程序通过 CDP 执行它们。javascript_exec 在页面内运行 JavaScript,它不是通用的 CDP 代码解释器。Bash 在你的 Python 进程旁边运行,以 output_dir 作为工作目录,可以在其中处理提取的数据并生成报告。

打开完整尺寸工具调用时序图 (https://docs.browser-use.com/open-source/images/anthropic/tool-sequence.svg)

全部 31 个浏览器操作

  • 导航:navigate、new_tab、list_tabs、switch_tab、close_tab。
  • 页面状态:screenshot、zoom、read_page、find、get_page_text、wait。
  • 指针操作:left_click、right_click、middle_click、double_click、triple_click、hover、mouse_move、left_mouse_down、left_mouse_up、left_click_drag、scroll、scroll_to。
  • 输入:type、key、hold_key、form_input、file_upload。
  • 诊断:read_console、read_network、javascript_exec。

快速开始示例启用了全部 31 个浏览器操作以及 Bash。不带参数的 BrowserUse() 遵循 Anthropic 的默认设置:启用 27 个操作,javascript_exec、file_upload、read_console 和 read_network 默认关闭。快速开始示例通过 configs 启用了这四个操作:

你的应用程序通过 tools=[driver, bash] 将工具提供给 Claude。SDK 将浏览器工具集及其 configs 发送给 Anthropic,Claude 从已启用的操作中选择调用。被禁用的操作不会暴露给 Claude,即使被请求也会被 SDK 拒绝。仅注册 driver 不包含 Bash。javascript_exec 在页面内运行 JavaScript,Bash 在 SDK 主机上运行命令。要禁用某个操作,请在传给 BrowserUse(...) 的 configs 中将该操作的 enabled 值设为 False。要移除 Bash,请使用 tools=[driver],并更新任务描述和系统提示词,使其不请求 shell 命令。

文件上传和下载

浏览器操作中的文件路径指的是浏览器主机的文件系统。使用本地 Chromium 时,它与你的 Python 进程在同一台机器上:经过批准的本地文件可以上传,下载的字节数据也可以在本地读取。远程浏览器有自己独立的文件系统。

打开完整尺寸文件传输图 (https://docs.browser-use.com/open-source/images/anthropic/files-between-hosts.svg)

上传文件到远程浏览器

对于远程上传,你的应用程序必须先将文件的字节数据复制到浏览器主机。然后可以给 Claude 一个已批准的文档 ID,并将该 ID 映射到暂存路径。file_upload 会在页面的文件选择框中选择暂存的文件。传输步骤独立于驱动程序。以下代码从 report.pdf 已经在浏览器主机上开始:

解析器负责将 ID 映射到路径,但不会复制字节数据。BrowserUse(use_cloud=True) 不提供自动上传暂存或下载检索功能。开源版 Agent 对上传也有相同的浏览器主机路径要求。

从远程浏览器下载

下载通知表示浏览器已完成下载。通知中的路径是关于浏览器主机的元数据,并不意味着该文件在 SDK 主机上存在。请先将文件检索到 SDK 主机,然后再让 Bash 读取它。快速开始示例不需要传输步骤,因为 Bash 直接在 SDK 主机上写入 Markdown 和 JSON 文件。

审批

启用 file_upload 或 javascript_exec 需要一个确认回调函数。SDK 在执行浏览器操作之前会调用该回调,检查操作是否已启用、其输入和文件选择是否被允许。快速开始示例使用 confirm=lambda _: True 自动批准所有浏览器操作。你可以用下面的回调函数替换它,在 Claude 上传文件或运行页面 JavaScript 时请求批准,其他浏览器操作则自动批准。该回调可以使用终端提示、你应用中的审核界面或你自己的审批服务。

打开完整尺寸审批门控图 (https://docs.browser-use.com/open-source/images/anthropic/approval-gate.svg) · 查看文件上传时序图 (https://docs.browser-use.com/open-source/images/anthropic/confirmation-callback.svg)

例如,一个上传请求可能会显示如下提示(下面的路径和页面仅为示例):

审批仅适用于当前操作。后续调用仍会再次经过回调函数。文件允许列表将本地上传限制在 uploads/ 和 outputs/ 目录中,因此 Bash 写入的文件也可以被批准上传。远程浏览器需要在浏览器主机上进行文件暂存,详见上传文件到远程浏览器。

此回调会对上传和 JavaScript 请求提示审批,并自动批准所有其他浏览器操作。对于有副作用的操作(如发送消息、提交购买或删除记录),请添加额外的检查。浏览器审批不涵盖 Bash。如果 shell 命令也需要审批,请省略 Bash 或制定单独的执行策略。Bash 会限制执行时间和返回的输出量,并从其子进程中移除环境凭据。其工作目录不是操作系统级别的沙箱,请在隔离环境中运行不受信任的任务。


请阅读 Claude 浏览器工具集快速开始以了解上游 SDK 的契约。

ClaudeDevs (@ClaudeDevs): Computer use 和 browser use 工具集现已内置于 Claude 的 Python 和 TypeScript SDK 中。

API 会告诉你 Claude 想要点击或输入什么。

之前,你需要自己编写循环并将点击和按键映射到命令,但现在 SDK 已经为你运行这个循环并

相似文章

@browser_use: Browser Use 的用例

X AI KOLs Following

Saurav Panda 分享了 Browser Use 的各种用例,Browser Use 是一个能够与任何网站交互的 AI 智能体,重点介绍了用户在过去一年中是如何应用它的。

browser-use/browser-use

GitHub Trending (daily)

Browser Use 是一个AI代理工具,通过模仿人类交互来自动化网页浏览器任务,如表单填写和数据提取。