Codex Remote icon

Codex Remote

Codex Remote provisions cloud machines, installs Codex and Claude Code, configures SSH, projects, services, and MCP servers, and manages them in a desktop app.

Codex Remote

Remote machines for Codex and Claude Code

Codex Remote is a desktop tool for putting Codex and Claude Code on remote cloud machines. It accepts a token from a cloud account you already use, provisions a server, installs the agents, configures access, and presents the resulting machine to the tools’ existing workflows.

The product packages the repetitive parts of remote-agent setup: SSH registration, non-interactive agent sign-in, boot-time services, project transfer, and MCP configuration. Machines from different providers can be managed from one list, while an MCP interface allows an AI agent to inspect or operate the environment when the relevant permissions are enabled.

Core features

Cloud machine provisioning

Provide a token for a supported cloud, choose a region, size, image, and agents, and let Codex Remote create one server through a per-cloud OpenTofu module.

Agent-ready server setup

The bootstrap process installs base packages, the Codex CLI at `/usr/local/bin/codex`, Claude Code under its own account, configured MCP servers, and a systemd unit for each agent.

SSH and agent registration

Each machine gets a named `Host codex-remote-<name>` entry in SSH config. Codex uses that host to start `codex app-server` over SSH, while Claude Code connects through its own account and login.

Machine status overview

The app tracks machines from different clouds in one list and shows whether each is paused, idle, or running agent sessions, helping indicate whether stopping a machine could interrupt work.

Project and MCP transfer

Projects are cloned or copied to the remote machine with untracked configuration sent separately, and portable MCP servers are carried over as part of the transfer.

Agent control and provider registry

An MCP server lets an external agent inspect machines and, when separately permitted, run commands, sync projects, create machines, or destroy them. Provider definitions can also be supplied through a custom registry.

Practical use cases

  • Starting a dedicated coding machine

    Create a remote server with a selected cloud, region, image, and size, then have Codex and Claude Code installed and available without repeating the setup wizard by hand.

  • Managing multiple remote environments

    Keep several machines across cloud providers in one list, with pause, idle, and active-agent status visible before stopping or resuming a server.

  • Moving a project to a remote host

    Send a local project to a new machine while retaining the untracked configuration and portable MCP servers needed for the project’s tools.

  • Delegating infrastructure work to an agent

    Connect an AI assistant through the Codex Remote MCP server so it can inspect machine health and, after permissions are enabled, provision, configure, sync, or remove infrastructure.

  • Using a custom provider catalogue

    Point the app at a private provider registry to use a homelab module, an internal cloud definition, or a team-specific machine configuration without waiting for a desktop release.

Pros and Cons

Pros

  • Automates server creation, agent installation, login setup, SSH registration, and boot-time service configuration.
  • Supports project transfer with separate untracked configuration handling and carries portable MCP servers to the remote machine.
  • Puts machines from multiple cloud providers into one status list and exposes estimated cost during machine creation.
  • Uses separate permissions for reading, changing resources, and destroying machines when an AI agent manages infrastructure.
  • Allows provider catalogues to be extended through a runtime JSON registry and custom OpenTofu modules.

Cons

  • The available evidence does not establish pricing, plan limits, or a free tier.
  • Creating and operating machines still uses the user’s cloud account and may incur provider charges.
  • Destructive machine actions are supported but require explicit permission; destroying a machine cannot be undone.

FAQ

How do I install Codex Remote?

Install the desktop app with Homebrew using `brew install --cask pandelisz/tap/codex-remote`, or download the latest release, unzip it, and move it to Applications. The app updates itself after installation.

What happens when I create a machine?

Choose a supported cloud, enter its provider token, select a region, machine size, image, and agents, then create the machine. Codex Remote applies a per-cloud OpenTofu module, bootstraps the server over SSH, registers the host, and adds the required agent services.

Which cloud providers does it support?

The homepage lists Hetzner, AWS, DigitalOcean, Linode, Vultr, and Scaleway as cloud token options. The supplied provider registry contains a detailed Hetzner Cloud entry; provider availability and configuration can be refreshed through the registry.

Can it transfer my project and MCP servers?

Codex Remote carries over MCP servers and transfers a project together with its untracked configuration separately from the clone, so gitignored `.env` files are not silently omitted from the setup workflow.

Can an AI agent manage the machines?

Yes. An MCP server exposes tools for listing machines and sizes, running commands, syncing projects, and creating or destroying machines. Reading is available by default, while changing resources and destroying machines require separate permission switches.

Quick Facts

Product type
Remote development and AI agent machine management tool
Primary agents
OpenAI Codex and Claude Code
Cloud options listed
Hetzner, AWS, DigitalOcean, Linode, Vultr, and Scaleway
Infrastructure workflow
Per-cloud OpenTofu modules bootstrapped over SSH
Desktop installation
Homebrew cask or downloadable application
Pricing
Not established; the supplied pricing URL returns a 404