browser-harness

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Python 3.12（README 中明确要求用 uv 配合 Python 3.12 安装）
• uv 包管理工具（README 用它安装或升级 browser-harness）
• 一个编码智能体：Claude Code 或 Codex
• 本地 Chrome 浏览器（需允许远程调试连接）

安装与启动步骤

1. 1准备环境

   README 要求用 uv 以 Python 3.12 安装，请先自行准备好 uv 与 Python 3.12 环境；README 未给出具体安装命令，按 uv 官方方式准备即可。

2. 2粘贴安装提示词

   把 README 给出的 setup prompt 原样粘贴到 Claude Code 或 Codex，由智能体完成安装、注册 skill 并连接浏览器。

   Install or upgrade browser-harness to the latest stable version with uv using Python 3.12, register the skill from `browser-harness skill`, and connect it to my browser. Ask whether I want local browser recordings enabled; default to no and preserve my existing preference on upgrades. Follow https://github.com/browser-use/browser-harness/blob/main/install.md if setup or connection fails.

   复制

3. 3允许远程调试

   智能体会自动打开 chrome://inspect/#remote-debugging，首次设置时必须勾选该复选框，agent 才能连上你的浏览器。

4. 4选择本地录制

   过程中智能体会询问是否开启本地浏览器录制，README 默认选否，并在后续升级时保留你已有的偏好。

5. 5云端替代方案

   不想用本地浏览器时，可直接在 Browser Use Cloud 中试用 browser-harness，无需自己连接浏览器。

关键配置

如何确认成功

智能体成功连上你的浏览器并能代为执行网页任务，即表示安装与连接成功。

常见问题

注意事项

• 本教程只依据 README 节选整理，README 未给出可直接执行的安装命令，具体命令请以仓库 install.md 为准。
• setup prompt 需粘贴到编码智能体内执行，不要当作 shell 命令直接运行。
• 首次连接必须手动勾选 chrome://inspect/#remote-debugging 中的复选框。
• 本地浏览器录制默认关闭，升级时请保留用户已有偏好设置。