Claude Code Bridge

Your code lives on a remote dev server. Your database runs in Docker. Your staging environment sits in a cloud VM. Without direct access, you're stuck SSHing in manually or running separate Claude sessions on each machine.

Claude Code Bridge solves this by connecting your local Claude Code to remote environments via WebSocket. Once connected, Claude gains the ability to read, write, list, and delete files on any remote machine as if they were local.

How It Works

Bridge runs in two modes: host and client.

The host runs on your local machine alongside Claude Code. It exposes MCP tools that let Claude interact with connected remotes.

The client runs on your remote machine, container, or server. It executes file operations and sends results back to the host.

Setup

Install the package globally, add it as an MCP server, and start the host with Claude Code. On your remote machine, connect the client using your local machine's IP address.

That's it. Claude Code now has file access to the remote environment.

What Claude Can Do

Once connected, Claude gains these MCP tools:

• bridge_read_file - Read any file on the remote
• bridge_write_file - Create or modify files
• bridge_delete_file - Remove files
• bridge_list_directory - Browse directories
• bridge_status - Check connection status

You can ask Claude to edit a config file on your dev server, inspect logs in a container, or update code on a cloud VM. All without leaving your local session.

Use Cases

Remote development servers — Edit files without SSHing in
Docker containers — Modify code from outside the container
Multi-machine projects — Manage microservices across different hosts
Cloud VMs — Work on EC2 instances from your laptop
CI/CD debugging — Fix files on build servers

Client Console

The remote client shows all incoming tasks in real-time. You can watch Claude work across machines as commands flow through.

Configuration

You can create a config file at ~/.claude-bridge/config.yml for persistent settings like instance name, port, host, and task timeout.

Requirements

Node.js 20 or higher
Claude Code with MCP support

The full CLI reference, troubleshooting tips, and advanced configuration options are in the README.

Links

• npm package
• GitHub repository
• Report issues