Claude Surf

Claude-Surf: A Claude Code plugin for controlling browser and real-time previewing

English | 简体中文

Overview

Claude-Surf is a Claude Code plugin that bridges Claude with VibeSurf, enabling powerful browser automation and web interaction capabilities.

What You Can Do

- Browser Control - Navigate websites, interact with elements
- VibeSurf Skills - Search, crawl, extract data, summarize content, fetch url content
- Workflows - Execute pre-built automation workflows
- App Integrations - Gmail, GitHub, Slack, Supabase and 100+ apps via Composio/MCP
- Browser-Use Agent - Parallel multi-task automation using AI sub-agents
- Website API - Platform APIs for XiaoHongShu, YouTube, Douyin, Weibo, Zhihu, etc.

Prerequisites

1. Claude Code
Install Claude Code CLI.

2. VibeSurf

Choose one of the following installation methods:

Local Installation (Control Local Browser)
Use this method to control your local browser:

Docker Installation (Control Sandbox Browser)
Use this method to control a sandboxed browser in a container:

VibeSurf must be running for Claude-Surf to work.

Configuration: By default, Claude-Surf connects to http://127.0.0.1:9335. You can customize this by setting the VIBESURF_ENDPOINT environment variable before starting Claude Code:

Installation

From GitHub Marketplace (Recommended)

Local Installation

Restart Claude Code to load the plugin.

Quick Start

After installation, try a simple example:

This will use VibeSurf to search for today's AI news and return summarized results.

VSCode Integration with Real-Time Browser Preview

When using the Docker installation, you can control and preview the browser directly in VSCode alongside Claude Code:

Open the Internal Browser

1. Open the Command Palette:
   - Windows/Linux: Ctrl + Shift + P
   - macOS: Cmd +…