Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

📦Installing Sandbox Studio

A Windows guide for installing the Sandbox Studio desktop app, signing in with Sandbox, and completing first-launch onboarding. Confirm your machine meets the Creating requirements first. After Studio is running, install the AI coding assistant you chose and open the project folder so you can connect Sandbox Studio MCP. Download and Install Cursor is the worked example.

1

Download the installer

Download the installer from sandbox.game. Sign in with a Sandbox account — the download is available after you log in. Do not use a copy from an unverified website or file-sharing source.

The installer is a large file and may take a few minutes to download. Confirm the file identifies the product as Sandbox Studio.

2

Run the installer

Double-click the installer. Approve the Windows permission prompt only after checking the file name and source. The installer uses a one-click flow and displays Installing, please wait while the application is copied to the computer.

The one-click installer copies Sandbox Studio Dev to the computer.

INSTALL LOCATION: The verified build installs to C:\Program Files\Sandbox-Studio. The main application is Sandbox-Studio.exe.

3

Wait for Sandbox Studio to open

Keep the installer open until its progress completes. Sandbox Studio normally opens when installation finishes. If another copy is running, close it when the installer asks, then allow setup to continue.

4

Sign in with Sandbox

On first launch, select Continue with Sandbox. Complete the Sandbox authentication flow using a Sandbox account. Return to Sandbox Studio after authentication.

First launch requires authentication through the Sandbox account flow.
5

Choose an AI assistant

During onboarding, choose your preferred AI coding assistant. Cursor is selected in this example. Select Manage to review its configuration options.

Choose an AI assistant during the first onboarding step.
6

Configure the AI provider

After selecting Manage, review the provider details. Select Dashboard to open the provider’s site and create an API key.

The AI assistant configuration view.
7

Add the API key

Generate an API key and keep it confidential. Copy it into the API key field in Sandbox Studio.

Create an API key before adding it to Sandbox Studio.
8

Configure the MCP server

MCP server setup is optional. Select the AI provider you use, then select Configure to initialize it.

Configure the MCP server for the selected AI provider.
9

Check the environment

Check whether Sandbox Studio needs any required components. Update Node.js or pnpm when they are not current.

The environment check identifies missing or outdated components.

Set up in-editor AI assistants (without Cursor)

Cursor is optional. The editor has its own Assistant chat. You add providers and pick models here, then chat from the agent panel on the left.

Open the menu → App Settings → AI Settings. There are three tabs: Assistant, Models, and MCP. MCP connects an external agent such as Cursor — see Set up and use Sandbox Studio MCP. Use Assistant and Models for the in-editor chat.

Assistant tab — add a provider

  1. Turn Enable AI Assistant on. Status should read Ready. If you turn this off, the in-editor chat stops. Sandbox Studio MCP on the MCP tab can still run.

  2. Select Add Provider. Search if you need to. Open Not Set Up to see the catalogue (API Key or OAuth, depending on the provider). Configured lists providers you have already added.

  3. Choose a provider, complete API key or OAuth, and enable it.

Connect and enable at least one provider to use the Assistant. If several are enabled, the one at the top of the list is preferred when Studio resets or chooses the default model.

AI Settings, Assistant tab, with Add Provider open

Models tab — what appears in chat, and the default

  1. Open the Models tab.

  2. Use Open on the model list to pin or unpin models from the catalogue. Pinned models appear in the Assistant chat selector.

  3. Use Last Selected Model — when this is on, a new chat starts with the model you used most recently instead of the default below.

  4. Default Agent Model — the model new chats use when no model is chosen. Pick it from the dropdown. Reset returns that field to Studio's default.

  5. Assist Actions Model — used for Fix with AI and other Assist Actions. Leave Use Default Agent Model checked to keep them in sync, or clear it and pick a different model.

AI Settings, Models tab, default agent model and chat selector

NOTE: Provider names and the model list change as vendors update. Pick what you have access to. Do not treat one dropdown value as the only supported model.

Update Sandbox Studio

When an update is ready, Studio displays Restart to Update in the top bar. Save project changes, stop any running play session, then select the update control and allow Studio to restart.

Troubleshooting

Issue
Action

Windows warns about the installer

The supplied file is not digitally signed. Stop and confirm that it came from sandbox.game.

Sandbox Studio is already running

Close Sandbox Studio, then select OK in the installer message. If the application does not close, exit it manually and restart the installer.

Environment Setup reports a problem

Use Re-check after changing Node.js or pnpm. Review the expanded Install Output, follow any administrator instructions, and use Try Again to repeat the last installation action.

Sign-in does not return to Studio

Complete authentication in the browser and reopen Studio if the application remains on the sign-in page.

What you’ve done

The Sandbox Studio desktop app is installed, you are signed in, and first-launch onboarding is complete. You can add more in-editor providers later under App Settings → AI Settings. Next, create a project. To use an external agent as well, open the project in that assistant. For Cursor, download and install Cursor and set up Sandbox Studio MCP.

Last updated

Was this helpful?