C.W.K.
Stream
Lesson 01 of 06 · published

What Claude Remote Solves

~14 min · remote, session-handoff, portable-session

Level 0🌱 Novice
0 XP0/70 lessons0/11 achievements
0/120 XP to next level120 XP to go0% complete

The session is the unit, not the machine

Claude Remote (also called Claude Code Remote Control, launched February 2026) treats an AI coding session as a portable, transferable artifact. You start it on your laptop, hand it off to a GPU-equipped cloud VM for heavy work, resume on your tablet — all with the conversation history, file references, and tool state intact. Sub-100ms resume latency on the receiving end.

The problem it eliminates: the false choice between "run locally on a weak machine" and "SSH into a beefy server and lose local context." Remote keeps both — the session moves; the context moves with it. State serialization → encrypted transport → remote resumption, no re-indexing.

Common shape: prototype on the laptop (free local files, fast iteration), hand off to a cloud VM when the test suite gets heavy (free up the laptop), resume on phone to monitor (no SSH client app needed). One coherent session across three devices.

Code

Three-stage handoff·text
1. State serialization
   • file tree references + open file contents
   • full conversation history
   • tool configurations, env vars
   • pending operations
   → compressed encrypted payload

2. Encrypted transport
   • SSH or dedicated secure channel
   • payload travels E2E-encrypted
   • Anthropic's coordination layer can't read contents

3. Remote resumption
   • decompress + restore session on target
   • <100ms typical resume latency (after payload arrives)
   • zero re-prompts, zero re-indexing
Quick-start commands·bash
# Register a remote target (Claude Code Desktop UI also works)
# Settings → Remote → Add SSH Connection

# CLI handoff
claude remote handoff --destination ubuntu@54.234.12.99

# List active connections
claude remote list

# Disconnect & resume locally
claude remote disconnect

# Run Claude Code remotely without handoff (just SSH)
ssh ubuntu@54.234.12.99 "claude --project /home/ubuntu/myproject"

External links

Exercise

Pick a real session (in a real repo). Start it on your primary machine, hand it off to a second machine you have access to (even another laptop on your LAN counts). Verify the conversation history and open files came along. Hand it back.

Progress

Progress is local-only — sign in to sync across devices.
Spotted a bug or have feedback on this page?Report an Issue

Comments 0

🔔 Reply notifications (sign in)
Sign inPlease sign in to comment.

No comments yet — be the first.