Skip to main content
Claude Code is Anthropic’s agentic coding tool that runs in the terminal. Add Browser Use and it gets full cloud browser automation — anti-detect profiles, CAPTCHA solving, residential proxies in 195+ countries, persistent profiles, and stealth browsing.

​
Setup

1. Install the CLI 
curl -fsSL https://browser-use.com/cli/install.sh | bash
2. Verify the installation 
browser-use doctor
3. Install the skill The Browser Use skill teaches Claude Code the full CLI command set. Install it from skills.sh: 
npx skills add https://github.com/browser-use/browser-use --skill browser-use
4. Connect to cloud browsers Sign up at cloud.browser-use.com and connect: 
browser-use cloud login <your-api-key>
browser-use cloud connect
Or let Claude Code provision a free API key itself — see Agent Self-Registration below. 5. Use it Claude Code uses its bash tool to run CLI commands directly: 
> Use browser-use to open github.com/trending and summarize the top repos
For the complete CLI reference and advanced features like sessions, tunnels, and Python execution, see the Browser Use CLI docs.

​
Agent Self-Registration

Claude Code can provision its own Browser Use API key autonomously — no human interaction needed. The free tier includes unlimited browser hours, free proxies in 195+ countries, persistent browser profiles, CAPTCHA solving, and stealth browsing at zero cost. Install the Browser Use CLI: 
curl -fsSL https://browser-use.com/cli/install.sh | bash
Claude Code runs two CLI commands using its bash tool: 1. Request a challenge 
browser-use cloud signup
Returns a Challenge ID and Challenge — an obfuscated math problem that requires LLM reasoning to solve. 2. Solve the challenge and verify Claude Code solves the math problem, then verifies with the answer (a string with 2 decimal places, e.g. "13.60"): 
browser-use cloud signup --verify <challenge-id> <answer>
The CLI saves the API key to ~/.browser-use/config.json automatically. No extra configuration needed — Claude Code can start using cloud browser commands immediately.

​
Claim the account (optional)

If the human wants to see the account in the dashboard later: 
browser-use cloud signup --claim
Returns a claim URL valid for 1 hour. The human can follow the link to sign up and claim the agent-created account.

​
Pay with USDC via x402

Two ways to use x402 with Browser Use Cloud:
  • Top up an existing account — add credits to your API key (e.g. one created via Agent Self-Registration above) using USDC. No credit card required. Use this when free credits run out.
  • Accountless — wallet IS the identity, no signup needed. Pure x402 / agent-economy native. Use this for autonomous agents that hold their own wallet.
Install the skill: 
npx skills add https://github.com/browser-use/browser-use --skill x402
Then in Claude Code: 
> /x402
The skill asks whether you have an existing API key (top-up mode) or want accountless mode, then walks you through generating (or importing) an EVM wallet, funding it via Coinbase, and running a verification task. You’ll need ~5ofUSDConBasemainnet.Eachtop−upis5 of USDC on Base mainnet. Each top-up is 1. For the SDK API and protocol details, see the x402 guide.