Skip to content

Mokocoder/remote_claude

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

remote_claude

A claudeload plugin that mirrors your Claude Code terminal to a browser over WebSocket.

Built out of a practical need on Windows without WSL — attaching a second interface to a running Claude session without leaving the terminal. Windows-friendly remote services fall short when you want to fluidly use CLI interactions like /revert, approve prompts, or navigate history from another device or window. This fills that gap with a lightweight web client that stays in sync with the host process.

example


Requirements


Install claudeload

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/LabGuy94/claudeload/master/install.sh | sh

Windows (PowerShell)

iex "& { $(iwr -useb https://raw.githubusercontent.com/LabGuy94/claudeload/master/install.ps1) } -AddToPath"

Install the plugin

claudeload plugin add remote-claude.js

The plugin loads automatically on every claude invocation from that point on.


Connecting

On startup, the access URL is printed to the terminal:

  Claude Remote (mirror-only, token-auth)
  http://192.168.0.10:3456?token=xxxxxxxxxxxxxxxxxxxxxxxx

It's also written to a file relative to wherever claude was invoked:

.remote-claude/
└── 3456.txt

Open the URL in any browser to connect.


Configuration

All settings are optional. Defaults work out of the box.

Variable Default Description
CLAUDE_REMOTE_PORT 3456 Bind port
CLAUDE_REMOTE_PORT_FALLBACK_MAX 20 How many ports to try if the first is taken
CLAUDE_REMOTE_TOKEN random Pin a fixed access token
CLAUDE_REMOTE_REQUIRE_TOKEN 1 Set to 0 to disable token auth
CLAUDE_REMOTE_INCLUDE_STDERR 1 Set to 0 to suppress stderr mirroring
CLAUDE_REMOTE_STALE_CLIENT_MS 7000 Idle client eviction timeout (ms)
CLAUDE_REMOTE_FORCE_REDRAW_ON_AUTH 1 Trigger a redraw when a client connects

Uninstall

claudeload plugin remove remote-claude.js

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors