Get started

Quickstart

From nothing to a command running in a sandbox, and your coding agent connected to it. It takes a few minutes.

Create an account

Sign up at cloud.sandscale.dev. You start on the Free plan: 100 vCPU-hours a month, 2 sandboxes at once, up to 2 vCPU per box, with the network off. Free needs a verified email address. Pro and up need a payment method, which turns on network access with an allowlist and larger sizes. See Plans and limits.

Install the CLI

The sandscale CLI runs on macOS, Linux and Windows.

# macOS and Linux
curl -fsSL https://sandscale.dev/install | sh

# npm, on any platform including Windows
npm install -g @sandscale/cli

A Homebrew package is published with the release.

Then sign in. The CLI opens your browser; use --device to sign in with a code on another device.

sandscale login
sandscale whoami

Your sign-in is kept in your system’s credential store, never in a file.

Start a sandbox

See the templates and sizes you can use, then start a sandbox. It comes back with its id.

sandscale sandbox start --options
sandscale sandbox start --template TEMPLATE --ttl 1h
sandscale sandbox list

The sandbox has its own kernel and no network. On Pro and up, --network asks for network access, within your organization’s allowlist.

Run a command

Run a command in the sandbox and read its output and exit code:

sandscale sandbox exec SANDBOX_ID -- python3 -c "print('hello from a sandbox')"

Copy files in and out with sandscale sandbox files put and sandscale sandbox files get, or start a sandbox, sync a folder, run one command and throw the sandbox away in one step:

sandscale sandbox run --template TEMPLATE --sync . -- npm test

When you are done, stop it:

sandscale sandbox stop SANDBOX_ID

Connect your coding agent

sandscale mcp is an MCP server that runs on your machine, with your own sign-in. It gives your agent tools for your workspaces, sandboxes and build hosts. See MCP tools for the full list. Vault values are never offered to a model.

Claude Code

claude mcp add sandscale -- sandscale mcp

Codex, in ~/.codex/config.toml:

[mcp_servers.sandscale]
command = "sandscale"
args = ["mcp"]

Cursor, in ~/.cursor/mcp.json:

{ "mcpServers": { "sandscale": { "command": "sandscale", "args": ["mcp"] } } }

Any other MCP tool works the same way: a stdio server with the command sandscale and the argument mcp.

Pick a region

Sandscale runs in the United States and Europe. One account works in both: you pick the region for each sandbox or workspace, and its data stays there. See Regions.

  • In the console, use the region switcher at cloud.sandscale.dev.
  • With the API, api.sandscale.dev routes to the region of your request and defaults to the United States. To talk to one region directly, use api.us.sandscale.dev or api.eu.sandscale.dev.

Next steps

  • Workspaces: a cloud computer that keeps your agent working when your laptop is closed.
  • Vault: give a run secrets without putting them in prompts.
  • CLI reference: every command and option.