Bridge Mode

Remote Control & Remote Collaboration

Bridge Mode exposes a remote control surface over a WebSocket connection. It is designed to be used by a mobile/web app to send commands and receive information from a running Claude Code session.

Architecture

Bridge mode creates a WebSocket server that runs alongside the main Claude Code session. Remote clients connect to this server and can send slash commands, receive responses, and interact with the running session. The bridge also supports session sharing for team collaboration.

Quick Start

# Enable bridge mode
export BRIDGE_MODE=1
claude --bridge

# Connect from another terminal
claude --remote ws://localhost:18790

Features

Remote Control — Send commands from mobile/web/CLI clients
Session Sharing — Share your session with team members
Team Onboarding — Invite teammates to collaborate
Secure — OAuth-based authentication for remote connections

Security Note Bridge mode is designed for trusted networks. Use appropriate security measures when exposing the WebSocket server to external networks.