Run Claude Code on a VPS in a supported region
Instead of dressing up the laptop at home, do signup and everyday work on a machine that already sits in a region Claude supports. Hong Kong is not one of those choices here.
Rent a VPS with at least 8 GB of RAM in a supported region (Japan, Singapore, Korea, the US, and similar — not Hong Kong). Put it, your laptop, and your phone on one Tailscale tailnet. Run Orca as a systemd service on the VPS and render its built-in browser on the server. Register, subscribe, and run Claude Code there. This does not promise that an account will be accepted.
A real machine, not a costume
Changing the laptop's timezone while the browser and the exit disagree is a costume. Here the public IP, the clock, and the browser that talks to Claude all belong to the VPS. The laptop only displays the picture and sends commands.
A dedicated VPS also keeps a stable exit of its own, and systemd restarts the process if it dies. The other new page, Claude Cage, is an open-source desktop app that isolates a guest and forces that guest through a proxy you supply. Both are setups, not exemptions from region rules.
How the pieces connect
- VPS. 8 GB or more, x86_64, Debian 13 is the system this walkthrough assumes. Claude Code and
orca serveare systemd units. - Tailscale. Laptop, phone, and VPS share a tailnet. Port 6768 should be reachable only inside it.
- Orca. A remote server on the VPS. The laptop pastes a pairing link; the phone scans a different code. The built-in browser is set to render on the server, so pages use the VPS network.
The hostname cc-vps and the user orca are examples. If you rename them, change the Tailscale node, the SSH name, and --pairing-address together.
What a person has to do
- Buy the VPS and pick Debian 13.
- Run
ssh-copy-idin your own terminal. Generate a key withssh-keygen -t ed25519there too, not inside an agent that has no interactive terminal. - Approve Tailscale once. Delete any old offline node that already owns the name, or the new one becomes
cc-vps-1. - Paste the pairing link in Orca on the Mac, and set page rendering to Server.
- Create and pay for the Claude account, and finish Claude Code login in Orca's browser.
- Scan the phone pairing code.
Do not hand passwords, one-time codes, or card numbers to an assistant. SSH stays key-based.
Safety rules
- Do not publish port 6768. No public firewall rule for it.
- SSH keys only.
- Do not kill a running
orca serve. Restart withsudo systemctl restart orca-serveonly.pkill -f orcadrops every Claude Code session on that box. - Before you close public SSH (
ufw delete allow 22/tcp), provessh orca@cc-vpsworks over Tailscale, and keep the provider's web console or VNC as a fallback.
Five steps, then daily use
0. Choose the machine
8 GB, a supported region, Debian 13 available, in stock. Latency notes the author keeps are at vps.appsail.dev. After you have an IP:
ssh-copy-id root@<VPS IP>
Done when ssh root@<IP> 'cat /etc/os-release; nproc; free -g; uname -m' connects with a key and shows Debian 13, about 8 GB, x86_64.
1. Bootstrap and Tailscale
timedatectl set-timezone Asia/Tokyo
hostnamectl set-hostname cc-vps
loginctl enable-linger orca
curl -fsSL https://tailscale.com/install.sh | sh
tailscale up --ssh --hostname=cc-vps
tailscale up waits until you approve it. Install Tailscale on the laptop and phone under the same account. Then:
ufw default deny incoming
ufw default allow outgoing
ufw allow 22/tcp
ufw allow in on tailscale0
ufw enable
Done when tailscale ip -4 is in 100.0.0.0/8, the node name is cc-vps, linger is yes, ssh orca@cc-vps works, and ufw status denies inbound except 22/tcp and the tailscale interface. The timezone matches the datacenter.
2. Orca as a remote server
Run the extracted binary, not the AppImage, so you do not leave a FUSE mount in /tmp:
mkdir -p ~/.orca && cd ~/.orca
curl -fL -o orca-linux.AppImage https://github.com/stablyai/orca/releases/latest/download/orca-linux.AppImage
chmod +x orca-linux.AppImage
rm -rf squashfs-root app && ./orca-linux.AppImage --appimage-extract
mv squashfs-root app
~/.orca/app/resources/bin/orca-ide --version
Write /etc/systemd/system/orca-serve.service:
[Unit]
Description=Orca remote server (orca serve)
After=network-online.target tailscaled.service
Wants=network-online.target
[Service]
User=orca
WorkingDirectory=/home/orca
EnvironmentFile=-/etc/orca-serve.env
ExecStart=/home/orca/.orca/app/resources/bin/orca-ide serve --port 6768 --pairing-address cc-vps $ORCA_EXTRA
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now orca-serve
Pair from the Mac: Settings → Remote Orca Servers → paste the orca://pair?... link from the journal. Then set “Where pages render” to Server (streamed) and reopen any page that was already open. Pairing uses the Tailscale name, not the 100.x address. Linger from step 1 is what keeps terminals alive across an Orca restart.
Done when the unit is active and enabled, something listens on 6768, the advertised endpoint is ws://cc-vps:6768, and ufw has no public 6768 rule.
3. Account, subscription, Claude Code
Stay inside Orca connected to the VPS. Do not switch to the laptop's Chrome.
Open https://ipinfo.io in the built-in browser. The address must be the VPS public IP and the region must be the datacenter. A home IP means rendering is still local. Use a site outside your country; local IP-lookup sites often bypass a proxy and report the laptop. Turn the laptop proxy off before you check.
Create the Claude account in that same browser. Install Claude Code as the orca user:
curl -fsSL https://claude.ai/install.sh | bash
Put ~/.local/bin on PATH in both ~/.profile and ~/.bashrc. A free account cannot run Claude Code; you need at least Pro. Pay with a card issued in a supported region. This page does not recommend a card vendor. Apple Pay on the Linux browser is covered below.
When Claude Code prints an auth link, open it in Orca's browser, not the system browser. If a later wizard appears after claude auth login, the account is still there: back up ~/.claude.json and set hasCompletedOnboarding to true.
Done when the exit IP is the VPS, command -v claude is ~/.local/bin/claude, claude auth status shows a claude.ai subscription (not a Console API key), and a one-line prompt gets a reply.
4. Phone
The desktop pairing link and the phone QR code are different credentials. Temporarily start with mobile pairing, scan, then remove the flag. Existing desktop pairings stay.
echo 'ORCA_EXTRA=--mobile-pairing' | sudo tee /etc/orca-serve.env
sudo systemctl restart orca-serve
# scan the code from the journal, then:
sudo rm /etc/orca-serve.env && sudo systemctl restart orca-serve
You confirm this yourself: the phone shows the same projects, and closing the laptop does not drop the session.
5. Day to day
Work in Orca on the laptop or phone, or drive the VPS over SSH:
ssh orca@cc-vps orca agent-context
Useful commands, with flags from --help: orca worktree ps, orca terminal list, orca terminal read, orca terminal send, orca terminal wait --for tui-idle, orca worktree create --name <name> --agent claude.
New Claude Code sessions inside Orca skip permission prompts. That belongs on this isolated VPS, not on a laptop full of personal keys. Research and drafts can finish unattended; sending, publishing, spending, and production changes stay with you. Bring code home with git. Syncthing on the tailnet is the live-sync option.
Apple Pay through a Tailscale exit node
The Linux browser will not offer Apple Pay. Advertise the VPS as an exit node, approve it in the Tailscale admin, point the iPhone at it with other VPN apps off, and pay in a private Safari tab after ipinfo.io shows the VPS. Turn the exit node off when you are done. Private mode avoids cookies left from an earlier network.
# /etc/sysctl.d/99-tailscale.conf
net.ipv4.ip_forward = 1
net.ipv6.conf.all.forwarding = 1
sysctl -p /etc/sysctl.d/99-tailscale.conf
tailscale set --advertise-exit-node
FAQ
Does this stop bans?
No. It only places the environment on a machine that is physically in a supported region. Anthropic still applies its own region terms.
Do I need Tailscale if I already have a VPS?
No. SSH attach works, and --pairing-address can be a public name, but then the phone cannot share the desktop session, or you must lock down port 6768 yourself. Tailscale keeps that port off the public internet.
Private git clone says repository not found?
The GitHub user on the VPS cannot see the repo. gh auth login as an account that can, then gh auth setup-git.
How does this relate to Claude Cage?
Claude Cage is an open-source app that isolates a guest VM, or a rootless container on a server you already have, and sends that guest through a proxy you configure. This page is a VPS you rent in a supported region, with the browser and Claude Code living on that box. Neither is a guarantee.