Before You Start

What you need

	Required?	Notes
A computer with Claude Code installed and signed in	Yes	macOS, Linux, or Windows. This is where the agent runs and where your projects live.
A phone / tablet / any browser	Yes	This is how you'll use it. Nothing to install — it's just a web page.
A small Linux VPS with a public IP	Only for self-hosting	The cheapest instance works. You can also use a hosted 16code server and skip the VPS entirely.
A domain name	Recommended for self-hosting	Needed for automatic HTTPS. An IP address works too, but without HTTPS.

The three pieces

┌───────── your VPS ─────────┐        ┌───── your computer ─────┐
│  code-server               │  WSS   │  code-agent             │
│  (web UI + relay + store)  │◄───────│  (runs Claude Code)     │
└────────────▲───────────────┘ dials  └─────────────────────────┘
             │ HTTPS            out
        your browser
   (phone / tablet / PC)

• The agent dials out. Your computer never opens an inbound port and doesn't need a public IP — it works behind home NAT, office firewalls, anywhere.
• The server is just a relay. Claude Code itself, your code, and your API credentials all stay on your computer.
• The browser is stateless. Close the tab, lose signal, switch devices — running tasks keep going on your computer, and the page restores everything when you come back.

Install order

1. Install the Server — one command on the VPS (skip if using a hosted server)
2. Install the Agent — one command on your computer
3. Sign In & Bind Your Machine — set a password, open the web UI

Each step takes a couple of minutes.