Browser Use Box
在任意一台自有 Ubuntu 主机上部署 24/7 常驻的 Claude Code 浏览器代理，并通过 Telegram 或网页终端随时指挥。
- Star 数
- ★ 459
- 最近更新
- 6 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 34/100 · 缺口较多
30 秒速览
- 可在哪里用
- 平台专用Claude Code · Claude APIChatGPT（不支持）
- 开始前需要
- 典型场景
- 运营或销售团队希望用 Telegram 直接指挥一个能登录后台、填表、抓页面的常驻代理，而不必每次都开电脑。
- 主要局限
- 核心浏览器能力依赖 Browser Use Cloud 和有效的 API key，无法脱离该服务独立运行浏览器自动化。
这个 Agent 能做什么，适合哪些场景？
Browser Use Box 是一套安装脚本加三个 systemd 服务的组合，把 Claude Code、真实 Chromium 会话和 Telegram 入口装到你自己的一台机器上。安装时用 curl 拉取 install.sh，传入 BROWSER_USE_API_KEY，即可在 Ubuntu 22.04+（≥2GB 内存，$5 VPS 亦可）上跑起来。浏览器侧通过 browser-harness 以 CDP over wss 连接 Browser Use Cloud，因此 cookie 和登录状态可以持久保留。用户可以从 Telegram bot 或绑定 localhost 的 ttyd 网页终端下发指令，由 claude -p 执行，代理状态存放在 /home/bux，重启后技能、聊天记录和会话仍在。遇到登录墙、2FA 或 CAPTCHA 时，代理会给出一个实时查看链接等待人工处理，而不是硬闯凭据。
安装脚本 install.sh 会布置三个 systemd 服务：telegram_bot.py 接收 Telegram 消息，ttyd 提供仅绑定 localhost 的网页终端，bux-browser-keeper 维持浏览器会话。两类输入最终都交给 claude -p 执行，claude 再通过 browser-harness 以 CDP over wss 驱动 Browser Use Cloud 上的浏览器。代理的工作目录和状态位于 /home/bux（持久化），每次会话前 claude 会加载 agent/CLAUDE.md 作为上下文，可编辑该文件来调整工作目录布局、技能策略和允许的工具，重跑 install.sh（幂等）后下一轮生效。当 claude 遇到登录墙、2FA 或 CAPTCHA，会输出实时查看 URL 并暂停等待用户接管。
- 运营或销售团队希望用 Telegram 直接指挥一个能登录后台、填表、抓页面的常驻代理，而不必每次都开电脑。
- 自动化工程师想在一台便宜的 Hetzner 或 DigitalOcean VPS 上跑 7×24 的 Playwright 风格浏览器任务，并保留长期登录态。
- 个人开发者用 Mac mini 或树莓派作宿主，把浏览器自动化和 Claude Code 放在家里常驻，需要时通过网页终端远程接入。
- 需要人工接管的场景（验证码、两步验证），希望代理停下来给一个实时查看链接而不是尝试绕过。
- 想把 agent/CLAUDE.md 当作可版本化的行为配置，团队按项目定制工具白名单和工作目录规范。
如何安装或部署这个 Agent？
要求：一台 Ubuntu 22.04+ 主机（≥2GB 内存，$5 VPS 即可）、Browser Use Cloud API key、Anthropic API key 或 Claude Max 订阅；Telegram 为可选。
在目标机器上执行一行安装（需 sudo）：
curl -fsSL https://raw.githubusercontent.com/browser-use/bux/main/install.sh \
| sudo BROWSER_USE_API_KEY=bu_xxx bash如需启用 Telegram bot，额外传入从 @BotFather 获取的 token：
curl -fsSL https://raw.githubusercontent.com/browser-use/bux/main/install.sh \
| sudo BROWSER_USE_API_KEY=bu_xxx TG_BOT_TOKEN=xxx bash安装后验证服务状态，并切换到 bux 用户完成 Claude 登录：
systemctl is-active bux-browser-keeper bux-ttyd
sudo -iu bux
claude /login完整安装与排错说明见仓库内的 install.md。
如何使用这个 Agent？
登录完成后，先做一次连通性验证（提示 claude 访问页面并回报标题）：
claude "visit https://browser-use.com and report the page title"也可以通过把一段设置提示粘贴进本机的 Claude Code，让它 SSH 到远程机器代为完成安装、服务检查与 /login 流程：
Set up https://github.com/browser-use/bux on my remote box.
SSH into it (I'll paste the host below), run install.sh with my BROWSER_USE_API_KEY, and optionally wire up a Telegram bot if I give you a token from @BotFather. Read install.md first. After the install completes, verify the services are running (systemctl is-active bux-browser-keeper bux-ttyd), then become the `bux` user and run `claude /login` so I can complete the OAuth flow. Once logged in, test the setup by asking claude to visit https://browser-use.com and report the page title.要调整代理行为，编辑 agent/CLAUDE.md（工作目录布局、技能策略、允许的工具），然后重跑 install.sh 使其生效——脚本是幂等的，下一轮 claude 会话即读取新配置。日常交互可通过 Telegram bot 发消息，或访问仅绑定 localhost 的 ttyd 网页终端。
这个 Agent 有哪些优点和局限？
- 状态放在 /home/bux 并持久化，重启后 cookie、登录和聊天记录仍在，适合长期常驻任务。
- 浏览器会话通过 browser-harness 走 Browser Use Cloud，可用其免费额度中的 3 个并发浏览器、代理和验证码处理能力。
- 安装是一条 curl 命令，服务以三个 systemd 单元管理，并提供了 systemctl is-active 这类可验证的健康检查。
- 遇到登录墙、2FA、CAPTCHA 时提供实时查看链接并等待人工接管，而非使用硬编码凭据绕过。
- agent/CLAUDE.md 是可编辑、可版本化的行为配置，重跑幂等安装脚本即可下发。
- 核心浏览器能力依赖 Browser Use Cloud 和有效的 API key，无法脱离该服务独立运行浏览器自动化。
- 代理运行时绑定 Claude Code 与 Anthropic 凭据（API key 或 Claude Max 订阅），换模型供应商需要改代码。
- 宿主必须是 Ubuntu 22.04+ 且至少 2GB 内存，未说明对其它操作系统的支持。
- 安装过程含 sudo、systemd 服务与交互式 claude /login OAuth，无法完全无人值守完成。
- Telegram 与 ttyd 入口的安全边界（ttyd 只绑 localhost）需要在自托管环境中自行加固。
- 面向团队的托管试点为 $1,000/月，README 未给出该服务的功能与自建版本的逐项对照。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Browser Use Box 当前 | 34 · 缺口较多 | — | ★ 459 | 6 天前 | Python | Claude Code · Claude API |
| Atomic Agent – 本地优先的 AI 代理 | 56 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 3.5k | 今天 | TypeScript | — |
| Opensteer | 49 · 缺口较多 | 命令行工具免费 | ★ 204 | 今天 | TypeScript | — |
| Browser Use | 47 · 缺口较多 | 云服务 / SaaS免费版 + 付费版 | ★ 119k | 2 天前 | Python | Codex · Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 显示安装脚本以 sudo 运行、创建 bux 用户与 systemd 服务，但未提供最小权限说明（服务以何用户运行、ttyd 绑定范围仅口头称 localhost）；无回滚/卸载流程；敏感数据（BROWSER_USE_API_KEY、TG_BOT_TOKEN、Claude 登录态）仅说明写入 /etc/bux/env 与 /home/bux，未说明加密或访问控制；依赖安全无锁定或审计证据；外部效应（浏览器自动化、Telegram 发消息）无确认机制描述。仅 README 与 CI 有部分线索，故各项低分。
CI 有 shellcheck、py_compile、ruff 与安装冒烟测试，说明基本自洽性；但依赖版本未固定，失败信息与重试/恢复策略在可见文件中缺失，故仅给薄分。
README 明确目标场景（Telegram 驱动的浏览器自动化、VPS 部署）与硬件要求，受众清晰；但能力边界、触发精度（何时交还人工、CAPTCHA/2FA 处理细节）仅一句带过，环境适配仅限 Ubuntu 22.04+，故中等偏低。
安装指南与 CI 冒烟测试较完整，LICENSE 为完整 MIT；但信息架构被大量营销落地页链接稀释，无版本号/CHANGELOG，维护责任仅指向未验证发布者，命名稳定性无证据。
产品价值主张清晰（24/7 浏览器代理 + Telegram），但输出可用性、边际价值与成本收益均无实测或示例输出支撑，仅有营销页面，故保守给薄分。
README 声明与 CI 步骤部分可交叉印证（服务名、文件路径），但大量托管试点与收益声明无仓库内证据，事实与推断未明确分离。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 安装脚本以 sudo 运行并创建系统服务，未见最小权限与卸载/回滚说明，部署前应自行审计 install.sh。
- API 密钥、Telegram token 与 Claude 登录态存放位置仅口头说明，未描述加密或访问控制。
- README 含大量托管试点营销链接与收益声明，缺乏仓库内可验证证据，勿据此推断可靠性。
- 发布者身份未经 FollowAgents 验证，维护责任与更新路径不明确。