@browser_use:现在可以将 browser-use 与 Anthropic 全新的 computer SDK 配合使用。https://docs.browser-use.com/open-source/customize/int…
摘要
Browser Use 现已集成 Anthropic 全新的 computer SDK,通过 Anthropic Python SDK 为 Claude 提供浏览器操作和 Bash 工具。该工具集(Browser Use 0.13.11+)支持本地 Chromium、Browser Use Cloud 以及现有的浏览器会话。
查看缓存全文
缓存时间: 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:浏览器自动化的 JavaScript 支持
Browser Use 随 browser use pi 的发布宣布支持 JavaScript,以响应社区对基于 JS 的浏览器自动化的需求。
@browser_use: Browser Use 的用例
Saurav Panda 分享了 Browser Use 的各种用例,Browser Use 是一个能够与任何网站交互的 AI 智能体,重点介绍了用户在过去一年中是如何应用它的。
browser-use/browser-use
Browser Use 是一个AI代理工具,通过模仿人类交互来自动化网页浏览器任务,如表单填写和数据提取。
@browser_use:在最新的 @OpenAIDevs SDK 上修复了浏览器使用功能
通过更新至最新的 OpenAI Python 和 Node.js SDK,浏览器和计算机使用功能变得更加简便,Kevin Whinnery 在一条推文串中重点介绍了这一点。
@browser_use: Browser Use Terminal 来了!将你的终端变成一个浏览器代理。> 从 CLI 运行浏览器任务 > 连接到 Cod…
Browser Use Terminal 是一款全新的 CLI 工具,可将你的终端变成一个浏览器代理,让你能够运行浏览器任务并控制真实的 Chrome 浏览器。