Skip to main content

Documentation Index

Fetch the complete documentation index at: https://browseruse-0aece648-x402-sdk.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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.Eachtopupis5 of USDC on Base mainnet. Each top-up is 1. For the SDK API and protocol details, see the x402 guide.