That's it. Scan the QR code and you're in.
What You Get
🖥️ Full Terminal Access — Not a chat wrapper. A real terminal running on your machine. Read files, run commands, access your .env — everything works.
📂 Any Project, Any Directory — Open projects from anywhere on your machine. Just type the path (with autocomplete) and you're there.
🗂️ Unlimited Sessions — Open as many tabs as you want. Different projects, different conversations, all running in parallel.
💾 Session Persistence — Start a session, put your phone down, come back hours later. Your work is right where you left it.
🌐 Dev Server Preview — Building a UI? Preview your local dev server right in the app. Hot reload and all.
✨ Zero Config Remote Access — Uses Cloudflare Tunnel automatically. No port forwarding, no firewall headaches, no ngrok fees.
Getting Started
Or install globally:
npm install -g claude-code-remote claude-remote
You'll see:
┌────────────────────────────────────────────┐
│ Claude Code Remote │
│ ───────────────── │
│ Local: http://localhost:3456 │
│ Remote: https://abc123.trycloudflare.com │
│ │
│ ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ │
│ █ ▄▄▄▄▄ █ ▀ █ █ │
│ █ █ █ █▀ ▄▀██ │
│ █ █▄▄▄█ █▀▀▄▄██ │
│ ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ │
│ │
│ Scan to connect │
└────────────────────────────────────────────┘
Scan the QR code. Done.
Requirements
- Node.js 18+
- cloudflared (optional, for remote access)
Installing cloudflared
macOS:
Linux:
# See https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation/Without cloudflared, you can still use it locally or set up your own tunnel (ngrok, Tailscale, etc).
Linux build dependencies
Linux may require build tools to compile the native terminal module:
sudo apt install -y build-essential python3
License
MIT