How to Run Coding Agents on a Remote Machine or Always-On Host (2026)
Run Claude Code, Codex, and other coding agents on a remote Linux server, shared host, or Mac mini, and keep them working when your laptop closes.
To run coding agents on a remote machine, put the agents and the repo on an always-on host (a Linux server, a cloud VM, or a Mac mini) and use your laptop only to prompt, review, and preview. Paradev has this built in: turn on Remote Access on a macOS or Linux machine, and it becomes a host in the same app as your laptop. Each agent gets its own worktree there, and you reach its terminals, diffs, and ports from the desktop app, the CLI, or the iPhone and iPad app, with no SSH setup.
The agents' own remote features still work on a Paradev host. Paradev runs the real claude and codex CLIs in real terminals, so Claude Code Remote Control (/remote-control) can follow a session on that host from the Claude app, and codex cloud exec can hand a task to Codex cloud. Use Paradev to run and track several agents across machines, and the agent's own feature when you want its app or its cloud. Other options are VS Code Remote-SSH, SSH plus tmux over Tailscale, and managed cloud agents such as Codex cloud or Cursor Cloud Agents. Pick by where you want the agent to run and how many agents you need to keep track of at once.
This guide answers the questions developers ask most about remote, always-on, and shared setups for parallel coding agents, with the tradeoffs of each option.
How do I switch between local and remote coding-agent work without a pile of SSH terminals?
Use one client that knows about every machine, so the machine becomes a filter and not a separate terminal window. SSH and Tailscale stay underneath as transport; you stop driving them by hand.
The options people use:
- VS Code Remote-SSH. It opens a folder on any machine with an SSH server and runs terminals and extensions there. Good when you have one remote box and work in one editor window per machine.
- SSH plus tmux. One tmux session per agent on the host. It costs nothing and works with any CLI agent, but you track the sessions yourself and there is no shared view of what each agent changed.
- Paradev. Each machine runs a host service. The desktop app's Workspaces page has a Device filter (This device, each remote host, or All devices), and every row shows which machine it lives on, dimmed when that device is offline. Open a remote workspace and you get its terminals, agent runs, and diff viewer through the Paradev relay, with no SSH config. The CLI takes the same choice as a flag:
--localor--host <id>.
Remote Access is a Pro feature. See Remote Access.
How do I control coding agents on a remote Linux server from my Mac?
Install the agent CLIs and the repo on the Linux server, then connect a Mac client that runs nothing heavy itself. Which client depends on how you like to work.
| Setup | Agents run on | Mac client | Good fit |
|---|---|---|---|
| VS Code or Cursor + Remote-SSH | Linux server | Editor | One remote project at a time, editor-first |
| SSH + tmux (+ Tailscale) | Linux server | Terminal | Full control, any agent, no extra software |
| Coder | Your infrastructure | Browser, IDE, or SSH | Teams that want templated workspaces per developer |
| Paradev | Linux server (host service) | Paradev desktop app, CLI, or iPhone and iPad app | Several CLI agents in parallel, each in its own worktree |
For Paradev on a Linux server, the CLI installer supports Linux on x64 and arm64. On a server with no browser, sign in with an API key from Settings → API Keys:
The host launches whichever agents are on its PATH: the docs list Claude Code, Codex, Cursor Agent, Amp, Gemini CLI, and OpenCode. The host also needs git and gh. The Mac then sees the server under Other devices in the Device filter. Details: Host Server.
How do I keep coding agents working when I close my laptop?
The agent process has to live on a machine that stays awake. Closing the lid on the machine that runs the agent stops the work, whatever client you use.
- Managed cloud agents (Codex cloud, Cursor Cloud Agents, GitHub Copilot's cloud agent). The vendor runs the task in its own VM and hands back a branch or PR. Least setup. You get only that vendor's agent and environment.
- Claude Code Remote Control. It lets you continue a Claude Code session from claude.ai/code or the Claude mobile app, but the session still runs on your own machine. Think of it as a remote screen for a local session, so it needs that machine awake and the
claudeprocess running. Run it on an always-on host if you want it to continue after you close your laptop. On a Paradev host, start Claude Code in a workspace and type/remote-control; Paradev's terminal daemon keeps the process running, which is what Anthropic's docs suggest tmux orscreenfor. - Your own always-on box + tmux. A Mac mini, a home server, or a cloud VM, reached over Tailscale or SSH. Use tmux or a system service so a dropped connection does not kill the agent.
- Paradev on an always-on host. Terminals and agents run in a terminal daemon on the host, separate from the host service. They keep running after
superset stop, and the nextsuperset startpicks them up. On Linux you can run the host under systemd so it starts at boot:
Keep KillMode=process; other modes stop every terminal and agent when the service restarts. Add --auto-update to a daemon start if you want the host to update itself.
You can then check on agents from your laptop when it wakes, or from Paradev for iPhone and iPad (Pro, iOS 26 or iPadOS 26 or later). Scheduled Automations also target a device, so a nightly run can fire on the always-on host. If that device is offline at fire time, the run fails and the next one is scheduled normally.
Can I use Claude Code Remote Control or Codex cloud on a Paradev host?
Yes. Paradev runs claude and codex in a login shell in a real terminal on the host, with the host user's own Claude and Codex logins, and it does not route their network traffic. We checked on October 14, 2026, with Claude Code 2.1.300 and Codex CLI 0.162.1 started in a Paradev workspace: /remote-control connected the session to claude.ai, and codex cloud list reached Codex cloud.
- Claude Code Remote Control follows one session from the Claude app. Per Anthropic's docs (accessed October 14, 2026), it needs a claude.ai login on a Pro, Max, Team, or Enterprise plan, not an API key or a third-party provider, and it is off when
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICis set. The terminal must stay open: closing its last pane ends theclaudeprocess. - Codex cloud runs the task in OpenAI's environment, so it keeps going while the host sleeps. From the host's terminal,
codex cloud execsubmits a task andcodex cloud applybrings the diff back into the workspace, where Paradev's Changes pane shows it. See OpenAI's Codex cloud docs.
Use Paradev to see every agent on every host in one place. Add Remote Control when you want the Claude app on one Claude Code session, and Codex cloud when a task needs nothing from the host.
Our team has a shared development machine. How do we give each agent a separate workspace?
Give every agent its own Git worktree and branch, and control who can reach the machine. Worktrees stop agents from editing the same files. They do not sandbox processes, so agents on one host still share CPU, memory, ports, and anything the host user can read.
Tools that handle the worktree part: plain git worktree with tmux, Claude Squad, Codex worktrees, VS Code agent worktrees, and Paradev. Dev containers or Coder add process and dependency isolation on top when you need it. See Git worktrees for AI coding agents for the workflow.
What Paradev adds for a shared host:
- Access per host. When a host first comes online, only the person who started it can see it. Add teammates in Settings → Hosts → Add member; owners can promote or remove members.
- One worktree per workspace. Each workspace gets its own branch, directory, terminals, and port list.
- Know whose work is whose. The Workspaces page filters by who created each workspace, and tags stay with the user who applied them.
- Ports. Paradev detects the ports each workspace listens on but does not assign port ranges. If several agents run dev servers, reserve ports in a setup script.
Paradev's docs recommend a dedicated machine for this, provisioned with only the repos and credentials you mean to share, not your personal workstation. Anything the host service can reach becomes reachable by clients you grant access to.
Laptops, a shared host, or cloud workspaces: what are the tradeoffs for a small team?
Laptops are the cheapest start, a shared host gives the most compute per dollar and keeps agents running, and cloud workspaces give the cleanest isolation at a variable cost.
| Personal laptops | Shared host | Cloud workspaces | |
|---|---|---|---|
| Setup | None | One machine to maintain | Environment config per repo |
| Cost | Hardware you own | Fixed | Usage-based |
| Runs after lid close | No | Yes | Yes |
| Isolation | Per laptop | Worktrees on one OS; add containers for more | Separate environment per task |
| Credentials | Spread across laptops | On one box you control | With the provider |
| Main risk | Agents slow the machine you work on | Resource contention, single point of failure | Idle bills, provider limits |
A common path for a small team: start on laptops, then move long-running agent work to one shared host once people want agents to run overnight or need more cores. Paradev covers all three columns with the same app. A laptop and a shared host are both just devices in the list, and Paradev cloud workspaces run in the cloud and work from desktop, iPhone, and iPad without keeping your own computer connected.
How do I review and preview an agent's changes on a remote machine from my laptop?
Review the diff where the code lives, and forward the dev server's port to your laptop so localhost works.
- VS Code Remote-SSH shows the remote diff in Source Control and forwards ports over the SSH tunnel.
- Plain SSH:
ssh -N -L 3000:localhost:3000 user@remote-host, then openhttp://localhost:3000. - Tailscale:
tailscale serve 3000on the host, then open the URL it prints. This keeps the port inside your tailnet. - Codespaces forwards ports from its cloud environment the same way.
In Paradev, open the remote workspace and its Changes pane shows the agent's diff from the host. When you select a remote workspace, the app forwards each port that workspace started to the same port on your machine, so localhost:3000 reaches the dev server on the host. Open it in the in-app browser pane next to the diff, or in your own browser. If the port is busy locally, choose Use another port. Limits: the host needs host-service 1.26 or newer, only TCP is forwarded, and other services on the host stay unreachable. Details: Ports on a remote host.
Do not make a dev server public just to preview it. A forwarded port carries your cookies and auth headers, so treat it like the remote service it is.
Which option should you pick?
- One remote box, one agent, editor-first: VS Code or Cursor with Remote-SSH.
- Zero infrastructure, one vendor's agent: Codex cloud or Cursor Cloud Agents.
- Continue a Claude Code session from your phone: Claude Code Remote Control, on a machine that stays awake. It also works for a Claude Code session running in a Paradev workspace.
- Lowest cost, maximum control: an always-on Linux box with Tailscale and tmux.
- Several CLI agents in parallel across your laptop and an always-on or shared host, with diffs and ports in one place: Paradev. Desktop runs on macOS (Linux AppImage is experimental); the host service runs on macOS and Linux.
For more on running many agents at once, see running multiple Claude Code agents in parallel.
Frequently Asked Questions
Can I run Claude Code on a remote server and control it from my Mac?
Yes. Install Claude Code on the server and connect with SSH and tmux, VS Code Remote-SSH, or Paradev. With Paradev, run superset start --daemon on the server and open its workspaces from the Mac app under the Device filter.
Can I use Claude Code Remote Control on a Paradev host?
Yes. Start Claude Code in a workspace on the host and type /remote-control. The session appears in the Claude app and at claude.ai/code, and it also stays visible in Paradev's desktop and iPhone apps. You need a claude.ai login on a Pro, Max, Team, or Enterprise plan, and the workspace's terminal must stay open in at least one pane.
Do I need to keep my laptop open for agents to keep working?
Only if the agent runs on the laptop. Run it on an always-on host, a Paradev cloud workspace, or a managed cloud agent instead. Claude Code Remote Control still runs on your own machine, so that machine must stay awake.
Does Paradev need SSH or a VPN to reach a remote host?
No. Paradev routes terminals, diffs, and forwarded ports through the Paradev relay. You can still forward ports with SSH or Tailscale for hosts you reach another way.
Are Paradev cloud workspaces available?
Yes. Cloud workspaces run in the cloud and work from desktop, iPhone, and iPad without keeping your own computer connected. Remote Access to your own machines is a separate option on Pro.
Do Git worktrees isolate agents on a shared machine?
They isolate files and branches, not processes. Agents on one host share CPU, memory, ports, and the host user's permissions. Use containers or separate hosts when you need more.