›_ Claude Code Issues
Claude Code Issues / #29479

[DOCS] Remote Control confirmed working on headless Linux VM via SSH + tmux

Resolved 💬 2 comments Opened Feb 28, 2026 by graemejross Closed Mar 28, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

_No response_

Section/Topic

remote-control

Current Documentation

_No response_

What's Wrong or Missing?

Remote Control confirmed working on headless Linux VM via SSH + tmux

Summary

Just wanted to share a positive finding: Remote Control works perfectly on a headless Debian 12 VM accessed via SSH and tmux. This setup isn't covered in the official documentation but works without any issues.

Setup

MacBook (iTerm2) → SSH (Tailscale VPN) → Debian 12 VM (clarence) → tmux → Claude Code v2.1.62
  • VM: Debian 12 (6.1.0-40-amd64), headless, no display server
  • Access: SSH over Tailscale from MacBook
  • Session manager: tmux
  • Claude Code: v2.1.62, Max plan, authenticated via claude.ai
  • Terminal: tmux-256color

What was tested

  1. Started Claude Code session in tmux on the remote VM
  2. Ran /remote-control from within the active session
  3. Status bar showed "Remote Control active"
  4. Connected from MacBook browser via claude.ai/code
  5. Full conversation history synced to browser
  6. Sent images from browser back to the terminal session (drag & drop)
  7. Bidirectional interaction works — can type in either terminal or browser

Screenshots

Terminal showing "Remote Control active" in status bar, and claude.ai/code showing the same session with "clarence" identified as the connected machine — both working simultaneously.

Suggestion

Consider adding a note to the Remote Control documentation that it works via SSH + tmux on headless servers. This is a common setup for developers who run Claude Code on remote infrastructure.

Environment

  • OS: Debian 12 (Linux 6.1.0-40-amd64)
  • Claude Code: 2.1.62
  • Node: v22.x
  • Subscription: Max plan

Suggested Improvement

This feature is brilliant. Thanks!

Impact

Low - Minor confusion or inconvenience

Additional Context

<img width="1456" height="2000" alt="Image" src="https://github.com/user-attachments/assets/298fca09-7387-4420-bc82-b72d8fd25556" />

<img width="2000" height="1706" alt="Image" src="https://github.com/user-attachments/assets/714e465f-36ad-4f42-b628-a1a5dde3833d" />

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗