Run Claude Code inside a Docker container while controlling Chrome on your host machine.

Python port of claude-code-remote-chrome.

Claude Code has a "Claude in Chrome" feature that lets it control your browser — navigate pages, fill forms, take screenshots, etc. Normally this only works when Claude Code runs directly on your machine. This project bridges that gap so Claude Code running in a container can talk to Chrome on your host.

A Python bridge in the container and a Python script on the host forward messages between them:

Container                          Host
Claude Code                        Chrome
    |                                |
    v                                ^
bridge_container.py  --TCP:9229-->  bridge_host.py
(Unix socket)                      (Unix socket)

• Docker (Docker Desktop, OrbStack, or similar)
• Python 3.8+ on the host (for bridge_host.py)
• Chrome with the Claude browser extension installed
• Claude account credentials

1. Create .env.local with your OAuth token:

   CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-...
   

   Get your token by running claude setup-token on your host, or copy the accessToken value from ~/.claude/.credentials.json.

2. Build and start the container:

   make up

3. Start the host bridge (separate terminal):

   python3 bridge_host.py

4. Inside the container, start Claude (the bridge starts automatically via entrypoint):

   claude --chrome

5. Ask Claude to do something in Chrome, e.g. open google.com.

• "Extension not detected" — Make sure bridge_host.py is running on the host and Chrome has the Claude extension active.
• Bridge container can't connect — Verify bridge_host.py is listening on port 9229.
• Username mismatch — The USER env var in the container must match the socket directory name. It defaults to claude.