npx claude-code-remote

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

npx claude-code-remote

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:

brew install cloudflared

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