Skip to main content
In this guide, we’ll cover the basics of using Browserbase. By the end, you’ll run your first browser session and have a basic understanding of how to use Browserbase.
Using Claude Code, Cursor, or another coding agent? Paste this into your prompt to browse the web, debug sessions, and manage your entire project via our CLI:
Read https://browserbase.com/SKILL.md to set up Browserbase

​
Creating Your Account

First, you need to sign up for a Browserbase account. The free plan includes:
  • One browser session running at a time
  • 60 minutes of browser time per month
Having trouble with phone verification? Reach out via our support portal or email support@browserbase.com.

​
Overview Dashboard

The Overview Dashboard is the first page you’ll see when you log in to Browserbase and click into a project. It gives you a quick overview of your browser sessions, usage, and status for that project.
On the overview page, you’ll find:
  • Your project ID and API key are on the right side
  • List of currently running and recently completed sessions
  • Historical usage statistics
  • Performance metrics
  • Current system status

​
Using the Playground

Next, you’ll go to the Playground, which provides a quick way to try Browserbase directly in your browser. It’s a great way to get started and see how Browserbase works.
  1. Navigate to the Playground
  2. Command + Click on one of the templates in the code editor
  3. Click the “Run” button to start a browser session, this will start a new browser session and run the code in the editor.
  4. Watch the session via the Live View on the right and interact with the browser.
  5. Once the session is complete, click the “Stop” button to shut down the browser.
After completing a session in the Playground, click the “View Session” button to open the Session Inspector.

​
Session Inspector

You can use the Session Inspector to watch sessions in real-time, view replays, or inspect the session logs.

​
Sessions List

You can always find a list of your sessions in the Sessions tab. From there, you can access the Session Inspector for any session.
If you know your session ID, you can also access the Session Inspector by navigating to https://www.browserbase.com/sessions/[session-id].

​
Next Steps

Running your first session in the Playground is a great way to get started. However, you’ll likely want to integrate Browserbase into your own codebase. You have two main approaches:
  1. Direct Session Control - Create browser sessions and control them directly with your preferred automation framework
  2. Serverless Functions - Deploy browser automation as serverless functions that can be invoked via API

​
Using Browser Sessions

The first step is to select a browser automation framework you’ll want to use to control the browser. Browserbase supports all popular frameworks. As well as many integrations with popular tools. Choose the framework that best matches your needs and follow the framework-specific quick start guide to get a Browserbase project setup in your local development environment.
If you’re not sure which framework to use, Stagehand is recommended as it’s built and maintained by the Browserbase team.

Stagehand

Recommended for AI-Native Workflows
  • Javascript and Python support
  • Self-healing page automations
  • LLM-powered browser control
  • AI-first architecture

Playwright

Recommended for Traditional Automation
  • Javascript, Python, Java, and C# support
  • Static workflow definitions
  • Robust testing capabilities
  • Extensive API support

Puppeteer

Recommended for Puppeteer Users
  • Javascript support
  • Static workflow definitions
  • Robust testing capabilities
  • Extensive API support

Selenium

Recommended for Selenium Users
  • JS, Python, Java, C#, and Ruby support
  • Static workflow definitions
  • Robust testing capabilities
  • Extensive API support

​
Using Functions

For serverless workflows, webhooks, scheduled tasks, or API endpoints, Functions let you deploy automation directly to Browserbase’s infrastructure with zero server management.

Functions

Recommended for Serverless Workflows
  • Zero infrastructure management
  • API-invocable browser automation
  • Built-in session management
  • Perfect for webhooks and scheduled tasks

​
Use Browserbase with Claude Code

Give your coding agent a browser built for them.

Paste this into your agent to get started:
Read https://browserbase.com/SKILL.md to set up Browserbase