Setup Guide

Installation in 5 minutes

Follow these steps to install Claudezilla and connect it to Claude Code. Works on macOS and Linux with Firefox 91+.

Then continue with native host setup below.

Native Host Setup

The extension needs a native messaging host to communicate with Claude Code.

Clone Repository

Clone Claudezilla from GitHub and navigate to the directory.

git clone https://github.com/boot-industries/claudezilla.git
cd claudezilla

Install Native Host

Run the install script for your platform. This sets up the native messaging host.

# macOS
./install/install-macos.sh

# Linux
./install/install-linux.sh

Configure Claude Code

Add Claudezilla to your MCP configuration at ~/.claude/mcp.json:

{
  "mcpServers": {
    "claudezilla": {
      "command": "node",
      "args": ["/path/to/claudezilla/mcp/server.js"]
    }
  }
}

Then install MCP server dependencies and restart Claude Code:

cd claudezilla/mcp && npm install

🔒 Enable Private Window Access

Claudezilla works best with private window permission. This gives Claude full browser control while keeping your automation isolated and secure.

Open Extension Settings

Navigate to Firefox Add-ons manager.

New Tab

Add-ons and Themes

Settings

about:addons

Find Claudezilla Extension

Locate "Claudezilla" in your installed extensions list.

🔒

Privacy Badger

Blocks invisible trackers

🦖

Claudezilla

Browser automation for Claude Code

🎨

Dark Reader

Dark mode for every website

Enable Private Window Permission

Click on Claudezilla details, then toggle "Run in Private Windows" to ON.

🦖

Claudezilla

by boot.industries

Run in Private Windows

This extension will be able to read and change data in private windows.

⚡ Why Private Windows?

Private window permission allows Claude to create and control browser tabs without interference. You can still use Claudezilla without this permission, but some features will be restricted. You can enable this anytime from about:addons.

Verify Installation

Test that everything is working correctly.

✓

Test with Claude

Open Claude Code and try a simple command:

"Claude, open https://example.com and take a screenshot"

If Claude can open Firefox and capture a screenshot, you're all set!

🔧 Troubleshooting

Check /tmp/claudezilla-debug.log for connection issues. Verify the extension is visible in about:addons. Restart Claude Code after any MCP configuration changes.

☕ Support This Project

Claudezilla is free and open source. Your support helps keep it that way.

☕ Buy Me a Coffee

One-time or monthly contributions via Stripe