Browser Use 使用说明：托管云、CLI 与 Python 库三种接入方式

三种使用路径

Browser Use 的自述文档把使用方式分为三类：全托管云（通过 API 提交任务，由平台运行智能体与浏览器）、CLI（为 Claude Code、Codex、Cursor 等现有智能体提供浏览器访问，可交互也可写进脚本）、Python 库（在自有代码中运行开源智能体，可自定义工具、结构化输出并自选模型）。CLI 与 Python 库既能连接本地浏览器，也能连接云浏览器；托管 API 则连智能体本身也由平台运行。

Python 库的准备与操作

• 环境要求：Python >= 3.11；示例使用 uv 安装，先用 uv init --python 3.12 初始化新项目，再执行 uv add browser-use。
• 配置密钥：在 .env 中填写 OPENAI_API_KEY；若使用 BU2 模型或云浏览器，另需 BROWSER_USE_API_KEY。
• 基本写法：构造 Agent(task=..., llm=...) 并 await agent.run()，通过 history.final_result() 取最终结果。
• 切换云浏览器：把 browser=Browser(use_cloud=True) 传给 Agent，其余代码不变，适用于无本地 Chrome 的 Docker、CI 与 serverless 环境。

计费边界

Python 库本身免费且采用 MIT 许可；模型推理与托管浏览器另行计费。云浏览器标价为每浏览器小时 $0.02，另加网络流量，并附带隐身、住宅代理、验证码处理与实时查看链接。也可用 Ollama 在本地运行模型，但受硬件与模型要求限制。

Claude 工具集集成

仓库提供面向 Anthropic SDK 的工具集集成，需选用包含 anthropic.tools.browser 的 SDK 版本。文档称 Browser Use 实现了全部 31 个浏览器动作，可驱动本地浏览器、云浏览器或经 CDP 连接的远程浏览器；Bash 工具需 Linux 或 macOS 主机上的 /bin/bash，Windows 需用 WSL。

需注意的限制

文档说明网页认证时复用 Chrome 配置可通过 Browser.from_system_chrome()；云浏览器的配置同步只迁移 cookie，不包含本地存储、IndexedDB 与扩展，部分站点可能需重新登录。验证码规避效果取决于站点与挑战类型，没有配置能保证全部避开或解决。