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.devroutes to the region of your request and defaults to the United States. To talk to one region directly, useapi.us.sandscale.devorapi.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.