Browser Use Box installs an always-on Claude Code agent with a real browser on a server you own. You point one install script at any Ubuntu machine with 2 GB or more of RAM, such as a low-cost VPS, a Mac mini, or a Raspberry Pi, and then message the agent from anywhere.
The install sets up three systemd services: a Telegram bot (telegram_bot.py), a web terminal (ttyd) bound to localhost, and a browser keeper. Messages flow into claude -p, which drives a Chromium session through browser-harness connected to Browser Use Cloud over CDP. Agent state lives in /home/bux, so cookies, skills, and chat history survive reboots. The agent's per-session context is in agent/CLAUDE.md, which you edit to change working-directory layout, skill policies, and allowed tools; rerunning the idempotent installer applies the change.
When the agent hits a login wall, 2FA, or a CAPTCHA, it sends you a live view URL and waits for you to complete the step rather than attempting workarounds. A managed alternative provisions the same setup on Browser Use Cloud, and a paid managed pilot targets teams that run operations in Telegram.
Features
- One-script install: install.sh with a BROWSERUSEAPI_KEY sets up the box; a Claude Code setup prompt can run it over SSH for you
- Persistent browser: a Chromium session via browser-harness where cookies and logins persist
- Telegram bot: pass TGBOTTOKEN to the installer to text your agent
- Web terminal: a localhost-bound ttyd session as an alternative to SSH
- Human handoff: live view URL on login, 2FA, or CAPTCHA walls
- Persistent state: /home/bux holds cookies, skills, and chat history across reboots
- Customizable context: edit agent/CLAUDE.md and rerun the installer
- Requirements: Ubuntu 22.04+, a Browser Use Cloud API key, and an Anthropic API key or Claude Max subscription
